Hướng dẫn tích hợp SDK iOS V6.X dành cho nhà phát triển

SDK này tự động thêm và sử dụng các khung gốc sau:

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

Đo lường hiệu suất của Apple Search Ads trong ứng dụng của bạn.

Khung AdServices (V6.1.3+)

Đo lường hiệu suất của Apple Search Ads trong ứng dụng của bạn.

Bạn có thể vô hiệu hóa các khung này. Để xóa hoàn toàn các khung khỏi ứng dụng của bạn, hãy sử dụng SDK chế độ nghiêm ngặt.

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

Để lấy khóa SDK:

1. Trong AppsFlyer, đi đến Configuration (Cấu hình) > App Settings (Cài đặt Ứng dụng). 
2. Hãy sao chép dev key của bạn, bạn sẽ cần dev key này cho bước tiếp theo.
   
   

Đoạn mã sau là một ví dụ thực hiện. Đảm bảo thay đổi phần giữ chỗ <AF_DEV_KEY> và <APPLE_APP_ID> nếu cần.

#import <UIKit/UIKit.h>
#import <AppsFlyerLib/AppsFlyerLib.h>

@interface AppDelegate : UIResponder <UIApplicationDelegate, AppsFlyerLibDelegate>

@end

#import "AppDelegate.h"
#import <UserNotifications/UserNotifications.h>

@interface AppDelegate ()

@end

@implementation AppDelegate
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
        // Override point for customization after application launch.
        /** APPSFLYER INIT **/
        [AppsFlyerLib shared].appsFlyerDevKey = @"<AF_DEV_KEY>";
        [AppsFlyerLib shared].appleAppID = @"<APPLE_APP_ID>";
        [AppsFlyerLib shared].delegate = self;
        /* Set isDebug to true to see AppsFlyer debug logs */
        [AppsFlyerLib shared].isDebug = true;
  if (@available(iOS 10, *)) {
        UNUserNotificationCenter *center = [UNUserNotificationCenter currentNotificationCenter];
        center.delegate = self;
        [center requestAuthorizationWithOptions:(UNAuthorizationOptionSound | UNAuthorizationOptionAlert | UNAuthorizationOptionBadge) completionHandler:^(BOOL granted, NSError * _Nullable error) {
        }];
  } else {
        UIUserNotificationSettings *settings = [UIUserNotificationSettings settingsForTypes: UIUserNotificationTypeAlert | UIUserNotificationTypeSound | UIUserNotificationTypeBadge categories:nil];
        [[UIApplication sharedApplication] registerUserNotificationSettings:settings];
  }
  [[UIApplication sharedApplication] registerForRemoteNotifications];
  return YES;
}
- (void)applicationDidBecomeActive:(UIApplication *)application {
    [[AppsFlyerLib shared] start];
}
// Deep linking
// Open URI-scheme for iOS 9 and above
- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url options:(NSDictionary *) options {
    [[AppsFlyerLib shared] handleOpenUrl:url options:options];
    return YES;
}
// Open URI-scheme for iOS 8 and below
- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString*)sourceApplication annotation:(id)annotation {
    [[AppsFlyerLib shared] handleOpenURL:url sourceApplication:sourceApplication withAnnotation:annotation];
    return YES;
}
// Open Universal Links
- (BOOL)application:(UIApplication *)application continueUserActivity:(NSUserActivity *)userActivity restorationHandler:(void (^)(NSArray * _Nullable))restorationHandler {
    [[AppsFlyerLib shared] continueUserActivity:userActivity restorationHandler:restorationHandler];
    return YES;
}
// Report Push Notification attribution data for re-engagements
- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler {
    [[AppsFlyerLib shared] handlePushNotification:userInfo];
}
// AppsFlyerLib implementation
//Handle Conversion Data (Deferred Deep Link)
-(void)onConversionDataSuccess:(NSDictionary*) installData {
    id status = [installData objectForKey:@"af_status"];
    if([status isEqualToString:@"Non-organic"]) {
        id sourceID = [installData objectForKey:@"media_source"];
        id campaign = [installData objectForKey:@"campaign"];
        NSLog(@"This is a non-organic install. Media source: %@  Campaign: %@",sourceID,campaign);
    } else if([status isEqualToString:@"Organic"]) {
        NSLog(@"This is an organic install.");
    }
}
-(void)onConversionDataFail:(NSError *) error {
    NSLog(@"%@",error);
}
//Handle Direct Deep Link
- (void) onAppOpenAttribution:(NSDictionary*) attributionData {
    NSLog(@"%@",attributionData);
}
- (void) onAppOpenAttributionFailure:(NSError *)error {
    NSLog(@"%@",error);
}
@end
              

