Integrasi SDK iOS untuk programmer

SDK AppsFlyer menggunakan framework asli berikut:

AdSupport.framework

Framework ini diperlukan untuk mengumpulkan IDFA dari perangkat user.
Tanpa IDFA Anda tidak dapat mengatribusikan install ke Facebook Ads, Twitter, Google Ads, dan jaringan lainnya.

iAd.framework

Framework ini diperlukan untuk merekam dan mengukur performa Apple Search Ads pada app Anda

Catatan:Memulai versi SDK  4.8.11 , SDK secara otomatis menambahkan AdSupport.framework. iAd.framework ditambahkan secara otomatis dari SDK versi 4.10.0 ke atas.
Jika Anda menggunakan versi SDK sebelumnya, lihat instruksi berikut.

Jika Anda ingin menghapus framework ini dan menonaktifkan pengumpulan IDFA:

1. Untuk menonaktifkan pengumpukan IDFA, lihat petunjuk di sini.
2. Untuk menonaktifkan  iAd.framework, lihat petunjuk di sini.

Untuk menambahkan framework bantuan iklan:

1. Di proyek Xcode Anda, pilih target proyek Anda.
2. Pilih tab Umum untuk target Anda.
3. Perluas bagian Framework dan Pustaka Tertaut.
4. Klik + untuk menambahkan framework.
5. Telusuri AdSupport.framework
6. Pilih AdSupport.framework dari daftar.

Ulangi proses untuk iAd.framework.

AppsFlyer menggunakan kode pengembang untuk mengidentifikasi akun Anda. Kode pengembang bersifat wajib karena kode tersebut memungkinkan SDK untuk mengirimkan dan menerima data milik akun AppsFlyer Anda dengan aman.

Yang harus dilakukan:

1. Buka dashboard aplikasi Anda 
2. Di dashboard, di bagian Configuration klik App Settings
3. Salin kode pengembang Anda.

   

Untuk mendukung deeplinking, tambahkan kode berikut ke SceneDelegate untuk setiap tempat yang didukung oleh aplikasi Anda.

1. Mengimpor perpustakaan

#import <AppsFlyerLib/AppsFlyerTracker.h>

import AppsFlyerLib

2. Menambahkan implementasi

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

Sebelum Anda mulai menguji install, tambahkan perangkat ke whitelist yang akan digunakan untuk pengujian.

Install organic adalah install tanpa atribusi yang biasanya merupakan install langsung dari app store.

Untuk menyimulasikan install organic:

1. Pastikan Anda memiliki perangkat mobile yang terhubung ke komputer Anda
2. Di Xcode, buka terminal debug.
3. Dari Xcode Studio, instal aplikasi pada perangkat atau simulator.
4. Tunggu aplikasi diluncurkan.
5. Di terminal debug, cari nama program aplikasi Anda.

Anda akan melihat tampilan seperti berikut:

Kirim Track-App-Launch di log menunjukkan bahwa SDK melaporkan instalasi. Data ini berasal dari metode onConversionDataSuccess di app delegate. Cara mendapatkan data konversi dibahas nanti dalam panduan ini.

Catatan: Memulai SDK V5,  onConversionDataSuccess adalah nama metode untuk mendapatkan data konversi. Jika Anda menggunakan versi SDK yang lebih rendah dari 5.0.0, nama metodenya adalahonConversionDataReceived Kami sarankan agar Anda meng-upgrade ke SDK 5.0.0. Untuk mempelajari lebih lanjut, klik di sini.

Install organic sekarang akan muncul di halaman Overview dari dashboard aplikasi.

Jika Anda tidak melihat install di dashboard aplikasi, lihat panduan mengatasi masalah SDK kami.

Install non-organic adalah Install teratribusi yang biasanya mengikuti interaksi iklan. Anda dapat menyimulasikan install non-organic dengan menggunakan link atribusi.

Yang harus dilakukan:

1. Cari tahu apa nama ID itunes dari aplikasi Anda, mis. id123456789.
2. Pada URL di bawah ini, ganti <APP_ID> dengan ID itunes aplikasi Anda:
   

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

   Parameter pid menunjukkan nama media source. Parameter c menunjukkan nama kampanye.
3. Kirim URL ini ke perangkat (mis. via email atau WhatsApp).
4. Di perangkat, klik URL.
   • Jika aplikasi terdaftar di app store, Anda akan diarahkan ke app store. Jangan mengunduh aplikasi dari app store. Lanjutkan ke langkah 5.
   • Jika aplikasi tidak terdaftar di app store dan masih dalam pengembangan, layar menampilkan pesan bahwa aplikasi tersebut tidak tersedia di app store. Cukup lanjutkan ke langkah 5.
