Integrasi SDK AppsFlyer - iOS

AppsFlyer Device ID dibuat untuk setiap instalasi aplikasi baru. Anda dapat memperolehnya dengan menggunakan kode berikut:

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

NSString *appsflyerId = [AppsFlyerTracker sharedTracker].getAppsFlyerUID;

Dengan mengatur ID pelanggan Anda sendiri, Anda dapat membandingkan ID pelanggan Anda dengan ID unik AppsFlyer dan ID perangkat lainnya. ID ini tersedia di laporan data lengkap AppsFlyer bersama dengan API Postback untuk memandingkan dengan ID internal Anda.

Cara mengatur ID Pengguna Pelanggan Anda:

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

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

Memperoleh ID Pengguna Pelanggan:

Untuk mendapat ID user pelanggan, ambil dari sharedTracker.

[AppsFlyerTracker sharedTracker].customerUserID

Untuk informasi lebih lanjut tentang Customer User ID, klik di sini.

AppsFlyer secara otomatis mengumpulkan IDFA (ID Untuk Pengiklan) dan IDFV (ID Untuk Vendor) jika AdSupport.framework dimuat di aplikasi.

Untuk pengukuran uninstall, aktifkan pemberitahuan pesan jarak jauh pada app Anda. Lihat Panduan Pemrograman Pemberitahuan Remote dari Apple untuk informasi lebih lanjut.

Ikuti petunjuk integrasi SDK iOS untuk menyelesaikan pengaturan fitur pengukuran uninstall.

Untuk mengaktifkan Pengukuran aplikasi dibuka dari push notification, tambahkan kode berikut ke delegasi aplikasi:

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

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

Pesan push harus memiliki parameter af dengan parameter atribusi AppsFlyer.

Contoh Pesan:

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

AppsFlyer memungkinkan Anda untuk mengatribusikan dan merekam install yang berasal dari promosi silang salah satu app Anda yang dimiliki user saat ini. Aplikasi promosi silang dapat menjadi faktor pertumbuhan utama dalam mendorong install tambahan untuk app Anda.

Untuk detail lebih lanjut, lihat artikel tentang Atribusi Promosi Silang, di sini.

SDK AppsFlyer dapat memberi informasipembelian in‐app dan memverifikasinya melalui server. Untuk mengukur penerimaan yang tervalidasi, Anda perlu memanggil metode validateAndTrackInAppPurchase di dalam callback  SKStoreKit:completeTransaction. Panggilan ini secara otomatis menghasilkan in‐app event af_purchase.

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

Panggilan ini memiliki dua blok callback, satu untuk ‘success’ dan satu lainnya untuk ‘failure’ (untuk alasan apa pun, termasuk kegagalan validasi). Saat panggilan berhasil, sebuah paket data dikembalikan beserta dengan data validasi penerimaan dari server Apple.  

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

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

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

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

Untuk melihat daftar kemungkinan nilai balik untuk validasi penerimaan, silakan baca dokumentasi Apple di sini.

AppsFlyer memberi Anda metode untuk menganonimkan identifier pengguna tertentu dari analisis AppsFlyer. Metode ini sesuai dengan persyaratan privasi terbaru dan sesuai kebijakan data dan privasi Facebook. Nilai defaultnya adalah NO, yang berarti penganoniman secara default tidak dilakukan.

Gunakan API ini saat inisialisasi SDK untuk menganonimkan instalasi,event dan sesi pengguna secara eksplisit:

AppsFlyerTracker.shared().deviceTrackingDisabled = true

[AppsFlyerTracker sharedTracker].deviceTrackingDisabled = YES;

Pengukuran dapat diulang dengan memanggil kembali deviceTrackingDisabled dan mengaturnya ke false.

Secara default, setidaknya ada jeda selama 5 detik antara 2 peluncuran app agar terhitung sebagai 2 sesi terpisah (lebih lanjut tentang menghitung sesi).

Namun, Anda dapat menggunakan API berikut untuk menentukan suatu nilai sebagai waktu minimum yang diperlukan antar-sesi:

AppsFlyerTracker.shared().minTimeBetweenSessions = <your_custom_time_in_seconds>

[AppsFlyerTracker sharedTracker].minTimeBetweenSessions = <your_custom_time_in_seconds>;

Ekstensi aplikasi ini memerlukan hak akses untuk menggunakan Internet:

1. Silakan buka file info.plist ekstensi aplikasi Anda
2. Pada NSExtension / NSExtensionAttributes atur bendera RequestsOpenAccess ke YES.

Tambahkan kode berikut ke UIViewController ekstensi aplikasi viewDidLoad:

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

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

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

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

Dalam beberapa kasus ekstrem, Anda mungkin diharuskan untuk mematikan semua fungsi SDK karena pemenuhan hukum dan privasi. Tindakan ini dapat dilakukan dengan isStopTracking API. Setelah API dipanggil, SDK kami tidak akan lagi berkomunikasi dengan server dan berhenti berfungsi.

Ada beberapa skenario berbeda untuk berhenti mengirim data user. Kami menyarankan anda untuk mengikuti instruksi yang sesuai dan relevan untuk app Anda.

AppsFlyerTracker.shared().isStopTracking = true

[AppsFlyerTracker sharedTracker].isStopTracking = true;

SDK AppsFlyer mengizinkan Anda untuk mengumpulkan Nama Perangkat untuk analisis internal Anda. Dalam aturan standar, fitur ini dinonaktifkan. Gunakan API berikut untuk mengaktifkan:

AppsFlyerTracker.shared().shouldCollectDeviceName = false

[AppsFlyerTracker sharedTracker].shouldCollectDeviceName = NO;

parameter setAdditionalData diperlukan untuk integrasi dengan beberapa platform partner eksternal di level SDK, termasuk Segment, Adobe, dan Urban Airship. Gunakan API ini hanya jika artikel integrasi platform secara khusus menyatakan bahwa API  setAdditionalData diperlukan.
Berikut ini adalah contoh kode untuk pengimplementasian setAdditionalData pada iOS menggunakan Objective-C atau Swift

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

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

Jika menggunakan OneLink yang mendukung Link App Android dan menggabungkan keduanya dengan Link Universal Pihak Ke-3, Anda dapat menggunakan setResolveDeepLinkURLs API untuk memberi tahu SDK AppsFlyer domain klik pemicu app yang harus diselesaikan oleh SDK, dan juga untuk mengekstrak OneLink yang mendasarinya. Cara ini akan memungkinkan Anda untuk mempertahankan tautan langsung dan atribusi sembari menggabungkan OneLink dengan Link Universal pihak ke-3. Anda harus memanggil API ini sebelum inisialisasi SDK.

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

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