import UIKit
import AppsFlyerLib

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {
    var window: UIWindow?
    let defaults = UserDefaults.standard
    //MARK: LifeCycle
    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
        AppsFlyerLib.shared().appsFlyerDevKey = "<AF_DEV_KEY>"
        AppsFlyerLib.shared().appleAppID = "<APPLE_APP_ID>"
        AppsFlyerLib.shared().delegate = self
        AppsFlyerLib.shared().isDebug = true
        // iOS 10 or later
        if #available(iOS 10, *) {
            UNUserNotificationCenter.current().requestAuthorization(options: [.badge, .alert, .sound]) { _, _ in }
            application.registerForRemoteNotifications()
        }
        // iOS 9 support - Given for reference. This demo app supports iOS 13 and above
        else {
            application.registerUserNotificationSettings(UIUserNotificationSettings(types: [.badge, .sound, .alert], categories: nil))
            application.registerForRemoteNotifications()
        }
        return true
    }
    func applicationDidBecomeActive(_ application: UIApplication) {
        // Start the SDK (start the IDFA timeout set above, for iOS 14 or later)
        AppsFlyerLib.shared().start()
    }
    // Open Univerasal Links
    // For Swift version < 4.2 replace function signature with the commented out code:
    // func application(_ application: UIApplication, continue userActivity: NSUserActivity, restorationHandler: @escaping ([Any]?) -> Void) -> Bool {
    func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any]) {
        print(" user info \(userInfo)")
        AppsFlyerLib.shared().handlePushNotification(userInfo)
    }
    // Open Deeplinks
    // Open URI-scheme for iOS 8 and below
    private func application(_ application: UIApplication, continue userActivity: NSUserActivity, restorationHandler: @escaping ([Any]?) -> Void) -> Bool {
        AppsFlyerLib.shared().continue(userActivity, restorationHandler: restorationHandler)
        return true
    }
    // Open URI-scheme for iOS 9 and above
    func application(_ application: UIApplication, open url: URL, sourceApplication: String?, annotation: Any) -> Bool {
        AppsFlyerLib.shared().handleOpen(url, sourceApplication: sourceApplication, withAnnotation: annotation)
        return true
    }
    // Report Push Notification attribution data for re-engagements
    func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey : Any] = [:]) -> Bool {
        AppsFlyerLib.shared().handleOpen(url, options: options)
        return true
    }
    func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any], fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) {
        AppsFlyerLib.shared().handlePushNotification(userInfo)
    }
    // Reports app open from deep link for iOS 10 or later
    func application(_ application: UIApplication, continue userActivity: NSUserActivity, restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void) -> Bool {
        AppsFlyerLib.shared().continue(userActivity, restorationHandler: nil)
        return true
    }
}
//MARK: AppsFlyerLibDelegate
extension AppDelegate: AppsFlyerLibDelegate{
    // Handle Organic/Non-organic installation
    func onConversionDataSuccess(_ installData: [AnyHashable: Any]) {
        print("onConversionDataSuccess data:")
        for (key, value) in installData {
            print(key, ":", value)
        }
        if let status = installData["af_status"] as? String {
            if (status == "Non-organic") {
                if let sourceID = installData["media_source"],
                    let campaign = installData["campaign"] {
                    print("This is a Non-Organic install. Media source: \(sourceID)  Campaign: \(campaign)")
                }
            } else {
                print("This is an organic install.")
            }
            if let is_first_launch = installData["is_first_launch"] as? Bool,
                is_first_launch {
                print("First Launch")
            } else {
                print("Not First Launch")
            }
        }
    }
    func onConversionDataFail(_ error: Error) {
        print(error)
    }
    //Handle Deep Link
    func onAppOpenAttribution(_ attributionData: [AnyHashable : Any]) {
        //Handle Deep Link Data
        print("onAppOpenAttribution data:")
        for (key, value) in attributionData {
            print(key, ":",value)
        }
    }
    func onAppOpenAttributionFailure(_ error: Error) {
        print(error)
    }
}

Chỉ sử dụng phương thức khởi tạo này nếu bạn đang sử dụng SceneDelegate.

Vì applicationDidBecomeActive không được gọi ra khi sử dụng SceneDelegate nên hãy sử dụng giải pháp thay thế UIApplicationDidBecomeActiveNotification để khởi chạy SDK, như được minh họa trong ví dụ sau.

Đoạn mã sau là một ví dụ thực hiện. Đảm bảo thay đổi phần giữ chỗ <AF_DEV_KEY> và <APPLE_APP_ID> nếu cần.

#import <AppsFlyerLib/AppsFlyerLib.h>

@interface AppDelegate : UIResponder <UIApplicationDelegate, AppsFlyerLibDelegate>

@end
            

#import "AppDelegate.h"
#import <AppsFlyerLib/AppsFlyerLib.h>
#import <UserNotifications/UserNotifications.h>
@interface AppDelegate ()
@end
@implementation AppDelegate
// Start the AppsFlyer SDK
- (void)sendLaunch:(UIApplication *)application {
        [[AppsFlyerLib shared] start];
    }
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
        // Override point for customization after application launch.
        /** APPSFLYER INIT **/
        [AppsFlyerLib shared].appsFlyerDevKey = @"<AF_DEV_KEY>";
        [AppsFlyerLib shared].appleAppID = @"<APPLE_APP_ID>";
        [AppsFlyerLib shared].delegate = self;
        /* Set isDebug to true to see AppsFlyer debug logs */
        [AppsFlyerLib shared].isDebug = true;
        // Use UIApplicationDidBecomeActiveNotification to start the SDK
        [[NSNotificationCenter defaultCenter] addObserver:self
            selector:@selector(sendLaunch:)
            name:UIApplicationDidBecomeActiveNotification
            object:nil];

  if (@available(iOS 10, *)) {
        UNUserNotificationCenter *center = [UNUserNotificationCenter currentNotificationCenter];
        center.delegate = self;
        [center requestAuthorizationWithOptions:(UNAuthorizationOptionSound | UNAuthorizationOptionAlert | UNAuthorizationOptionBadge) completionHandler:^(BOOL granted, NSError * _Nullable error) {
        }];
  } else {
        UIUserNotificationSettings *settings = [UIUserNotificationSettings settingsForTypes: UIUserNotificationTypeAlert | UIUserNotificationTypeSound | UIUserNotificationTypeBadge categories:nil];
        [[UIApplication sharedApplication] registerUserNotificationSettings:settings];
  }
  [[UIApplication sharedApplication] registerForRemoteNotifications];
  return YES;
}

// Report Push Notification attribution data for re-engagements
- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler {
    [[AppsFlyerLib shared] handlePushNotification:userInfo];
}

// AppsFlyerLib implementation
//Handle Conversion Data (Deferred Deep Link)
-(void)onConversionDataSuccess:(NSDictionary*) installData {
    id status = [installData objectForKey:@"af_status"];
    if([status isEqualToString:@"Non-organic"]) {
        id sourceID = [installData objectForKey:@"media_source"];
        id campaign = [installData objectForKey:@"campaign"];
        NSLog(@"This is a none organic install. Media source: %@  Campaign: %@",sourceID,campaign);
    } else if([status isEqualToString:@"Organic"]) {
        NSLog(@"This is an organic install.");
    }
}

-(void)onConversionDataFail:(NSError *) error {
    NSLog(@"%@",error);
}

