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
- AppsFlyer menghargai dan menghormati privasi Anda dan pengguna Anda.
- Kami tidak mengizinkan pengumpulan atau pengiriman informasi pribadi secara langsung ke platform AppsFlyer.
- Untuk memastikan privasi pengguna Anda, rancanglah CUID tanpa informasi yang secara langsung mengidentifikasi pengguna. Misalnya, CUID tidak boleh berisi alamat email pengguna, nama, nomor telepon, nomor jaminan sosial, dll.
- Bacaan terkait: Praktik terbaik Google untuk menghindari pengiriman PII (Informasi Pribadi)
Tunda SDK start hingga CUID disetel
Anda dapat menunda SDK start 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. Hal ini dapat menyebabkan perbedaan, dan dapat memengaruhi deteksi penipuan (yang belum tentu dapat diidentifikasi sebelum inisialisasi SDK).
Catatan : Jika SDK start ditunda hingga ada CUID, dan tidak ada CUID yang disetel, SDK tidak melaporkan data apa pun (termasuk penginstalan).
Mengatur CUID
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 memanggilstart
, 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.
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:
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);
}
}
class AFApplication: Application() {
private val afDevKey = ""
override fun onCreate() {
super.onCreate()
val conversionDataListener = object: 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(afDevKey, conversionDataListener, this)
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:
[AppsFlyerLib dibagikan].customerUserID = @"my user id";
AppsFlyerLib.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 memanggilstart
, 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.
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:
NSString *customerUserID = [AppsFlyerLib shared].customerUserID;
let customerUserID = AppsFlyerLib.shared().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:
- (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
}
}
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 mengarahkan 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.