5. Di Xcode Studio, buka terminal debug.
6. Hubungkan perangkat ke komputer Anda menggunakan kabel USB.
7. Dari Xcode, instal aplikasi pada perangkat.
8. Di terminal debug, cari ID itunes aplikasi Anda.

Anda akan melihat tampilan seperti berikut:

Install non-organic sekarang akan muncul di halaman Overview dari dashboard aplikasi.

SDK berisi dua jenis konstanta yang mewakili informasi terkait in-app event.

• Nama event, konstanta ini dalam format AFEventEventName.
  Misalnya AFEventPurchase, AFEventAddToCart.
• Parameter event, konstanta ini dalam format AFParameterEventNamaParameter.
  Misalnya, AFEventParameterRevenue, AFEventParameterContentId.

Kami sangat merekomendasikan untuk menggunakan konstanta ini untuk alasan berikut:

• Penamaan standar memungkinkan AppsFlyer memetakan event secara otomatis ke SRN seperti Facebook, Google, Twitter, dan Snapchat.
• Kompatibilitas dengan versi lama - jika AppsFlyer memutuskan untuk mengubah nama event atau parameter event apa pun, implementasi Anda adalah kompatibel dengan versi lama.

Untuk menggunakan dua antarmuka ini, impor AppsFlyerTracker.h jika menggunakan Objective-C, atau AppsFlyerLib jika menggunakan Swift:

#import AppsFlyerTracker.h

import AppsFlyerLib

Berikut adalah daftar nama dan struktur event yang disarankan.

Anda dapat mengirimkan pendapatan dengan in-app event apa pun. Gunakan parameter event af_revenue (AFEventParameterRevenue) untuk menyertakan pendapatan dalam in-app event. Anda dapat mengisinya dengan nilai numerik, positif maupun negatif.

af_revenue adalah satu-satunya parameter event yang dihitung AppsFlyer sebagai pendapatan nyata pada data lengkap dan dashboard. Untuk detail lebih lanjut, klik di sini.

Saat mengirim event dengan pendapatan, perhatikan hal berikut:

• Jika Anda menetapkan kode mata uang (lihat contoh di bawah), kode tersebut harus berupa 3 karakter kode ISO 4217   (defaultnya adalah USD).
• Anda dapat menetapkan kode mata uang untuk semua event dengan mengatur properti berikut:
  • Objective-C: [AppsFlyerTracker sharedTracker].currencyCode = @"ZZZ";,
  • Swift: AppsFlyerTracker.shared().currencyCode = "ZZZ"
  Untuk mempelajari tentang pengaturan mata uang, tampilan, dan konversi mata uang, lihat panduan tentang mata uang pendapatan.
• Nilai pendapatan tidak boleh mengandung pemisah koma, simbol mata uang, atau teks. Misalnya, event pendapatan harus serupa dengan 1234.56.

Contoh : Event pembelian in-app event dengan pendapatan

[[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"
]);

Event pembelian di atas menghasilkan pendapatan sebesar $200, yang muncul sebagai pendapatan di dashboard.

Merekam Pendapatan Negatif

Mungkin ada situasi di mana Anda ingin mencatat pendapatan negatif.

Misalnya, pengguna menerima pengembalian dana atau membatalkan berlangganan.