//Handle Direct Deep Link
- (void) onAppOpenAttribution:(NSDictionary*) attributionData {
    NSLog(@"%@",attributionData);
}

- (void) onAppOpenAttributionFailure:(NSError *)error {
    NSLog(@"%@",error);
}

// support for scene delegate
#pragma mark - UISceneSession lifecycle
- (UISceneConfiguration *)application:(UIApplication *)application configurationForConnectingSceneSession:(UISceneSession *)connectingSceneSession options:(UISceneConnectionOptions *)options API_AVAILABLE(ios(13)){
    // Called when a new scene session is being created.
    // Use this method to select a configuration to create the new scene with.
    return [[UISceneConfiguration alloc] initWithName:@"Default Configuration" sessionRole:connectingSceneSession.role];
}

- (void)application:(UIApplication *)application didDiscardSceneSessions:(NSSet *)sceneSessions  API_AVAILABLE(ios(13.0)){
    // Called when the user discards a scene session.
    // If any sessions were discarded while the application was not running, this will be called shortly after application:didFinishLaunchingWithOptions.
    // Use this method to release any resources that were specific to the discarded scenes, as they will not return.
}
@end    
            

#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){
        [[AppsFlyerLib shared] handleOpenUrl:url options:nil];
    }
}

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

- (void)scene:(UIScene *)scene willConnectToSession:(UISceneSession *)session options:(UISceneConnectionOptions *)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).
    NSUserActivity *activity = [[connectionOptions userActivities] allObjects].firstObject;
    if (activity) {
        [self scene:scene continueUserActivity:activity];
    }
    [self scene:scene openURLContexts: [connectionOptions URLContexts]];
}


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

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate, AppsFlyerLibDelegate {
    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
         AppsFlyerLib.shared().appsFlyerDevKey = "<AF_DEV_KEY>"
         AppsFlyerLib.shared().appleAppID = "<APPLE_APP_ID>"
         AppsFlyerLib.shared().delegate = self
         AppsFlyerLib.shared().isDebug = true
                NotificationCenter.default.addObserver(self, selector: NSSelectorFromString("sendLaunch"), name: UIApplication.didBecomeActiveNotification, object: nil)
        return true
    }
    @objc func sendLaunch() {
       AppsFlyerLib.shared().start()
    }
    // MARK: UISceneSession Lifecycle
    func application(_ application: UIApplication, configurationForConnecting connectingSceneSession: UISceneSession, options: UIScene.ConnectionOptions) -> UISceneConfiguration {
        // Called when a new scene session is being created.
        // Use this method to select a configuration to create the new scene with.
        return UISceneConfiguration(name: "Default Configuration", sessionRole: connectingSceneSession.role)
    }
    func application(_ application: UIApplication, didDiscardSceneSessions sceneSessions: Set<UISceneSession>) {
        // Called when the user discards a scene session.
        // If any sessions were discarded while the application was not running, this will be called shortly after application:didFinishLaunchingWithOptions.
        // Use this method to release any resources that were specific to the discarded scenes, as they will not return.
    }
    //MARK: -GCD
       func onConversionDataSuccess(_ installData: [AnyHashable: Any]) {
          print("onConversionDataSuccess data:")
               for (key, value) in installData {
                   print(key, ":", value)
               }
               if let status = installData["af_status"] as? String {
                   if (status == "Non-organic") {
                       if let sourceID = installData["media_source"],
                           let campaign = installData["campaign"] {
                           print("This is a Non-Organic install. Media source: \(sourceID)  Campaign: \(campaign)")
                       }
                   } else {
                       print("This is an organic install.")
                   }
                   if let is_first_launch = installData["is_first_launch"] as? Bool,
                       is_first_launch {
                       print("First Launch")
                   } else {
                       print("Not First Launch")
                   }
               }
          }
       func onConversionDataFail(_ error: Error!) {
          if let err = error{
            print(err)
          }
        }
        func onAppOpenAttribution(_ attributionData: [AnyHashable : Any]!) {
          if let data = attributionData{
            print("\(data)")
          }
        }
        func onAppOpenAttributionFailure(_ error: Error!) {
          if let err = error{
            print(err)
          }
        }
}
            

import UIKit
import AppsFlyerLib

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

    var window: UIWindow?
 
 func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options connectionOptions: UIScene.ConnectionOptions) {
        // Processing Universal Link from the killed state
        if let userActivity = connectionOptions.userActivities.first {
          self.scene(scene, continue: userActivity)
        }
     // Processing URI-scheme from the killed state
          self.scene(scene, openURLContexts: connectionOptions.urlContexts)
          
          guard let _ = (scene as? UIWindowScene) else { return }
    }
    
    func scene(_ scene: UIScene, continue userActivity: NSUserActivity) {
        AppsFlyerLib.shared().continue(userActivity, restorationHandler: nil)
    }
    
    func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>) {
        if let url = URLContexts.first?.url {
            AppsFlyerLib.shared().handleOpen(url, options: nil) 
        }
    }


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

Thông tin cơ bản

Kể từ phiên bản iOS 14.5, chức năng thu thập IDFA yêu cầu người dùng đồng ý. Trên thực tế, điều đó có nghĩa là quyền truy cập IDFA được điều chỉnh bởi khung Minh bạch về Theo dõi Ứng dụng (ATT). Trên thiết bị iOS từ phiên bản 14 trở lên, SDK sử dụng khung ATT để có quyền truy cập vào IDFA của thiết bị. 

Để biết thông tin giới thiệu về ATT, hãy xem các nguyên tắc về ATT .

Khi phân bổ xảy ra bằng cách sử dụng IDFA, quan trọng là IDFA phải được gửi vào lần khởi chạy đầu tiên. Vì lý do này, SDK cung cấp tiện ích waitForATTUserAuthorization.

Tổng quan về waitForATTUserAuthorization

waitForATTUserAuthorization cho phép bạn định cấu hình thời gian SDK hoãn gửi dữ liệu đến máy chủ AppsFlyer và đợi trạng thái của ATT.

Khi người dùng khởi chạy ứng dụng, trạng thái ATT là notDetermined. Trong thời gian chờ waitForATTUserAuthorization:

