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

SDK của AppsFlyer sử dụng các khung gốc dưới đây:

AdSupport.framework

Khung này là bắt buộc để thu thập IDFA từ các thiết bị.
Nếu không có IDFA, bạn không thể theo dõi quảng cáo Facebook, Twitter, quảng cáo của Google và các mạng khác.

iAd.framework

Khung này là cần thiết để ghi nhận và đo lường hiệu suất các quảng cáo Tìm kiếm Apple trong ứng dụng của bạn

Lưu ý: Bắt đầu từ SDK phiên bản 4.8.11, SDK sẽ tự động thêm AdSupport.framework. iAd.framework được thêm tự động từ SDK phiên bản từ 4.10.0 trở lên.
Nếu bạn đang sử dụng các phiên bản SDK cũ hơn, hãy xem hướng dẫn sau.

Nếu bạn muốn xóa các khung này và tắt chức năng thu thập IDFA:

1. Để tắt chức năng thu thập IDFA, hãy xem hướng dẫn tại đây.
2. Để tắt  iAd.framework, hãy xem hướng dẫn tại đây.

Để thêm khung hỗ trợ quảng cáo:

1. Trong dự án Xcode của bạn, hãy chọn mục tiêu của dự án.
2. Chọn tab Tổng quan cho mục tiêu của bạn.
3. Mở rộng phần Khung và Thư viện được liên kết.
4. Nhấp vào + để thêm khung.
5. Tìm kiếm AdSupport.framework
6. Chọn AdSupport.framework từ danh sách.

Lặp lại quy trình cho iAd.framework.

AppsFlyer sử dụng khóa dev để xác định duy nhất tài khoản của bạn. Khóa dev là bắt buộc vì khóa cho phép SDK gửi và truy xuất dữ liệu một cách an toàn thuộc tài khoản AppsFlyer của bạn.

Thực hiện:

1. Đi tới bảng điều khiển ứng dụng của bạn 
2. Trong bảng điều khiển, dưới phần Cấu hình nhấp Cài đặt Ứng dụng
3. Sao chép khóa dev của bạn
   
   

   

Để hỗ trợ liên kết sâu, hãy thêm mã sau vào SceneDelegate cho mỗi cảnh mà ứng dụng của bạn hỗ trợ liên kết sâu vào.

1. Nhập thư viện

#import <AppsFlyerLib/AppsFlyerTracker.h>

import AppsFlyerLib

2. Thêm thực hiện

#import "SceneDelegate.h"

@interface SceneDelegate ()

@end

@implementation SceneDelegate 

- (void)scene:(UIScene *)scene openURLContexts:(NSSet<UIOpenURLContext *> *)URLContexts API_AVAILABLE(ios(13.0)){
    NSURL* url = [[URLContexts allObjects] objectAtIndex:0].URL;
    if(url){
        [[AppsFlyerTracker sharedTracker] handleOpenUrl:url options:nil];
    }
}

- (void)scene:(UIScene *)scene continueUserActivity:(NSUserActivity *)userActivity  API_AVAILABLE(ios(13.0)){
    [[AppsFlyerTracker sharedTracker]continueUserActivity:userActivity restorationHandler:nil];
}

- (void)scene:(UIScene *)scene willConnectToSession:(UISceneSession *)session options:(UISceneConnectionOptions *)connectionOptions  API_AVAILABLE(ios(13.0)){
    // Use this method to optionally configure and attach the UIWindow `window` to the provided UIWindowScene `scene`.
    // If using a storyboard, the `window` property will automatically be initialized and attached to the scene.
    // This delegate does not imply the connecting scene or session are new (see `application:configurationForConnectingSceneSession` instead).
}


- (void)sceneDidDisconnect:(UIScene *)scene  API_AVAILABLE(ios(13.0)){
    // Called as the scene is being released by the system.
    // This occurs shortly after the scene enters the background, or when its session is discarded.
    // Release any resources associated with this scene that can be re-created the next time the scene connects.
    // The scene may re-connect later, as its session was not neccessarily discarded (see `application:didDiscardSceneSessions` instead).
}


- (void)sceneDidBecomeActive:(UIScene *)scene  API_AVAILABLE(ios(13.0)){
    // Called when the scene has moved from an inactive state to an active state.
    // Use this method to restart any tasks that were paused (or not yet started) when the scene was inactive.
}