[[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 AppsFlyer menyediakan verifikasi server untuk in-app purchases (pembelian dalam aplikasi). Untuk memvalidasi pembelian, gunakan validateAndTrackInAppPurchase.

Panggilan ini secara otomatis menghasilkan in-app event af_purchase, mengingat bahwa pembelian divalidasi.

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

Contoh penggunaan untuk memvalidasi pembelian:

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

AppsFlyerTracker.bagi (). GunakanReceiptValidationSandbox = true

Memvalidasi in-app purchase secara otomatis mengirimkan event in-app purchase ke AppsFlyer. Lihat data sampel berikut yang diteruskan dalam parameter 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
}

• Nama event: hingga 45 karakter
• Nilai event: tidak boleh melebihi 1000 karakter - jika lebih lama kami dapat memotongnya
• Harga dan pendapatan: gunakan hanya angka dan desimal, mis. 5 atau 5,2
• Nilai harga dan pendapatan dapat memiliki hingga 5 digit setelah koma, mis. 5,12345
• Karakter non-Inggris didukung, dalam event in-app,  API SDK lainnya, mulai dari Android SDK V4.8.1.

Anda dapat mencatat in-app event dengan memanggil trackEvent dengan nama event dan parameter nilai. Lihat dokumentasi In-App Event untuk detail lebih lanjut.

Di bawah ini adalah contoh sederhana tentang cara mencatat event pembelian. Untuk daftar komprehensif cuplikan kode per vertikal yang siap pakai, lihat panduan kami terkait rich in-app event per vertikal.

Contoh: Event pembelian in-app

[[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"]);

Jika pengguna menginisiasi event (aktivitas) saat koneksi internet tidak tersedia, AppsFlyer tetap dapat merekamnya. Ini cara kerjanya:

1. SDK mengirimkan event ke server AppsFlyer dan menunggu respon.
2. Jika SDK tidak mendapatkan kode status respons 200, event disimpan dalam cache.
3. Setelah kode status respons 200 berikutnya diterima, event tersimpan dikirim kembali ke server.
4. Jika ada beberapa event dalam cache, event tersebut dikirim ke server satu per satu.

• Event in-app berhasil direkam.
• Terjadi kesalahan saat merekam event in-app.

 [[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 mendeteksi tipe perangkat saat klik dan mengarahkan user ke tujuan yang sesuai, mis. Google Play, iOS app store, market di luar store, atau halaman web.

Panduan pengarahan OneLink membahas penerapan link atribusi multi-platform (tidak memerlukan pengodean SDK). Ini juga merupakan dasar untuk deep linking.

Deep linking memungkinkan Anda mengirim user ke aktivitas tertentu dan menyajikan konten yang disesuaikan untuk mereka. Hal ini sangat bermanfaat ketika menjalankan kampanye penargetan ulang.

Untuk mengatur deep linking dengan Onelink, marketer dengan akses ke dashboard AppsFlyer dan programmer dengan akses ke aplikasi harus bekerja sama.

Lihat panduan kami tentang pengaturan deep linking dengan OneLink.

Penautan langsung tertunda memungkinkan Anda untuk menautkan langsung pengguna baru dan memberikan mereka konten yang disesuaikan saat pertama kali membuka aplikasi. Ini tidak seperti penautan langsung biasa di mana aplikasi harus sudah ter-install di perangkat user.

Untuk mengatur deep linking tertunda dengan OneLink, programmer juga perlu akses ke dashboard AppsFlyer.

Pengaturan untuk deep linking tertunda sama dengan deep linking. Satu-satunya perbedaan adalah bahwa Anda perlu mengimplementasikan logika tambahan di aplikasi untuk melakukan deep linking user dan menyajikan konten yang disesuaikansetelah mereka meng-install dan meluncurkan aplikasi.

Lihat panduan kami tentang deep linking tertunda untuk mempelajari lebih lanjut.

SDK memberi Anda data konversi atau interaksi untuk setiap event install atau deep linking. Anda dapat menggunakan data ini untuk menyesuaikan konten dan perilaku aplikasi secara terprogram.

Untuk mendapatkan data deeplinking, implementasikan metode onAppOpenAttribution .

Lihat panduan kami tentang data deep linking untuk mempelajari lebih lanjut.

Untuk mempelajari cara mengatur pengukuran uninstall, baca di sini .

Jika Anda ingin menerima konfirmasi bahwa permintaan pelacakan berhasil diterima oleh server AppsFlyer, implementasikan penangan trackAppLaunchWithCompletionHandler . Kemudian Anda dapat menerapkan logika untuk menangani keberhasilan atau kegagalan pelacakan peluncuran aplikasi.

Contoh Implementasi

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

Diperlukan API setAdditionalData untuk berintegrasi pada level SDK dengan beberapa platform mitra eksternal, termasuk Segment, Adobe and Urban Airship.
Gunakan API ini hanya jika artikel integrasi platform secara spesifik menyatakan bahwa API setAdditionalData diperlukan.

Contoh kode setAdditionalData:

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

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

Gunakan API berikut untuk mengatur waktu minimum antara sesi:

[AppsFlyerTracker sharedTracker].minTimeBetweenSessions = <your_custom_time_in_seconds>;

AppsFlyerTracker.shared().minTimeBetweenSessions = <your_custom_time_in_seconds>

Mengatur nilai tinggi ke waktu kustom antara peluncuran dapat berdampak buruk pada API yang bergantung pada data sesi, seperti deep linking.

Tidak tersedia di iOS. 

Beberapa layanan pihak ke-3 seperti penyedia layanan email menggabungkan link di dalam email dengan domain pencatatan klik mereka sendiri. Beberapa bahkan memungkinkan Anda untuk mengatur domain pencatatan klik Anda sendiri. Jika OneLink digabungkan dalam domain seperti itu, fungsinya mungkin terbatas.

Untuk mengatasi masalah ini, Anda dapat menggunakan API setResolveDeepLinkURLs. Gunakan API ini untuk mendapatkan OneLink dari domain klik yang meluncurkan aplikasi.  Anda harus memanggil API ini sebelum inisialisasi SDK.

Misalnya, Anda memiliki tiga domain klik yang mengarahkan ke OneLink Anda yaitu https://mysubdomain.onelink.me/abCD. Gunakan API ini untuk mendapatkan OneLink yang digunakan domain klik Anda untuk mengarahkan ulang ke tujuan. Metode API ini menerima daftar domain yang diperbarui SDK.

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

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

Kode di atas memungkinkan Anda untuk menggunakan domain klik sembari mempertahankan fungsi OneLink. Domain klik bertanggung jawab untuk meluncurkan aplikasi. API, pada gilirannya, akan mendapatkan OneLink dari domain klik ini, lalu Anda dapat menggunakan data dari OneLink ini untuk deep linking dan menyesuaikan konten user.

Dengan AppsFlyer, Anda dapat merekam pemberitahuan otomatis sebagai bagian dari kampanye penargetan ulang.

Untuk mengaktifkan fitur ini, panggil metode handlePushNotificationData di dalam 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)
}

Untuk informasi lebih lanjut tentang pengukuran push notification, baca di sini.

Mengizinkan user yang ada untuk mengundang teman dan kontak mereka sebagai user baru bagi aplikasi Anda akan menjadi faktor pertumbuhan utama untuk aplikasi Anda. Dengan AppsFlyer, Anda dapat mengatribusi dan mencatat install yang berasal dari undangan user dalam aplikasi Anda.

Untuk detail lebih lanjut, lihat artikel Atribusi Undangan User.

ID unik AppsFlyer dibuat untuk setiap instalasi aplikasi baru. Anda dapat menggunakan ID ini untuk berbagai keperluan:

• Mengirim in-app event server ke server .
• Cocokkan dengan catatan pengguna di sistem back end Anda.
• Memetakan entri saat menggabungkan data dari pull dan push API.

Gunakan API berikut untuk mendapatkan ID Unik AppsFlyer:

NSString *appsflyerId = [AppsFlyerTracker sharedTracker].getAppsFlyerUID;

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

Cara mengatur ID Pengguna Pelanggan Anda:

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

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

Di iOS, ID Pengguna Pelanggan harus diatur dalam setiap peluncuran aplikasi. Kami menyarankan Anda untuk mengatur ID Pengguna Pelanggan di awal alur kerja aplikasi, karena ini hanya terkait dengan event yang dilaporkan setelah ID diatur:

• Jika setCustomerUserId dipanggil sebelum memanggil startTracking , ID User Pelanggan akan muncul di laporan data lengkap untuk instalasi dan untuk event.
• Jika diatur setelahnya, ID User Pelanggan hanya dikaitkan dengan event yang dicatat setelah menetapkan ID User Pelanggan.

Memperoleh ID Pengguna Pelanggan:

Untuk menghindari pengaturan nilai ID User Pelanggan lagi di luar peluncuran pertama, dan untuk mengurangi panggilan ke server Anda untuk mendapatkan ID user pelanggan, Anda dapat memeriksa apakah nilainya kosong atau tidak dengan menggunakan:

NSString *customerUserID = [AppsFlyerTracker sharedTracker].customerUserID;

let customerUserID = AppsFlyerTracker.shared().customerUserID

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

Penundaan inisialisasi SDK untuk customerUserID

Anda dapat menunda Inisialisasi SDK sampai ID Pengguna Pelanggan ditetapkan. Ini berguna jika Anda menganggap bahwa instalasi dan data event berisi ID pengguna pelanggan Anda itu penting bagi Anda.

Implementasikan kode berikut:

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

Untuk mempelajari lebih lanjut tentang menunda inisialisasi SDK sampai ID User Pelanggan tersedia, buka di sini .

Dalam beberapa kasus ekstrem, Anda mungkin diwajibkan untuk menonaktifkan semua pelacakan SDK guna mematuhi hukum dan privasi. Ini bisa dilakukan dengan properti isStopTracking . Setelah properti ini diatur ke true, SDK berhenti berfungsi dan tidak lagi berkomunikasi dengan server AppsFlyer.

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

[AppsFlyerTracker sharedTracker].isStopTracking = true;

AppsFlyerTracker.shared().isStopTracking = true

SDK dapat diaktifkan kembali dengan memanggil API yang sama dalam event apa pun, tetapi dengan nilai false.

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

[AppsFlyerTracker sharedTracker].deviceTrackingDisabled = YES;

AppsFlyerTracker.shared().deviceTrackingDisabled = true

Pelacakan dapat dimulai kembali dengan mengatur deviceTrackingDisabled ke false.