• SDK xếp hàng đợi cho sự kiện khởi chạy và các sự kiện trong ứng dụng liên tiếp trong bộ nhớ, tương tự như cách các sự kiện ngoại tuyến được ghi nhận
• Nếu người dùng đồng ý với lời nhắc ATT (Thu thập IDFA):
  • SDK sẽ thêm IDFA vào các sự kiện được lưu trong bộ nhớ tạm
  • SDK bắt đầu và gửi các sự kiện được lưu trong bộ nhớ tạm cùng với IDFA (mà không cần đợi hết thời gian chờ)
• Nếu người dùng từ chối lời nhắc ATT:
  • SDK bắt đầu và gửi các sự kiện được lưu trong bộ nhớ tạm không kèm theo IDFA (mà không cần đợi hết thời gian chờ)
• Nếu thời gian chờ kết thúc và trạng thái ATT vẫn là notDetermined:
  • SDK bắt đầu và gửi các sự kiện được lưu trong bộ nhớ tạm mà không có IDFA

Tổng quan về việc triển khai hỗ trợ ATT

Việc triển khai hỗ trợ ATT đầy đủ bao gồm:

• Cấu hình waitForATTUserAuthorization trong giai đoạn khởi tạo ứng dụng, thường là trong didFinishLaunchingWithOptions
• Gọi ra requestTrackingAuthorization, bất cứ khi nào bạn hiển thị lời nhắc ATT.

Để cấu hình hỗ trợ ATT trong SDK iOS:

1. Trong didFinishLaunchingWithOptions, cấu hình waitForATTUserAuthorization:
   • Đặt bộ định thời waitForATTUserAuthorization sao cho người dùng của bạn có đủ thời gian để xem và thu hút bởi lời nhắc ATT. Một vài ví dụ:
     • Nếu lời nhắc ATT được hiển thị khi khởi chạy ứng dụng–thì khoảng thời gian 60 giây là đủ
     • Nếu lời nhắc ATT được hiển thị sau phần hướng dẫn mà cần 2 phút để hoàn thành–thì khoảng thời gian 120 giây là đủ
   Objective-C Swift

   - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
       [[AppsFlyerLib shared] setAppsFlyerDevKey:@"<AF_DEV_KEY>"];
       [[AppsFlyerLib shared] setAppleAppID:@"<APPLE_APP_ID>"];
       ...
       [[AppsFlyerLib shared] waitForATTUserAuthorizationWithTimeoutInterval:60];
       ...
       return YES;
   }

   class AppDelegate: UIResponder, UIApplicationDelegate, AppsFlyerLibDelegate {
           func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
        AppsFlyerLib.shared().appsFlyerDevKey = "<AF_DEV_KEY>"
        AppsFlyerLib.shared().appleAppID = "<APPLE_APP_ID>"
        ...
        AppsFlyerLib.shared().waitForATTUserAuthorization(timeoutInterval: 60)
        ...
     }
      ...
   }

2. Trong applicationDidBecomeActive, hãy gọi ra start như được mô tả trong Khởi tạo SDK.
3. Trong mã ứng dụng của bạn, hãy gọi ra requestTrackingAuthorization để hiển thị lời nhắc ATT. Ví dụ: nếu bạn muốn hiển thị cho người dùng hộp thoại đồng ý khi một chế độ xem nhất định tải xong:
   Objective-C Swift

   - (void)viewDidLoad {
       [super viewDidLoad];
       
       if #available(iOS 14, *) {
         [ATTrackingManager requestTrackingAuthorizationWithCompletionHandler:^(ATTrackingManagerAuthorizationStatus status) {
           NSLog(@"Status: %lu", (unsigned long)status);
         }];
       }
   }

   override func viewDidLoad() {
     super.viewDidLoad()
     
     if #available(iOS 14, *) {
       ATTrackingManager.requestTrackingAuthorization { (status) in }
     }
   }

   Lệnh gọi này kích hoạt lời nhắc ATT.
   
   

Những điều cần lưu ý

• Việc gọi ra requestTrackingAuthorization mà không cài đặt waitForATTUserAuthorization sẽ dẫn đến việc khởi chạy và gửi sự kiện mà không có IDFA đối với thiết bị iOS từ phiên bản 14 trở lên
• Nếu người dùng chuyển ứng dụng sang chạy ngầm trong thời gian chờ:
  • Bộ hẹn giờ tạm dừng cho đến khi ứng dụng quay trở lại chế độ chạy nổi
  • Sự kiện được lưu vào bộ nhớ tạm
• Nếu người dùng tắt ứng dụng theo quy trình/tắt hẳn ứng dụng đột ngột trong thời gian chờ:
  • Bộ hẹn giờ được khởi động lại vào lần khởi chạy ứng dụng tiếp theo
  • Sự kiện được lưu vào bộ nhớ tạm sẽ bị mất

1. Chọn tệp tin Info.plist của dự ántrong Trình điều hướng Dự án Xcode.
2. Thêm một mục nhập vào danh sách: Nhấn + bên cạnh Information Property List (Danh sách Thuộc tính Thông tin).

   

3. Cuộn xuống và chọn Privacy - Tracking Usage Description (Quyền riêng tư - Theo dõi Mô tả Lưu lượng sử dụng).
4. Thêm dưới dạng giá trị từ ngữ bạn muốn trình bày với người dùng khi yêu cầu quyền thu thập IDFA.

   

SKAdNetwork là một lớp được iOS sử dụng để xác thực các lượt cài đặt ứng dụng định hướng theo nhà quảng cáo. Quy trình xác thực cài đặt ứng dụng liên quan đến ứng dụng nguồn và ứng dụng được quảng cáo. 

Ứng dụng nguồn là một ứng dụng tham gia vào các chiến dịch quảng cáo bằng cách hiển thị quảng cáo được ký bởi mạng quảng cáo. Việc cấu hình ứng dụng của bạn để hiển thị quảng cáo không nằm trong phạm vi của SDK AppsFlyer. Để cấu hình, hãy làm theo hướng dẫn của Apple.