- (void)sceneWillResignActive:(UIScene *)scene  API_AVAILABLE(ios(13.0)){
    // Called when the scene will move from an active state to an inactive state.
    // This may occur due to temporary interruptions (ex. an incoming phone call).
}


- (void)sceneWillEnterForeground:(UIScene *)scene  API_AVAILABLE(ios(13.0)){
    // Called as the scene transitions from the background to the foreground.
    // Use this method to undo the changes made on entering the background.
}


- (void)sceneDidEnterBackground:(UIScene *)scene  API_AVAILABLE(ios(13.0)){
    // Called as the scene transitions from the foreground to the background.
    // Use this method to save data, release shared resources, and store enough scene-specific state information
    // to restore the scene back to its current state.
}


@end

import UIKit
import AppsFlyerLib

@available(iOS 13.0, *)
class SceneDelegate: UIResponder, UIWindowSceneDelegate {

    var window: UIWindow?
    
    func scene(_ scene: UIScene, continue userActivity: NSUserActivity) {
        AppsFlyerTracker.shared().continue(userActivity, restorationHandler: nil)
    }
    
    func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>) {
        if let url = URLContexts.first?.url {
            AppsFlyerTracker.shared().handleOpen(url, options: nil) 
        }
    }


    func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options connectionOptions: UIScene.ConnectionOptions) {
        // Use this method to optionally configure and attach the UIWindow `window` to the provided UIWindowScene `scene`.
        // If using a storyboard, the `window` property will automatically be initialized and attached to the scene.
        // This delegate does not imply the connecting scene or session are new (see `application:configurationForConnectingSceneSession` instead).
        guard let _ = (scene as? UIWindowScene) else { return }
    }

    func sceneDidDisconnect(_ scene: UIScene) {
        // Called as the scene is being released by the system.
        // This occurs shortly after the scene enters the background, or when its session is discarded.
        // Release any resources associated with this scene that can be re-created the next time the scene connects.
        // The scene may re-connect later, as its session was not neccessarily discarded (see `application:didDiscardSceneSessions` instead).
    }

    func sceneDidBecomeActive(_ scene: UIScene) {
        // Called when the scene has moved from an inactive state to an active state.
        // Use this method to restart any tasks that were paused (or not yet started) when the scene was inactive.
        
    }

    func sceneWillResignActive(_ scene: UIScene) {
        // Called when the scene will move from an active state to an inactive state.
        // This may occur due to temporary interruptions (ex. an incoming phone call).
    }

    func sceneWillEnterForeground(_ scene: UIScene) {
        // Called as the scene transitions from the background to the foreground.
        // Use this method to undo the changes made on entering the background.
    }

    func sceneDidEnterBackground(_ scene: UIScene) {
        // Called as the scene transitions from the foreground to the background.
        // Use this method to save data, release shared resources, and store enough scene-specific state information
        // to restore the scene back to its current state.
    }
}

Trước khi bạn bắt đầu kiểm tra lượt cài đặt, liệt kê vào danh sách trắng thiết bị bạn đang chuẩn bị kiểm tra.

Các lượt cài đặt tự nhiên là cài đặt không phân bổ, thường cài đặt trực tiếp từ các cửa hàng ứng dụng.

Để mô phỏng cài đặt tự nhiên:

1. Đảm bảo bạn có thiết bị di động được kết nối với máy tính của mình
2. Trong Xcode, hãy mở thiết bị đầu cuối gỡ lỗi.
3. Từ Xcode Studio, hãy cài đặt ứng dụng trên thiết bị hoặc trình giả lập.
4. Đợi ứng dụng khởi chạy.
5. Trong thiết bị đầu cuối gỡ lỗi, hãy tìm tên gói ứng dụng của bạn.

Bạn nên xem những nội dung sau:

Gửi Track-App-Launch trong nhật ký cho biết SDK báo cáo cài đặt. Dữ liệu này có từ phương thức onConversionDataSuccess trong ủy nhiệm hàm ứng dụng. Nhận dữ liệu chuyển đổi sẽ được thảo luận sau trong hướng dẫn này .

