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

AppsFlyer memungkinkan Anda untuk melaporkan satu atau lebih alamat email pengguna, jika Anda mengumpulkan data tersebut di dalam aplikasi Anda. Nilai email dapat dienkripsikan dengan menggunakan metode enkripsi berikut: Sha1, MD5, dan plain.

Contoh: Mengumpulkan Email Pengguna

AppsFlyerTracker.shared().setUserEmails( ["email1@domain.com", "email2@domain.com"], dengan: EmailCryptTypeSHA1)

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

Untuk Melacak Pelepasan Instalasi, aktifkan remote push notification di aplikasi Anda. Lihat Panduan Pemrograman Pemberitahuan Remote dari Apple untuk informasi lebih lanjut.

Ikuti instruksi integrasi SDK iOS untuk menyelesaikan pengaturan fitur pelepasan instalasi.

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];
    }

Push Notification harus memiliki parameter af dengan parameter pelacakan 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 mengukur dan mengatribusi instalasi yang berasal dari promosi silang antar aplikasi Anda dari dalam aplikasi yang saat ini dimiliki oleh pengguna.  Aplikasi promosi silang dapat menjadi faktor pertumbuhan utama dalam mendorong instalasi tambahan untuk aplikasi Anda.

Untuk informasi lebih lanjut, lihat artikel Pelacakan Promosi Silang, di sini.

AppsFlyer’s SDK can provide in‐app purchase server verification. To set receipt validation tracking you need to call the validateAndTrackInAppPurchase method inside the SKStoreKit’s completeTransaction: callback. This call automatically generates an af_purchase in‐app event.

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

This call has two callback blocks, one for ‘success’ and one for ‘failure’ (for any reason, including validation fail). On success, a dictionary is returned with the receipt validation data provided by Apple’s servers.  

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

[[AppsFlyerTracker sharedTracker] validateAndTrackInAppPurchase:product.productIdentifier price:product.price.stringValue
currency:@"USD"
transactionId:trans.transactionIdentifier
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);
}];

AppsFlyerTracker.shared().validateAndTrack(inAppPurchase:  product.productIdentifier, price: "\(product.price)", currency:  product.priceLocale.currencyCode, transactionId:  trans.transactionIdentifier, additionalParameters: nil,success:{(result) in
   print("Purchase succeeded And verified!!! response \(result)")
   },failure:{(error,message) in
   print("response = \(message)")
   })

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

AppsFlyer provides you with a method to annonymize specific user identifiers in AppsFlyer analytics. This method complies with the latest privacy requirements and complies with Facebook data and privacy policies. Default is NO, meaning no anonymization is performed by default.

Use this API during the SDK Initialization to explicitly anonymize a user's installs, events and sessions:

AppsFlyerTracker.shared().deviceTrackingDisabled = true

[AppsFlyerTracker sharedTracker].deviceTrackingDisabled = YES;

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

Agar AppsFlyer menghitung dua sesi yang berbeda, waktu default antara sesi minimalnya 5 detik. Sesi dimulai ketika pengguna membuka aplikasi. Gunakan API berikut jika Anda ingin mengonfigurasi waktu yang berbeda antara 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];
    }

In some extreme cases you might want to shut down all SDK tracking due to legal and privacy compliance. This can be achieved with the isStopTracking API. Once this API is invoked, our SDK will no longer communicate with our servers and stop functioning.

AppsFlyerTracker.shared().isStopTracking = true

[AppsFlyerTracker sharedTracker].isStopTracking = true;

AppsFlyer SDK allows you to collect Device Name for your internal analysis. By default, this capability is turned off. To turn it on use the following API:

AppsFlyerTracker.shared().shouldCollectDeviceName = false`

[AppsFlyerTracker sharedTracker].shouldCollectDeviceName = NO;

The setAdditionalData API is required to integrate on the SDK level with several external partner platforms, including Segment, Adobe and Urban Airship. Use this API only if the integration article of the platform specifically states setAdditionalData API is needed.
The following is a code example for implementing setAdditionalData on iOS for Objective-C or 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