Đối với ứng dụng được quảng cáo (ứng dụng có SDK AppsFlyer), Giải pháp SKAdNetwork của AppsFlyer sử dụng SKAdNetwork để cung cấp đăng lại phân bổ trong khi AppsFlyer thu thập, dịch và hợp nhất dữ liệu, đồng thời duy trì quyền riêng tư của người dùng. Khi khởi chạy ứng dụng lần đầu, nền tảng AppsFlyer, sử dụng cấu hình do nhà tiếp thị đặt, sẽ chỉ thị SDK cách đặt giá trị chuyển đổi SKAdNetwork.

Để sử dụng Giải pháp SKAdNetwork:

• Nhà phát triển không phải thực hiện bất cứ thao tác nào.
• SDK AppsFlyer tự động gọi các API SKAdNetwork cần thiết, có nghĩa là registerAppForAdNetworkAttribution() và updateConversionValue(). Nhà phát triển không phải gọi các lệnh này. 
• Không cho phép các SDK khác gọi ra API SKAdNet. Vì như vậy có thể khiến iOS chậm gửi đăng lại tới AppsFlyer và thay đổi giá trị chuyển đổi mà chúng tôi sử dụng để tính toán các số liệu chất lượng người dùng trên bảng điều khiển SKAdNetwork. 
• Nhà tiếp thị cần cấu hình đo lường SKAdNetwork trong AppsFlyer. 

Không yêu cầu nhà phát triển hoặc nhà tiếp thị phải có hành động hoặc quy trình đăng ký trong cửa hàng ứng dụng.

Để tắt phân bổ SKAdNetwork, hãy sử dụng API disableSKAdNetwork.

Trước khi bạn bắt đầu thử nghiệm lượt cài đặt:

• Đảm bảo rằng thiết bị của bạn chưa cài đặt ứng dụng.
• Đăng ký thiết bị bạn sẽ dùng để thử nghiệm.

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.

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

Gửi start() trong nhật ký cho biết rằng SDK báo cáo một lượt 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 .

Lúc này, một lượt cài đặt tự nhiên sẽ xuất hiện trên trang Overview (Tổng quan) của bảng điều khiển ứng dụng.

Nếu bạn không thấy lượt 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à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
   

   Ví dụ:

   https://app.appsflyer.com/id0123456789?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:

Lúc này, lượt cài đặt không tự nhiên sẽ xuất hiện trên trang Overview (Tổng quan) của bảng điều khiển ứng dụng.

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

• 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 AppsFlyerLib.h nếu sử dụng Objective-C hoặc AppsFlyerLib nếu sử dụng Swift:

#import AppsFlyerLib.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: [AppsFlyerLib shared].currencyCode = @"ZZZ";,
  • Swift: AppsFlyerLib.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

[[AppsFlyerLib shared] logEvent: @"purchase" 
withValues:@{
	AFEventParamContentId:@"1234567",
	AFEventParamContentType : @"category_a",
	AFEventParamRevenue: @200,
	AFEventParamCurrency:@"USD"
}];

AppsFlyerLib.shared().logEvent("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ý.

[[AppsFlyerLib shared] logEvent: @"cancel_purchase" 
withValues:@{
	AFEventParamContentId:@"1234567",
	AFEventParamContentType : @"category_a",
	AFEventParamRevenue: @-1.99,
	AFEventParamCurrency:@"USD"
}];

AppsFlyerLib.shared().logEvent("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 thực việc mua hàng, hãy gọi validateAndLogInAppPurchase.

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) validateAndLogInAppPurchase:(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;

[[AppsFlyerLib shared] validateAndLogInAppPurchase:@"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;
      }
  }];

AppsFlyerLib
      .shared()?
      .validateAndLogInAppPurchase ("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>
    })

Khi kiểm tra xác thực mua trong môi trường Sandbox, hãy thêm mã sau đây:

[AppsFlyerLib shared].useReceiptValidationSandbox = YES;

AppsFlyerLib.shared().useReceiptValidationSandbox = true

Lưu ý phải xóa mã này khỏi bản dựng bạn phát triển.

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
• Đị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

[[AppsFlyerLib shared] logEvent:AFEventPurchase
   withValues: @{
    AFEventParamRevenue: @200,
    AFEventParamCurrency: @"USD",
    AFEventParamQuantity: @2,
    AFEventParamContentId: @"092",
    AFEventParamReceiptId: @"9277"
  }];

AppsFlyerLib.shared().logEvent(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.

 [[AppsFlyerLib shared] logEventWithEventName: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);
            }
    }];
    

AppsFlyerLib.shared().logEvent(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)
             }
           })
        }
            

Trong trường hợp xảy ra lỗi khi ghi sự kiện trong ứng dụng, mã lỗi và mô tả chuỗi sẽ được cung cấp, như được chỉ ra trong bảng sau.

Đối với người dùng chưa cài đặt ứng dụng của bạn, OneLink sẽ nhận diện loại thiết bị và chuyển hướng họ đến điểm đích chính xác: Google Play, Apple App Store, cửa hàng ứng dụng của bên thứ ba hoặc trang web. Điều này dựa vào cài đặt mẫu OneLink của bạn. Tìm hiểu thêm

Lưu ý: Tính năng nhận diện và chuyển hướng thiết bị không yêu cầu SDK AppsFlyer. Tuy nhiên, SDK là cần thiết để thực hiện phân bổ.

Đối với người dùng đã cài đặt ứng dụng của bạn, OneLink sẽ mở ứng dụng. Ngoài việc mở ứng dụng, bạn cũng có thể liên kết sâu người dùng với một hoạt động hoặc trang cụ thể trong ứng dụng. Điều này yêu cầu nhà phát triển của bạn triển khai Liên kết sâu hợp nhất (UDL).

Lưu ý:

• UDL yêu cầu SDK V6.1 trở lên
• Những khách hàng đã sử dụng OneLink để liên kết sâu có thể đang sử dụng phương thức kế thừa, thay vì UDL

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.