Lưu ý: Bắt đầu SDK V5, onConversionDataSuccess là tên của phương thức để nhận dữ liệu chuyển đổi. Nếu bạn đang sử dụng phiên bản SDK thấp hơn 5.0.0, tên của phương thức là onConversionDataReceived. Chúng tôi khuyên bạn nên nâng cấp lên SDK 5.0.0. Để tìm hiểu thêm, bấm ở đây .

Cài đặt tự nhiên sẽ xuất hiện trên trang Tổng quan của bảng điều khiển của ứng dụng ngây bây giờ .

Nếu bạn không thấy cài đặt trong bảng điều khiển của ứng dụng, hãy xem hướng dẫn khắc phục sự cố SDK của chúng tôi.

Cài đặt không tự nhiên là lượt cài đặt được phân bổ thường theo sau quảng cáo. Bạn có thể mô phỏng cài đặt không tự nhiên bằng cách sử dụng các liên kết phân bổ.

Thực hiện:

1. Tìm tên ID itunes ứng dụng của bạn là gì, ví dụ: id123456789.
2. Trong URL bên dưới, hãy thay thế <APP_ID> bằng ID itunes ứng dụng của bạn:
   

   https://app.appsflyer.com/<APP_ID>?pid=sdk_test&c=sdk_test
   

   Tham số pid đại diện cho tên nguồn truyền thông. Tham số c đại diện cho tên chiến dịch.
3. Gửi URL này đến thiết bị (ví dụ: qua email hoặc WhatsApp).
4. Trên thiết bị, nhấp vào URL.
   • Nếu ứng dụng được liệt kê trong cửa hàng ứng dụng, bạn sẽ được chuyển hướng đến cửa hàng ứng dụng. Không tải xuống ứng dụng từ cửa hàng ứng dụng. Tiếp tục với bước 5.
   • Nếu ứng dụng không được liệt kê trong cửa hàng ứng dụng và vẫn đang được phát triển, màn hình sẽ hiển thị thông báo rằng ứng dụng không có sẵn trong cửa hàng ứng dụng. Bạn chỉ cần tiếp tục với bước 5.
5. Trong Xcode Studio, hãy mở thiết bị đầu cuối gỡ lỗi.
6. Kết nối thiết bị với máy tính của bạn bằng cáp USB.
7. Từ Xcode, cài đặt ứng dụng trên thiết bị.
8. Trong thiết bị đầu cuối gỡ lỗi, hãy tìm ID itunes của ứng dụng.

Bạn nên xem những nội dung sau:

Cài đặt không tự nhiên sẽ xuất hiện trên trang Tổng quan của bảng điều khiển của ứng dụng ngay bây giờ .

SDK chứa hai loại hằng số đại diện cho thông tin liên quan đến sự kiện trong ứng dụng.

• Tên sự kiện - các hằng số này có định dạng AFEventEventName.
  Ví dụ AFEventPurchase, AFEventAddToCart.
• Tham số sự kiện - Các hằng số này có định dạng AFEventParameterParameterName.
  Ví dụ AFEventParameterRevenue, AFEventParamaterContentId.

Chúng tôi đặc biệt khuyến cáo bạn nên sử dụng các hằng số này vì những lý do sau:

• Việc đặt tên theo tiêu chuẩn cho phép AppsFlyer tự động ánh xạ các sự kiện tới các SRN như Facebook, Google, Twitter và Snapchat.
• Khả năng tương thích ngược - nếu AppsFlyer quyết định thay đổi tên của bất kỳ tham số sự kiện hoặc sự kiện nào, thì việc triển khai của bạn là tương thích ngược.

Để sử dụng hai giao diện này, hãy nhập AppsFlyerTracker.h nếu sử dụng Objective-C hoặc AppsFlyerLib nếu sử dụng Swift:

#import AppsFlyerTracker.h

import AppsFlyerLib

Dưới đây là danh sách các tên và cấu trúc sự kiện được đề xuất .

Bạn có thể gửi doanh thu với bất kỳ sự kiện trong ứng dụng. Sử dụng tham số sự kiện af_revenue (AFEventParameterRevenue) để đưa doanh thu vào sự kiện trong ứng dụng. Bạn có thể điền giá trị số bất kỳ, âm hoặc dương.

af_revenue là tham số sự kiện duy nhất được đếm trên AppsFlyer như doanh thu thực trên dữ liệu thô và bảng điều khiển. Để biết thêm thông tin chi tiết, nhấp vào đây.

