Bidang ID pengguna pelanggan/customer user ID field (CUID)

Sekilas: Referensi silang data internal Anda dengan data atribusi AppsFlyer menurut bidang ID pengguna Pelanggan (CUID/Customer User ID).

Menerapkan CUID

Bidang ID pengguna pelanggan (CUID) adalah pengenal pengguna unik yang ditetapkan oleh aplikasi dan pemilik situs web.

  • CUID dilaporkan oleh Anda ke AppsFlyer menggunakan API AppsFlyer atau SDK.
  • AppsFlyer mengisi bidang CUID dalam laporan data lengkap dengan tepat.
  • Gunakan CUID untuk melakukan referensi silang data atribusi Appsflyer dengan data Anda menggunakan CUID sebagai kunci.
  • Contoh: Seorang pengguna memiliki dua perangkat dengan CUID yang sama ("1234567"). Setiap kali mereka melakukan event di perangkat, ini dicatat menggunakan CUID. Hal ini memungkinkan pemasang iklan untuk menggabungkan data lengkap kedua perangkat menjadi tampilan pengguna yang menyeluruh.
  • CUID digunakan oleh Audiens AppsFlyer dan solusi Atribusi Berbasis Orang untuk meningkatkan keakuratan dan penargetan.

Desain dan privasi CUID

Tunda inisialisasi SDK hingga CUID disetel

Anda dapat menunda Inisialisasi SDK hingga CUID disetel. Selain logika bisnis Anda, pertimbangkan hal berikut sebelum melakukannya:

  • Pro:
    • Data atribusi selalu dikaitkan dengan CUID.
    • Gunakan CUID untuk mengaitkan data atribusi dengan data lain yang Anda miliki di sistem. 
    • Ini memungkinkan penggunaan dan pemrosesan yang lebih canggih dari data yang Anda dapatkan dari AppsFlyer.
  • Kontra:
    • Tindakan dan event yang dilakukan pengguna, termasuk pembelian dan berlangganan, tidak direkam di AppsFlyer hingga CUID disetel. Ini dapat menyebabkan perbedaan dan peningkatan risiko kecurangan.

Instruksi pengembang Android SDK

Cara mengatur ID Pengguna Pelanggan Anda:

public void setCustomerUserId(String id);

Contoh Penggunaan:

AppsFlyerLib.getInstance().setCustomerUserId("myId");

Kami menyarankan Anda untuk mengatur ID User Pelanggan di awal alur aplikasi, karena ini hanya terkait dengan event yang dilaporkan setelah ID diatur:

  • Jika setCustomerUserId dipanggil sebelum memanggil start, ID Pengguna Pelanggan muncul di laporan data lengkap untuk instalasi dan 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 Pengguna 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:

AppsFlyerProperties.getInstance().getString(AppsFlyerProperties.APP_USER_ID)
Penundaan inisialisasi SDK untuk customerUserID

Anda dapat menunda Inisialisasi SDK sampai customerUserID ditetapkan.

Untuk menunjukkan bahwa SDK harus menunda inisialisasi bagi ID User Pelanggan, panggil:

AppsFlyerLib.getInstance().waitForCustomerUserId(true);

segera sebelum metode init(). Bagian lain inisialisasi SDK tidak boleh berubah.

Setelah customerUserID disediakan, panggil

AppsFlyerLib.getInstance().setCustomerIdAndLogSession("customer_id", ini);

untuk memberikan SDK dengan id user pelanggan yang terkait dan memulai SDK.

Kode harus terlihat seperti berikut:

Java Kotlin
public class AFApplication extends Application {
  private static final String AF_DEV_KEY = "qrdZGj123456789";
 @Override
 public void onCreate() {
  super.onCreate();
    AppsFlyerConversionListener conversionDataListener = 
       new AppsFlyerConversionListener() {
      ...
    };
       AppsFlyerLib.getInstance().waitForCustomerUserId(true); 
    //WARNING! Removing above line doesn't cancel its effect.
    // Replace with this to stop waiting for CUID:
  // AppsFlyerLib.getInstance().waitForCustomerUserId(false);
    AppsFlyerLib.getInstance().init(AF_DEV_KEY, getConversionListener(), getApplicationContext());
    AppsFlyerLib.getInstance().start(this);
    // Do your magic to get the customerUserID
    // ...
    // any AppsFlyer SDK code invoked here will be discarded
   //Call the following API once the customerUserID is available:
 AppsFlyerLib.getInstance().setCustomerIdAndLogSession("customer_id", this);
  }
}

Petunjuk pengembang iOS SDK

Cara mengatur ID Pengguna Pelanggan Anda:

Objective-C Swift
[AppsFlyerLib dibagikan].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 start, ID Pengguna Pelanggan muncul di laporan data lengkap untuk instalasi dan 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 Pengguna 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:

Objective-C Swift
NSString *customerUserID = [AppsFlyerLib shared].customerUserID;
Penundaan inisialisasi SDK untuk customerUserID

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

Implementasikan kode berikut:

Objective-C Swift
- (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
    }
}

Atribusi Berbasis Orang

AppsFlyer People-based Attribution (Atribusi Berbasis Orang Appsflyer/PBA) memberi Anda perspektif yang luas mengenai dampak kampanye web dan seluler, serta kemampuan untuk menganalisis upaya Anda untuk mengalihkan pengguna web ke aplikasi seluler Anda dan sebaliknya.

Anda harus mengatur CUID yang sama baik di situs seluler dan web, untuk mengaktifkan wawasan dan analitik lintas platform. 

Apakah artikel ini membantu?