Đối với người dùng chưa cài đặt ứng dụng của bạn, OneLink sẽ nhận diện loại thiết bị và chuyển hướng họ đến điểm đích chính xác: Google Play, Apple App Store, cửa hàng ứng dụng của bên thứ ba hoặc trang web. Sau khi người dùng khởi chạy ứng dụng, bạn có thể sử dụng liên kết sâu gián tiếp để chuyển hướng họ đến một hoạt động hoặc trang cụ thể trong ứng dụng.

Điều này yêu cầu nhà phát triển của bạn triển khai Liên kết sâu hợp nhất (UDL).

Lưu ý:

• UDL yêu cầu SDK V6.1 trở lên
• Những khách hàng đã sử dụng OneLink để liên kết sâu gián tiếp có thể đang sử dụng phương thức kế thừa, thay vì UDL

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 và 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.

Để có được dữ liệu liên kết sâu khi sử dụng liên kết sâu trực tiếp và đang mở ứng dụng, hãy thực hiện phương thức onAppOpenAttribution.

Để có được dữ liệu tái tương tác liên kết sâu theo cách thủ công bất cứ lúc nào, hãy thực hiện phương thức performOnAppAttribution. Điều này cho phép truy cập vào dữ liệu tái tương tác mà không ghi nhận lượt tái tương tác mới.

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.

Phương thức addPushNotificationDeepLinkPath cung cấp cho chủ sở hữu ứng dụng một giao diện linh hoạt để cấu hình cách các liên kết sâu được trích xuất từ các tải trọng thông báo đẩy.

Theo mặc định, SDK tìm kiếm giá trị liên kết sâu trong mã khóa af của tải trọng JSON của thông báo đẩy. Nhiều nhà cung cấp dịch vụ thông báo đẩy sử dụng các lược đồ JSON độc quyền mà SDK sẽ không thể giải quyết nếu không được cấu hình bổ sung.

addPushNotificationDeepLinkPath cho phép bạn cấu hình mã khóa nào trong tải trọng JSON của thông báo đẩy mà SDK nên sử dụng cho giá trị liên kết sâu.

Sử dụng phương thức này nếu bạn đang tích hợp ứng dụng của mình với các nhà cung cấp dịch vụ thông báo đẩy không sử dụng lược đồ JSON thông báo đẩy mặc định mà SDK mong đợi.

Khi gọi ra addPushNotificationDeepLinkPath, SDK sẽ xác minh rằng:

• Mã khóa được yêu cầu tồn tại trong tải trọng.
• Mã khóa chứa một URL OneLink hợp lệ.

Cấu hình cơ bản

Hãy xem xét lệnh gọi sau tới addPushNotificationDeepLinkPath

[AppsFlyerLib shared] addPushNotificationDeepLinkPath:@[@"deeply", @"nested", @"deep_link"]]

AppsFlyerLib.shared().addPushNotificationDeepLinkPath(["deeply", "nested", "deep_link"])

và các tình huống sau:

Tình huống 1

Ứng dụng của bạn được gọi qua thông báo đẩy. Thông báo đẩy đó chứa một tải trọng có cấu trúc như sau.

{
    ...
    "deeply": {
        "nested": {
            "deep_link": "https://yourdeeplink2.onelink.me"
        }
    }
    ...
}

Trong trường hợp này, SDK trích xuất giá trị của deep_link và tiếp tục với luồng liên kết sâu.

Tình huống 2

Ứng dụng của bạn được gọi qua thông báo đẩy. Thông báo đẩy đó chứa một tải trọng có cấu trúc như sau.

{
    ...
    "deeply": {
        "nested": {
            "banana": "https://yourdeeplink2.onelink.me"
        }
    },
    ...
}

Trong trường hợp này, khi lệnh gọi thực thi SDK không thể tìm thấy mã khóa deep_link trong tải trọng. Do đó, không có gì xảy ra.

Tình huống 3

Ứng dụng của bạn được gọi qua thông báo đẩy. Thông báo đẩy đó chứa một tải trọng có cấu trúc như sau.

{
    ...
    "deeply": {
        "nested": {
            "deep_link": "Corrupted url or regular string"
        }
    },
    ...
}

Trong trường hợp này, mặc dù SDK tìm thấy mã khóa deep_link nhưng giá trị liên kết sâu của SDK lại không hợp lệ. Do đó, khi thực thi lệnh gọi trên thì không có gì xảy ra.

Cấu hình nâng cao

Để cấu hình nhiều cấu trúc tải trọng có thể có, hãy gọi addPushNotificationDeepLinkPath nhiều lần:

• Lệnh gọi đầu tiên mang lại giá trị liên kết sâu hợp lệ sẽ được sử dụng
• Các lệnh gọi khác bị bỏ qua

Nếu không có cấu trúc tải trọng nào khớp hoặc không tìm thấy URL OneLink hợp lệ nào trong tải trọng, thì không có gì xảy ra.

Ví dụ: hãy xem xét tải trọng sau

{
    ...
    "deeply": {
        "nested": {
            “deep_link”: “https://yourdeeplink2.onelink.me”
        }
    },
    “this”: {
        “is”: {
            "banana": "phone"
        }
    }
    ...
}

và các lệnh gọi sau tới addPushNotificationDeepLinkPath.

// this.is.deep_link key isn’t found - nothing happens
[AppsFlyerLib shared] addPushNotificationDeepLinkPath:@[@"this", @"is", @"deep_link"]]

// this.is.banana key found, but contains invalid OneLink URL - nothing happens
[AppsFlyerLib shared] addPushNotificationDeepLinkPath:@[@"this", @"is", @"banana"]]

// deeply.nested.deep_link key found and contains valid OneLink URL - proceed deep linking flow
[AppsFlyerLib shared] addPushNotificationDeepLinkPath:@[@"deeply", @"nested", @"deep_link"]]

// this.is.deep_link key isn’t found - nothing happens
AppsFlyerLib.shared().addPushNotificationDeepLinkPath(["this", "is", "deep_link"]);

// this.is.banana key found, but contains invalid OneLink URL - nothing happens
AppsFlyerLib.shared().addPushNotificationDeepLinkPath(["this", "is", "banana"])