Khi gửi sự kiện có doanh thu, hãy ghi nhớ những điều sau:

• Nếu bạn thiết lập mã tiền tệ (xem ví dụ bên dưới), mã đó phải là mã ISO 4217 có 3 ký tự (tiền tệ mặc định là USD).
• Bạn có thể đặt mã tiền tệ cho tất cả các sự kiện bằng cách đặt thuộc tính sau:
  • Objective-C: [AppsFlyerTracker sharedTracker].currencyCode = @"ZZZ";,
  • Swift: AppsFlyerTracker.shared().currencyCode = "ZZZ"
  Để tìm hiểu về cài đặt tiền tệ, hiển thị và chuyển đổi tiền tệ, hãy xem hướng dẫn về tiền tệ doanh thu của chúng tôi.
• Giá trị doanh thu không được chứa dấu tách dấu phẩy, ký hiệu tiền tệ hoặc văn bản. Ví dụ một sự kiện doanh thu nên tương tự như 1234.56.

Ví dụ: Sự kiện mua sự kiện trong ứng dụng có doanh thu

[[AppsFlyerTracker sharedTracker] trackEvent: @"cancel_purchase" 
withValues:@{
	AFEventParamContentId:@"1234567",
	AFEventParamContentType : @"category_a",
	AFEventParamRevenue: @-200,
	AFEventParamCurrency:@"USD"
}];

AppsFlyerTracker.shared().trackEvent("cancel_purchase", 
withValues: [
	AFEventParamContentId:"1234567",
	AFEventParamContentType : "category_a",
	AFEventParamRevenue: -200,
	AFEventParamCurrency:"USD"
]);

Sự kiện mua ở trên có doanh thu $200, hiển thị dưới dạng doanh thu trong bảng điều khiển.

Ghi nhận doanh thu âm

Có thể có những tình huống mà bạn muốn ghi nhận doanh thu âm.

Ví dụ: người dùng nhận được tiền hoàn lại hoặc hủy đăng ký.

[[AppsFlyerTracker sharedTracker] trackEvent: @"cancel_purchase" 
withValues:@{
	AFEventParamContentId:@"1234567",
	AFEventParamContentType : @"category_a",
	AFEventParamRevenue: @-1.99,
	AFEventParamCurrency:@"USD"
}];

AppsFlyerTracker.shared().trackEvent("cancel_purchase", 
withValues: [
	AFEventParamContentId:"1234567",
	AFEventParamContentType : "category_a",
	AFEventParamRevenue: -1.99,
	AFEventParamCurrency:"USD"
]);

SDK của AppsFlyer cung cấp xác minh máy chủ cho các giao dịch mua trong ứng dụng. Để xác nhận việc mua hàng, hãy gọi validateAndTrackInAppPurchase.

Cuộc gọi này sẽ tự động tạo ra một sự kiện trong ứng dụng af_purchase, với điều kiện là giao dịch mua được xác nhận.

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.  

Ví dụ sử dụng để xác nhận mua hàng:

