Tích hợp SDK iOS cho những nhà phát triển

ID thiết bị riêng của AppsFlyer được tạo cho mỗi lần cài đặt mới của ứng dụng. Bạn có thể nhận bằng cách sử dụng mã sau đây:

let appsflyerId = AppsFlyerTracker.shared().getAppsFlyerUID()

NSString *appsflyerId = [AppsFlyerTracker sharedTracker].getAppsFlyerUID;

Việc thiết lập customer ID riêng cho phép bạn tham chiếu ID riêng của bạn với ID riêng của AppsFlyer và ID khác của thiết bị. ID hiển thị trong các báo cáo dữ liệu thô của AppsFlyer và postback API để tham chiếu chéo với ID nội bộ của bạn.

Để thiết lập ID người dùng Customer User ID:

AppsFlyerTracker.shared().customerUserID = "my user id"

[AppsFlyerTracker sharedTracker].customerUserID = @"my user id";

Nhận Customer User ID:

Để nhận customer User ID, hãy lấy từ sharedTracker.

[AppsFlyerTracker sharedTracker].customerUserID

Để biết thêm thông tin về Customer User ID, nhấp vào đây.

AppsFlyer tự động thu thập IDFA (ID cho Nhà quảng cáo) và IDFV (ID cho Nhà cung cấp) nếu có AdSupport.framework trong ứng dụng.

Để Gỡ cài đặt theo dõi, hãy bật thông báo đẩy từ xa trên ứng dụng của bạn. Xem Hướng dẫn Lập trình Thông báo Từ xa của Apple để biết thêm chi tiết.

Làm theo hướng dẫn tích hợp iOS SDK  để hoàn tất thiết lập tính năng gỡ cài đặt.

Để cho phép Tracking App Launches từ thông báo đẩy, thêm mã sau đây vào app delegate của bạn:

func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any]) {
	AppsFlyerTracker.shared().handlePushNotification(userInfo)
}

-(void) application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo {
	[[AppsFlyerTracker sharedTracker] handlePushNotification:userInfo];
  }

Thông báo đẩy cần có một tham số af với tham số phân bổ AppsFlyer.

Ví dụ tin nhắn:

{
  "aps":{
   "alert":"Push text",
   "sound":"default",
   "category":"REMINDER_CATEGORY"
  },
  "_p":123456,
  "payloadKey":"payloadValue",
  "af":{
   "pid":"swrve_int",
   "is_retargeting":"true",
   "c":"test_campaign"
  }
}

AppsFlyer cho phép bạn phân bổ và ghi nhận các cài đặt có nguồn gốc từ quảng cáo chéo của một trong những ứng dụng của bạn từ bên trong ứng dụng hiện tại mà người dùng có. Ứng dụng quảng cáo chéo có thể là một yếu tố tăng trưởng chính trong việc thúc đẩy các lượt cài đặt thêm cho ứng dụng của bạn.

Để biết thêm thông tin chi tiết, vui lòng xem bài viết Phân bổ Quảng cáo chéo, tại đây.

SDK AppsFlyer có thể cung cấp xác minh máy chủ mua hàng trong ứng dụng. Để thiết lập theo dõi xác thực hóa đơn, bạn cần gọi phương thức validateAndTrackInAppPurchase  bên trong SKStoreKit’s completeTransaction: callback. Phần gọi này tự động tạo ra sự kiện trong ứng dụng af_purchase.

- (void) validateAndTrackInAppPurchase:(NSString *) productIdentifier
price:(NSString *) price
currency:(NSString *) currency
transactionId:(NSString *) tranactionId
additionalParameters:(NSDictionary *) params
success:(void (^)(NSDictionary *response)) successBlock
failure:(void (^)(NSError *error, id reponse)) failedBlock;

Phần gọi này có hai khối gọi lại, một cho 'thành công' và một cho 'thất bại' (vì lý do bất kỳ, bao gồm cả xác minh thất bại). Khi thành công, một từ điển được trả về với dữ liệu xác nhận biên nhận được cung cấp bởi các máy chủ của Apple.  

#ifdef DEBUG
  [AppsFlyerTracker sharedTracker].useReceiptValidationSandbox = YES;
#endif