// deeply.nested.deep_link key found and contains valid OneLink URL - proceed deep linking flow
AppsFlyerLib.shared().addPushNotificationDeepLinkPath(["deeply", "nested", "deep_link"])

Bạn có thể truy cập dữ liệu phân bổ người dùng theo thời gian thực đối với mỗi lần cài đặt mới, trực tiếp từ SDK.

Bằng cách này, bạn có thể phục vụ người dùng với nội dung được cá nhân hóa hoặc gửi cho họ các hoạt động cụ thể trong ứng dụng (xem liên kết sâu bị trì hoãn trong bài viết này), điều này có thể giúp tăng cường sự tương tác của họ với ứng dụng của bạn.

Để có được dữ liệu chuyển đổi từ SDK iOS, hãy thực hiện các phương thức sau:

- (void) onAppOpenAttribution:(NSDictionary*) attributionData {
    NSLog(@"onAppOpenAttribution");
    for(id key in attributionData){
        NSLog(@"onAppOpenAttribution: key=%@ value=%@", key, [attributionData objectForKey:key]);
    }
}

- (void)onAppOpenAttributionFailure:(NSError *)error {
     NSLog(@"%@", [error description]);
}

-(void)onConversionDataSuccess:(NSDictionary*) installData {
        
    BOOL first_launch_flag = [[installData objectForKey:@"is_first_launch"] boolValue];
    NSString *status = [installData objectForKey:@"af_status"];
    
    if(first_launch_flag) {
        if ([status isEqualToString:@"Non-organic"]){
            NSString *sourceID = [installData objectForKey:@"media_source"];
            NSString *campaign = [installData objectForKey:@"campaign"];
            NSLog(@"This is a non-organic install. Media source: %@ Campaign: %@", sourceID, campaign);
        } else {
            NSLog(@"This is an organic install");
        }
    } else {
        NSLog(@"Not first launch");
    }
}

-(void)onConversionDataFail:(NSError *) error {
    NSLog(@"%@", [error description]);
}

class AppDelegate: UIResponder, UIApplicationDelegate, AppsFlyerLibDelegate{
 
  func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
    AppsFlyerLib.shared().appsFlyerDevKey = "MY_DEV_KEY"
    AppsFlyerLib.shared().appleAppID = "123456789"
    AppsFlyerLib.shared().delegate = self
    //AppsFlyerLib.shared().isDebug = true
    //AppsFlyerLib.shared().appInviteOneLinkID = "ONELINK_ID";
    return true
  }
  
  func applicationDidBecomeActive(_ application: UIApplication) {
    AppsFlyerLib.shared().start()
  }
  
    func onConversionDataSuccess(_ installData: [AnyHashable: Any]) {
        
        guard let first_launch_flag = installData["is_first_launch"] as? Int else {
            return
        }
        
        guard let status = installData["af_status"] as? String else {
            return
        }
        
        if(first_launch_flag == 1) {
            if(status == "Non-organic") {
                if let media_source = installData["media_source"] , let campaign = installData["campaign"]{
                    print("This is a Non-Organic install. Media source: \(media_source) Campaign: \(campaign)")
                }
            } else {
                print("This is an organic install.")
            }
        } else {
            print("Not First Launch")
        }
    }
  
  func onConversionDataFail(_ error: Error!) {
    if let err = error{
      print(err)
    }
  }
  
  func onAppOpenAttribution(_ attributionData: [AnyHashable : Any]!) {
    if let data = attributionData{
      print("\(data)")
    }
  }
  
  func onAppOpenAttributionFailure(_ error: Error!) {
    if let err = error{
      print(err)
    }
  }

Hai phương thức quan trọng nhất là:

• onConversionDataSuccess - cung cấp dữ liệu chuyển đổi cho các lượt cài đặt mới.
  

  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 .

• onAppOpenAttribution - cung cấp dữ liệu chuyển đổi nhắm mục tiêu lại khi một ứng dụng hiện có được khởi chạy, thủ công hoặc thông qua liên kết sâu.

Để tìm hiểu thêm về dữ liệu chuyển đổi, hãy xem hướng dẫn của chúng tôi về các tình huống dữ liệu chuyển đổi.

Để 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 SDK đã khởi động thành công và thông báo cho các máy chủ AppsFlyer, hãy triển khai trình xử lý startWithCompletionHandler. Sau đó, bạn có thể áp dụng logic để xử lý trạng thái thành công hay thất bại của hoạt động khởi chạy SDK.

Ví dụ

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

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

Trong trường hợp xảy ra lỗi trong trình theo dõi yêu cầu, mã lỗi và mô tả chuỗi sẽ được cung cấp, như được chỉ ra trong bảng sau.

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];
[[AppsFlyerLib shared] setAdditionalData:customDataMap];

let customDataMap: [AnyHashable: Any] = [
  "custom_param_1" : "value_of_param_1"
]
AppsFlyerLib.shared().customData = customDataMap

Chủ sở hữu ứng dụng sử dụng Liên kết Chung để liên kết sâu (không có OneLink) và có miền được liên kết với ứng dụng của họ có thể phân bổ các phiên được khởi tạo thông qua miền này bằng phương thức appendParametersToDeepLinkingURL.

Ví dụ: một người dùng tìm kiếm trên Google và nhấp vào miền của bạn, www.example.com:

• Nếu người dùng chưa cài đặt ứng dụng, họ sẽ được chuyển hướng đến trang web (www.example.com).
• Nếu người dùng đã cài đặt ứng dụng trên thiết bị của họ, họ sẽ được liên kết sâu vào ứng dụng được liên kết với www.example.com. Phiên này được phân bổ cho nguồn truyền thông (thông số pid) được chỉ định trong appendParametersToDeepLinkingURL.

Xem tài liệu tham khảo về SDK iOS để biết thêm thông tin.

Lưu ý: Biểu ngữ Thông minh giúp chủ sở hữu ứng dụng chuyển đổi khách truy cập trang web thành người dùng ứng dụng.

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:

[AppsFlyerLib shared].minTimeBetweenSessions = <your_custom_time_in_seconds>;