- (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;

[[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>
    })

[AppsFlyerTracker sharedTracker].useReceiptValidationSandbox = YES;

AppsFlyerTracker.shared().useReceiptValidationSandbox = true

Xác thực mua hàng trong ứng dụng sẽ tự động gửi một sự kiện mua trong ứng dụng tới AppsFlyer. Vui lòng xem bên dưới dữ liệu mẫu được truyền trong tham số event_value:

{
   "some_parameter":"some_value", // from additional_event_values
   "af_currency":"USD", // from currency
   "af_content_id":"test_id", // from purchase
   "af_revenue":"10", // from revenue
   "af_quantity":"1", // from purchase
   "af_validated":true // flag that AF verified the purchase
}

• Tên sự kiện: tối đa 45 ký tự
• Giá trị sự kiện: không được vượt quá 1000 ký tự - nếu dài hơn chúng tôi có thể cắt bớt nó
• Định giá và doanh thu: chỉ sử dụng các chữ số và số thập phân, ví dụ 5 hoặc 5.2.
• Giá trị định giá và doanh thu có thể có tối đa 5 chữ số sau dấu chấm, ví dụ: 5.12345
• Có hỗ trợ các ký tự không phải tiếng Anh, trong các sự kiện trong ứng dụng, các SDK API khác, bắt đầu từ Android SDK V4.8.1.

Bạn có thể ghi lại các sự kiện trong ứng dụng bằng cách gọi trackEvent với các tham số giá trị và tên sự kiện. Xem tài liệu về Sự kiện trong ứng dụng để biết thêm chi tiết.

Dưới đây là một ví dụ đơn giản về cách ghi lại một sự kiện mua hàng. Để biết danh sách đầy đủ các đoạn mã được tạo sẵn cho mỗi cấu trúc dọc, vui lòng xem hướng dẫn của chúng tôi về sự kiện phong phú trong ứng dụng cho mỗi cấu trúc dọc.

Ví dụ: Sự kiện mua trong ứng dụng

[[AppsFlyerTracker sharedTracker] trackEvent:AFEventPurchase
   withValues: @{
    AFEventParamRevenue: @200,
    AFEventParamCurrency: @"USD",
    AFEventParamQuantity: @2,
    AFEventParamContentId: @"092",
    AFEventParamReceiptId: @"9277"
  }];

AppsFlyerTracker.shared().trackEvent(AFEventPurchase,
  withValues: [
     AFEventParamRevenue: "200",
     AFEventParamCurrency: "USD",
     AFEventParamQuantity: @2,
     AFEventParamContent: "shoes",
     AFEventParamContentId: @"092",
     AFEventParamReceiptId: @"9277"]);

Nếu người dùng bắt đầu một sự kiện khi không có kết nối internet, Appsflyer vẫn có thể ghi nhận nó. Đây là cách thức hoạt động:

1. SDK gửi các sự kiện tới máy chủ của AppsFlyer và chờ đợi phản hồi.
2. Nếu SDK không nhận được phản hồi mã 200, sự kiện được lưu trữ trong bộ nhớ cache.
3. Khi nhận được phản hồi mã 200 tiếp theo, sự kiện được lưu trữ được gửi lại cho máy chủ.
4. Nếu có nhiều sự kiện trong bộ nhớ cache, chúng được gửi đến máy chủ một cách lần lượt và nhanh chóng.

• Đã ghi nhận thành công sự kiện trong ứng dụng.
• Có lỗi xảy ra khi ghi nhận sự kiện trong ứng dụng.

 [[AppsFlyerTracker sharedTracker] trackEventWithEventName:AFEventPurchase
        eventValues: @{
          AFEventParamRevenue: @200,
          AFEventParamCurrency: @"USD",
          AFEventParamQuantity: @2,
          AFEventParamContentId: @"092",
          AFEventParamReceiptId: @"9277"
        }
        completionHandler:^(NSDictionary<NSString *,id> * _Nullable dictionary, NSError * _Nullable error){
            if(dictionary != nil) {
                NSLog(@"In app callback success:");
                for(id key in dictionary){
                    NSLog(@"Callback response: key=%@ value=%@", key, [dictionary objectForKey:key]);
                }
            }
            if(error != nil) {
                NSLog(@"In app callback error:", error);
            }
    }];
    

AppsFlyerTracker.shared().trackEvent(name: "In app event name", values: ["id": 12345, "name": "John doe"], completionHandler: { (response: [String : Any]?, error: Error?) in
             if let response = response {
               print("In app event callback Success: ", response)
             }
             if let error = error {
               print("In app event callback ERROR:", error)
             }
           })
        }
            

OneLink có thể phát hiện loại thiết bị khi nhấp và chuyển hướng người dùng tới đích phù hợp, ví dụ: Google Play, cửa hàng ứng dụng iOS, thị trường ngoài cửa hàng hoặc các trang web.

Hướng dẫn Chuyển hướng OneLink thảo luận về việc triển khai các liên kết phân bổ đa nền tảng (không yêu cầu mã hóa SDK). Đây cũng là cơ sở cho các liên kết sâu.

Liên kết sâu cho phép bạn gửi người dùng đến các hoạt động cụ thể và phục vụ họ với nội dung tùy chỉnh. Điều này đặc biệt hữu ích khi chạy các chiến dịch nhắm mục tiêu lại.

Để thiết lập liên kết sâu với OneLink, nhà tiếp thị có quyền truy cập vào bảng điều khiển AppsFlyer và nhà phát triển có quyền truy cập vào ứng dụng phải hoạt động cùng nhau.