[[AppsFlyerTracker sharedTracker] validateAndTrackInAppPurchase:@"ProductIdentifier" price:@"price"
    currency:@"USD"
    transactionId:@"transactionID"
    additionalParameters:@{@"test": @"val" , @"test1" : @"val 1"}
    success:^(NSDictionary *result){
      NSLog(@"Purchase succeeded And verified!!! response: %@", result[@"receipt"]);
    } failure:^(NSError *error, id response) {
      NSLog(@"response = %@", response);
      if([response isKindOfClass:[NSDictionary class]]) {
        if([response[@"status"] isEqualToString:@"in_app_arr_empty"]){
          // retry with 'SKReceiptRefreshRequest' because
          // Apple has returned an empty response
          // <YOUR CODE HERE>
        }

      } else {
        //handle other errors
        return;
      }
  }];

AppsFlyerTracker
      .shared()?
      .validateAndTrack(inAppPurchase: "productIdentifier",
                   price: "price",
                  currency: "currency",
               transactionId: "transactionId",
            additionalParameters: [:],
                  success: {
      guard let dictionary = $0 as? [String:Any] else { return }
      dump(dictionary)
    }, failure: { error, result in
      guard let emptyInApp = result as? [String:Any],
           let status = emptyInApp["status"] as? String,
             status == "in_app_arr_empty" else {
                // Try to handle other errors
                 return
               }
         
      // retry with 'SKReceiptRefreshRequest' because
      // Apple has returned an empty response
      // <YOUR CODE HERE>
    })

Để biết danh sách các giá trị trả về có thể để xác nhận hóa đơn, vui lòng tham khảo tài liệu của Apple tại đây.

AppsFlyer cung cấp cho bạn phương thức ẩn danh mã định danh người dùng trong phân tích AppsFlyer. Phương thức này phù hợp với yêu cầu bảo mật mới nhất và tuân thủ chính sách dữ liệu và quyền riêng tư của Facebook. Mặc định là KHÔNG, có nghĩa là mặc định không thực hiện ẩn danh.

Sử dụng API này trong quá trình Khởi tạo SDK để ẩn danh hoàn toàn các cài đặt, sự kiện và phiên của người dùng:

AppsFlyerTracker.shared().deviceTrackingDisabled = true

[AppsFlyerTracker sharedTracker].deviceTrackingDisabled = YES;

Có thể khởi động lại việc theo dõi bằng cách gọi deviceTrackingDisabled được đặt là false.

Theo mặc định, phải mất ít nhất 5 giây giữa 2 lần khởi chạy ứng dụng để được tính là 2 phiên riêng biệt (tìm hiểu thêm về tính các phiên).

Tuy nhiên, bạn có thể sử dụng API sau để đặt giá trị tùy chỉnh cho thời gian yêu cầu tối thiểu giữa các phiên:

AppsFlyerTracker.shared().minTimeBetweenSessions = <your_custom_time_in_seconds>

[AppsFlyerTracker sharedTracker].minTimeBetweenSessions = <your_custom_time_in_seconds>;

Phần mở rộng ứng dụng yêu cầu cho phép sử dụng Internet:

1. Đi tới tệp tin info.plist của phần mở rộng ứng dụng của bạn
2. Trong NSExtension / NSExtensionAttributes đặt cờ RequestsOpenAccess thành YES.

Thêm mã sau đây vào UIViewController viewDidLoad của phần mở rộng ứng dụng:

override func viewDidLoad() {  
    super.viewDidLoad()
    AppsFlyerTracker.shared().appsFlyerDevKey = "MY_APPSFLYER_KEY"

    // MY_APP_ID below stands for you app ID on iTunes Connect. Should be 9 or 10 digits.
    AppsFlyerTracker.shared().appleAppID = "MY_APP_ID"
        
    AppsFlyerTracker.sharedTracker().trackAppLaunch()
  }

- (void)viewDidLoad {
    [super viewDidLoad];
    // Replace MY_APPSFLYER_KEY below by your AppsFlyer dev key
    [AppsFlyerTracker sharedTracker].appsFlyerDevKey = @"MY_APPSFLYER_KEY";

    // MY_APP_ID below stands for you app ID on iTunes Connect. Should be 9 or 10 digits.
    [AppsFlyerTracker sharedTracker].appleAppID = @"MY_APP_ID";
        
    [[AppsFlyerTracker sharedTracker] trackAppLaunch];
  }