AppsFlyerLib.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.

[AppsFlyerLib shared].resolveDeepLinkURLs = @[@"example.com",@"click.example.com"];

AppsFlyerLib.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 fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler {
[[AppsFlyerLib shared] handlePushNotification:userInfo];
}

func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any], fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) {
    AppsFlyerLib.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.

Lưu ý! Quảng cáo chéo của IDFV yêu cầu SDK 6.0.2+. IDFV được thu thập tự động và nhà phát triển không cần thực hiện thêm hành động nào.

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.

Sử dụng API sau để lấy ID duy nhất:

NSString *appsflyerId = [AppsFlyerLib shared].getAppsFlyerUID;

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

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

[AppsFlyerLib shared].customerUserID = @"my user id";

AppsFlyerLib.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 start, 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 nhận sau khi cài đặt Customer User ID.

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 = [AppsFlyerLib shared].customerUserID;

let customerUserID = AppsFlyerLib.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: @""]) {
        [AppsFlyerLib shared].customerUserID = customUserId; // Set CUID in AppsFlyer SDK for this session
        [[AppsFlyerLib shared] start]; // Start
    }
}

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

Để 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 .

Bạn có thể cần trì hoãn việc khởi tạo SDK và gửi dữ liệu cho đến khi người dùng đồng ý (ví dụ: chấp thuận GDPR hoặc COPPA).

Lưu ý: Điều này không liên quan đến ATT được giới thiệu trong iOS 14. 

Để trì hoãn việc khởi tạo SDK:

1. Ngăn không cho phiên được gửi trong quá trình chuyển đổi nền trước-nền sau. Trong một phương thức sendLaunch() (được gọi trên mọi applicationDidBecomeActive (theo phần 3.3), bao lệnh gọi đến start bằng việc kiểm tra điều kiện. Ví dụ:
   
   

   -(void)sendLaunch:(UIApplication *)application {
       if (consent_given) { // check the condition
           [[AppsFlyerLib shared] start]; // Start
       }
   }

2. Gửi phiên ngay khi lý do trì hoãn không còn phù hợp (ngay sau khi điều kiện thay đổi). Gọi start khi bạn sẵn sàng gửi dữ liệu phiên đầu tiên. Ví dụ:
   
   

   ...
   consent_given = YES; // change the condition
   [[AppsFlyerLib shared] start]; // Start
   ...

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 tùy chọn ghi dữ liệu SDK để bảo đảm tuân thủ pháp luật và quyền riêng tư. Có thể thực hiện được điều này bằng thuộc tính isStopped. 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.

[AppsFlyerLib shared].isStopped = true;

AppsFlyerLib.shared().isStopped = 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:

[AppsFlyer shared].anonymizeUser = YES;

AppsFlyerLib.shared().anonymizeUser = true

Chức năng ghi dữ liệu có thể được khởi động lại bằng cách đặt anonymizeUser thành false.

Sử dụng SDK chế độ nghiêm ngặt để xóa hoàn toàn chức năng thu thập IDFA và các phần phụ thuộc của khung AdSupport (ví dụ: khi phát triển ứng dụng cho trẻ em).

Lưu ý: IDFV vẫn có sẵn.

Trong Podfile của bạn, thay thế phần phụ thuộc AppsFlyerLib bằng:

pod 'AppsFlyerFramework/Strict','6.2.3'

Để vô hiệu hóa các khung AdSupport và iAd, SDK cung cấp các bộ thiết lập sau:

• disableCollectASA = true. Tìm hiểu thêm
• disableAdvertisingIdentifier = true. Tìm hiểu thêm

Để vô hiệu hóa các khung quảng cáo:

[AppsFlyerLib shared].disableCollectASA = YES
[AppsFlyerLib shared].disableAdvertisingIdentifier = YES;

AppsFlyerLib.shared().disableCollectASA = true
AppsFlyerLib.shared().disableAdvertisingIdentifier = true

Trong một số trường hợp, nhà quảng cáo có thể muốn ngừng chia sẻ dữ liệu cấp người dùng với các mạng/đối tác quảng cáo cho những người dùng cụ thể. Lý do cho điều này bao gồm: 

• Các chính sách bảo mật như CCPA hoặc GDPR
• Cơ chế chọn lựa không tham gia của người dùng
• Cạnh tranh với một số đối tác (mạng quảng cáo, bên thứ 3)

AppsFlyer cung cấp hai phương thức API để ngừng chia sẻ dữ liệu với một số hoặc tất cả các đối tác:

• setSharingFilter: Được nhà quảng cáo sử dụng để ngăn chặn việc chia sẻ dữ liệu với một số (một hoặc nhiều) mạng/đối tác tích hợp.
• setSharingFilterForAllPartners: Được các nhà quảng cáo sử dụng để ngăn chặn việc chia sẻ dữ liệu với tất cả các mạng lưới/đối tác tích hợp.

Các phương thức lọc này được hỗ trợ từ SDK V5.4.1.

Phương thức lọc phải được gọi mỗi khi SDK được khởi tạo và ảnh hưởng đến toàn phiên. Nếu cần thời gian để xác định xem bạn có cần đặt bộ lọc chia sẻ hay không, thì hãy trì hoãn quá trình khởi tạo SDK. 

Khi phương thức này được kích hoạt trước lệnh gọi start đầu tiên:

• Người dùng từ SRN được phân bổ là Tự nhiên và dữ liệu của họ không được chia sẻ với các đối tác tích hợp.
• Người dùng từ mạng quảng cáo lượt nhấp (không phải SRN) được phân bổ chính xác trên AppsFlyer, nhưng không được chia sẻ với mạng quảng cáo thông qua postback, API, báo cáo dữ liệu thô hoặc bằng bất kỳ phương thức nào khác.

Hiện tại, không thể lọc dữ liệu gỡ cài đặt bằng các phương thức này. Tuy nhiên, bạn có thể ngừng gửi sự kiện Gỡ cài đặt cho đối tác bằng cách sử dụng trang thiết lập trong AppsFlyer.