Xem hướng dẫn của chúng tôi về thiết lập liên kết sâu với OneLink.

Liên kết sâu bị trì hoãn cho phép bạn liên kết sâu người dùng mới và phục vụ họ với nội dung tùy chỉnh sau khi khởi chạyt ứng dụng lần đầu. Liên kết sâu này không giống như liên kết sâu thông thường nơi ứng dụng cần được cài đặt trên thiết bị của người dùng.

Để thiết lập liên kết sâu bị trì hoãn với OneLink, nhà phát triển cũng cần truy cập vào bảng điều khiển AppsFlyer.

Thiết lập cho liên kết sâu bị trì hoãn cũng giống như thiết lập dành cho liên kết sâu. Sự khác biệt duy nhất là bạn cần triển khai logic bổ sung trong ứng dụng để liên kết sâu với người dùng và phục vụ họ với nội dung tùy chỉnh sau khi họ cài đặt và khởi chạy ứng dụng.

Xem hướng dẫn của chúng tôi về liên kết sâu bị trì hoãn để tìm hiểu thêm.

SDK cung cấp cho bạn dữ liệu chuyển đổi hoặc tương tác sau mỗi lần cài đặt hoặc sự kiện liên kết sâu. Bạn có thể sử dụng dữ liệu này để tùy chỉnh nội dung và hành vi của ứng dụng theo chương trình.

Để lấy dữ liệu liên kết sâu, hãy thực hiện phương thức onAppOpenAttribution.

Xem hướng dẫn của chúng tôi về dữ liệu liên kết sâu để tìm hiểu thêm.

Để tìm hiểu cách thiết lập đo lường lượt gỡ cài đặt, hãy đọc tại đây.

Nếu bạn muốn nhận được xác nhận rằng yêu cầu theo dõi đã được máy chủ AppsFlyer nhận thành công, hãy triển khai trình xử lý trackAppLaunchWithCompletionHandler. Sau đó, bạn có thể áp dụng logic để xử lý thành công hoặc thất bại của việc Theo dõi khởi chạy ứng dụng.

Ví dụ

[[AppsFlyerTracker sharedTracker] trackAppLaunchWithCompletionHandler:^(NSDictionary<NSString *,id> *dictionary, NSError *error) {
        if (error) {
            NSLog(@"%@", error);
            return;
        }
        if (dictionary) {
            NSLog(@"%@", dictionary);
            return;
        }
    }];

 AppsFlyerTracker.shared()?.trackAppLaunch(completionHandler: { (dictionnary, error) in
            if (error != nil){
                print(error ?? "")
                return
            } else {
                print(dictionnary ?? "")
                return
            }
        })

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ày 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ó API setAdditionalData.

Ví dụ về mã setAdditableData:

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

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

Sử dụng API sau để đặt thời gian tối thiểu giữa các phiên:

[AppsFlyerTracker sharedTracker].minTimeBetweenSessions = <your_custom_time_in_seconds>;

AppsFlyerTracker.shared().minTimeBetweenSessions = <your_custom_time_in_seconds>

Đặt một giá trị cao  cho thời gian tùy chỉnh giữa các phiên khởi chạy có thể ảnh hưởng xấu tới API dựa trên dữ liệu các phiên, chẳng hạn như liên kết sâu.

Không khả dụng trong iOS. 

Một số dịch vụ của bên thứ 3 như nhà cung cấp dịch vụ email gói liên kết trong email với tên miền ghi nhận click của riêng họ. Một số dịch vụ thậm chí cho phép bạn thiết lập các miền ghi nhận nhấp chuột của riêng bạn. Nếu OneLink được gói trong các miền như vậy, điều này có thể giới hạn chức năng của nó.

Để khắc phục vấn đề này, bạn có thể sử dụng API setResolveDeepLinkURLs. Sử dụng API này để nhận OneLink từ các miền nhấp chuột khởi chạy ứng dụng.  Đảm bảo gọi API này trước khi khởi tạo SDK.

Ví dụ: bạn có ba miền nhấp chuột chuyển hướng đến OneLink của bạn, đó là https://mysubdomain.onelink.me/abCD. Sử dụng API này để nhận OneLink mà miền nhấp chuột của bạn chuyển hướng đến.  Phương thức API này nhận được danh sách các miền mà SDK giải quyết.

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

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