AppsFlyer cho phép bạn theo dõi và phân bổ lượt cài đặt có nguồn gốc từ lời mời của người dùng trong ứng dụng của bạn. Có thể thực hiện việc này bằng isStopTracking API. Khi API được thu hồi, SDK sẽ không còn giao tiếp được với các máy chủ của chúng tôi và dừng hoạt động.

Có một số trường hợp khác nhau để người dùng lựa chọn không tham gia. Chúng tôi khuyên bạn nên thực hiện theo những hướng dẫn chính xác cho từng trường hợp liên quan tới ứng dụng của bạn.

AppsFlyerTracker.shared().isStopTracking = true

[AppsFlyerTracker sharedTracker].isStopTracking = true;

Có thể trì hoãn Khởi tạo SDK cho đến khi customerUserID được thiết lập. Tính năng này bảo đảm rằng SDK không bắt đầu hoạt động cho đến khi customerUserID được cung cấp. Khi bạn trì hoãn khởi tạo SDK, tất cả các sự kiện trong ứng dụng và mọi cuộc gọi API SDK khác sẽ bị loại bỏ, cho đến khi customerUserID được cung cấp và ghi nhận.

Bạn có thể thêm logic vào API iOS applicationDidBecomeActive để trì hoãn khởi tạo SDK cho đến khi customer user ID được thiết lập. Xem những ví dụ dưới đây:

- (void)applicationDidBecomeActive:(UIApplication *)application {
    NSString *customUserId = [[NSUserDefaults standardUserDefaults] stringForKey:@"customerUserId"]; // Your custom logic of retrieving CUID
    if (customUserId != nil && ![customUserId  isEqual: @""]) {
        [AppsFlyerTracker sharedTracker].customerUserID = customUserId; // Set CUID in AppsFlyer SDK for this session
        [[AppsFlyerTracker sharedTracker] trackAppLaunch]; // Track App Launch
    }
}

func applicationDidBecomeActive(_ application: UIApplication) {
        let customUserId = UserDefaults.standard.string(forKey: "customUserId")  //  your logic to retrieve CUID
        if(customUserId != nil && customUserId != ""){
            AppsFlyerTracker.shared().customerUserID = customUserId // Set CUID in AppsFlyer SDK for this session
            AppsFlyerTracker.shared().trackAppLaunch() // Track App Launch
        }
    }

AppsFlyer SDK cho phép bạn thu thập Tên Thiết bị để phân tích nội bộ của bạn. Theo mặc định, tính năng này bị tắt. Để bật tính năng này, hãy sử dụng API sau:

AppsFlyerTracker.shared().shouldCollectDeviceName = false

[AppsFlyerTracker sharedTracker].shouldCollectDeviceName = NO;

Phải có API setAdditionalData để tích hợp ở cấp SDK với một số nền tảng đối tác bên ngoài, bao gồm Segment, Adobe và Urban Airship. Chỉ sử dụng API nếu bài viết tích hợp của nền tảng nêu rõ rằng bắt buộc phải có setAdditionalData API.
Sau đây là ví dụ đoạn mã thực hiện setAdditionalData trên iOS dành cho Objective-C hoặc Swift:

NSDictionary* CustomDataMap = [[NSDictionary alloc] initWithObjectsAndKeys:@"value_of_param_1", @"custom_param_1", nil];
  
[[AppsFlyerTracker sharedTracker] setAdditionalData:CustomDataMap];

let CustomDataMap: [AnyHashable: Any] = [
  "custom_param_1" : "value_of_param_1"
]
    
AppsFlyerTracker.shared().customData = CustomDataMap

Nếu bạn đang sử dụng OneLinks hỗ trợ Liên kết Phổ dụng Android và gói chúng bằng Liên kết Phổ dụng Bên thứ 3, bạn có thể sử dụng API setResolveDeepLinkURLs để thông báo cho AppsFlyer SDK nhấp vào các tên miền gọi ứng dụng phải được SDK giải quyết và trích xuất OneLink bên dưới từ chúng. Thao tác này sẽ cho phép bạn duy trì liên kết sâu và theo dõi trong khi gói OneLink bằng Liên kết Phổ dụng Bên thứ 3. Đảm bảo gọi API này trước khi khởi tạo SDK.

[AppsFlyerTracker sharedTracker].resolveDeepLinkURLs = @[@"example.com",@"click.example.com"];

AppsFlyerTracker.shared().resolveDeepLinkURLs = ["example.com", "click.example.com]