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

Direkomendasikan untuk
Pemasar Pengembang
Tanggal terakhir diupdate:

Sekilas: CUID memungkinkan Anda untuk mengelompokkan event dari pengguna yang sama di berbagai perangkat, sumber media, atau kanal.

Apa itu CUID?

ID Pengguna Pelanggan (CUID) adalah pengidentifikasi pengguna unik. Biasanya dibuat dan disetel oleh pemilik aplikasi pada saat pendaftaran pengguna. CUID memungkinkan pemilik aplikasi mengikuti perjalanan pengguna di berbagai perangkat.

Contoh

Pengguna dengan dua perangkat atau lebih memiliki CUID yang sama dalam aplikasi. Setiap kali pengguna melakukan event di perangkat seluler atau desktop, acara tersebut direkam bersama dengan CUID. Hal ini memungkinkan pemasang iklan untuk menggabungkan data perangkat menjadi tampilan pengguna yang holistik.

Beberapa kasus penggunaan:

  • Pembelian dalam aplikasi yang dilakukan oleh pengguna yang sama di aplikasi yang sama tetapi di beberapa perangkat (ponsel, tablet, TV, desktop) dapat digabungkan dalam satu tampilan.
  • Performa pengguna dalam game yang diinstal di berbagai platform (desktop, seluler, TV) dapat dibagikan di seluruh platform ini untuk mencapai pengalaman pengguna yang holistik.

Mengatur CUID

Direkomendasikan untuk menyetel CUID sedini mungkin dalam alur inisialisasi SDK sehingga sebanyak mungkin event mendapatkan asosiasi CUID.

Menyetel CUID di Android

Setelah CUID tersedia, Anda dapat mengaturnya dengan memanggil setCustomerUserID. CUID hanya dapat dikaitkan dengan in-app event yang terjadi setelah ditetapkan. Oleh karena itu, event penginstalan tidak akan dikaitkan dengan CUID saat start dipanggil sebelum setCustomerUserID.

Kaitkan CUID dengan acara penginstalan

Jika penting bagi Anda untuk mengaitkan event penginstalan ke CUID, Anda harus menyetelnya sebelum menghubungi start.

Penting: Ingatlah bahwa menyetel CUID sebelum start dapat memblokir SDK dari mengirim event penginstalan dan dengan demikian mencegah terjadinya atribusi. Hal ini dapat terjadi, misalnya, saat pengguna meluncurkan aplikasi untuk pertama kalinya lalu keluar sebelum SDK dapat menyetel CUID.

Di Android, metode start dan penyiapan CUID dapat dijalankan dari kelas Aplikasi global atau kelas Activitas , bergantung pada implementasi aplikasi. Untuk informasi selengkapnya, lihat Pilih di kelas mana untuk memulai SDK.

Jika SDK dimulai di kelas Aplikasi

Jika Anda ingin mengaitkan CUID dengan  event penginstalan saat memulai dari kelas Aplikasi global, pastikan untuk menunda pengiriman event penginstalan menggunakan metode waitForCustomerUserId . Metode ini menempatkan SDK pada mode menunggu hingga CUID disetel.

Catatan:  Jika karena alasan tertentu pengaturan CUID gagal, SDK akan tetap dalam mode menunggu dan tidak mengirimkan event apa pun.

Jika SDK dimulai di kelas Aktivitas

Jika Anda ingin mengaitkan CUID dengan  event penginstalan saat memulai dari kelas Aktivitas , Anda tidak perlu menunda pengiriman event penginstalan. Cukup hubungi setCustomerUserId sebelum memanggil start.

INSTRUKSI PENGEMBANG

Beri tahu programmer tentang hal berikut ini:

  • Gunakan waitForCustomerUserId jika SDK dimulai di kelas Aplikasi global
  • Tautan programmer:
    • Jika Anda ingin mengaitkan CUID dengan event penginstalan, lihat di sini.

Menyetel CUID di iOS

Gunakan metode customerUserId untuk mengatur CUID. Lokasi  customerUserId  dalam kaitannya dengan metode start menentukan event apa yang dapat dikaitkan dengan CUID.

  • Jika customerUserId dipanggil sebelum memanggil mulai, CUID dikaitkan dengan penginstalan dan in-app event berikut ini
  • Jika dipanggil setelah  start (mulai), CUID hanya dikaitkan dengan event yang dicatat setelah penyetelan CUID.

INSTRUKSI PENGEMBANG

Rujuk programmer ke tautan berikut:

CUID dan privasi

AppsFlyer menghargai dan menghormati privasi pengguna Anda dan tidak mengizinkan pengumpulan atau transfer data pribadi sensitif ke platform AppsFlyer.

Untuk mengamankan privasi pengguna Anda, tidak diperbolehkan merancang CUID dengan informasi yang mengidentifikasi pengguna secara langsung. Ini termasuk nomor jaminan sosial atau nomor identifikasi nasional.

Selain itu, jika CUID yang diatur berisi alamat email atau nomor telepon pengguna,  informasi tersebut harus selalu di-hash saat dikirim ke AppsFlyer. Dilarang mengirimkan CUID yang berisi data pribadi tanpa hash ke AppsFlyer.

Bacaan lebih lanjut

Lihat Laporan perjalanan pengguna untuk mempelajari lebih lanjut tentang CUID dalam laporan data lengkap.