Mã ở trên cho phép bạn sử dụng miền nhấp chuột của mình trong khi vẫn duy trì chức năng OneLink. Các miền nhấp chuột có trách nhiệm khởi chạy ứng dụng. API, khi đến lượt, nhận được OneLink từ những miền nhấp chuột và sau đó bạn có thể sử dụng dữ liệu từ OneLink này để liên kết sâu và tùy chỉnh nội dung người dùng.

Với AppsFlyer, bạn có thể ghi nhận thông báo đẩy như một phần của chiến dịch nhắm mục tiêu lại.

Để kích hoạt tính năng này, hãy gọi phương thức handlePushNotificationData bên trong AppDelegate.m.

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

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

Để biết thêm thông tin về đo số lượng thông báo đẩy, hãy đọc tại đây.

Việc cho phép người dùng hiện tại mời bạn bè và những mối liên hệ của họ sử dụng ứng dụng có thể là một yếu tố tăng trưởng then chốt với ứng dụng của bạn. Với AppsFlyer, bạn có thể phân bổ và ghi nhận lượt cài đặt bắt nguồn từ lời mời của người dùng trong ứng dụng của bạn.

Để biết thêm chi tiết, hãy xem bài viết Phân bổ mời người dùng.

ID duy nhất của AppsFlyer được tạo cho mỗi lần ứng dụng được cài đặt mới. Bạn có thể sử dụng ID này cho nhiều mục đích khác nhau:

• Gửi các sự kiện trong ứng dụng server-to-server .
• Khớp ID với hồ sơ người dùng trong các hệ thống backend của bạn.
• Ánh xạ các mục khi hợp nhất dữ liệu từ API kéo và đẩy.

Hãy sử dụng API sau đây để thu được ID riêng của AppsFlyer:

NSString *appsflyerId = [AppsFlyerTracker sharedTracker].getAppsFlyerUID;

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

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

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

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

Trong iOS, Customer User ID cần được đặt cho mỗi lần khởi chạy ứng dụng. Chúng tôi khuyên bạn nên đặt Customer User ID sớm trong luồng của ứng dụng, vì nó chỉ được liên kết với các sự kiện được báo cáo sau khi thiết lập:

• Nếu setCustomerUserId được gọi trước khi gọi trackAppLaunch, Customer User ID sẽ xuất hiện trong các báo cáo dữ liệu thô cho các lượt cài đặt và sự kiện.
• Nếu được đặt sau, Customer User ID chỉ được liên kết với các sự kiện được ghi lại sau khi đặt ID Người dùng Khách hàng.

Nhận Customer User ID:

Để tránh thiết lập lại giá trị ID Người dùng Khách hàng sau lần khởi chạy đầu tiên và để giảm các cuộc gọi đến máy chủ của bạn để lấy Customer User ID, bạn có thể kiểm tra xem giá trị của nó có trống hay không bằng cách:

NSString *customerUserID = [AppsFlyerTracker sharedTracker].customerUserID;

let customerUserID = AppsFlyerTracker.shared().customerUserID

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

Trì hoãn Khởi tạo SDK cho customerUserID

Bạn có thể trì hoãn Khởi tạo SDK cho đến khi Customer User ID được thiết lập. Điều này hữu ích nếu bạn cần là dữ liệu cài đặt và sự kiện chứa customer user ID của bạn.

Thực hiện mã sau:

- (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
        }
    }

Để tìm hiểu thêm về việc trì hoãn khởi tạo SDK cho đến khi Customer User ID khả dụng, hãy truy cập tại đây .

Trong một số trường hợp nghiêm trọng, bạn có thể sẽ phải tắt tất cả các theo dõi SDK để bảo đảm tuân thủ pháp luật và quyền riêng tư. Có thể thực hiện việc này với thuộc tính isStopTracking. Khi thuộc tính này được đặt thành true, SDK sẽ ngừng hoạt động và không còn giao tiếp với các máy chủ AppsFlyer.

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 sharedTracker].isStopTracking = true;

AppsFlyerTracker.shared().isStopTracking = true

Trong bất kỳ sự kiện nào, SDK có thể được kích hoạt lại bằng cách gọi API tương tự, nếu kết quả là sai.

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 sharedTracker].deviceTrackingDisabled = YES;

AppsFlyerTracker.shared().deviceTrackingDisabled = true

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