Mengupload data pelanggan yang dikumpulkan untuk membuat audiens Customer Match. Data ini bersifat sensitif. Anda harus mempersiapkannya dengan benar sebelum mengupload.
Memformat data
Format data mentah Anda dengan melakukan hal berikut:
- Hapus spasi kosong dari nilai nama depan, nama belakang, dan alamat email.
- Gunakan huruf kecil untuk semua nilai string.
- Format nilai nomor telepon menggunakan format E.164. Sertakan kode negara.
Data hash
Lakukan hashing pada nilai data mentah dari jenis berikut menggunakan algoritma SHA256:
- Nama depan
- Nama belakang
- Alamat email
- Nomor telepon
Menetapkan data
Data yang Anda gunakan menentukan jenis audiens. Selain itu, API ini juga menentukan objek API yang digunakan untuk meneruskan data.
Informasi kontak
Jika Anda menggunakan informasi kontak untuk mencocokkan pengguna:
- Gunakan jenis audiens
CUSTOMER_MATCH_CONTACT_INFO. - Teruskan data dalam objek
ContactInfo.
Pemilihan data yang diberikan untuk pelanggan menentukan metode yang digunakan untuk mencocokkannya:
| Metode pencocokan | |
|---|---|
| Pencocokan alamat email | Setidaknya satu nilai ditetapkan ke kolom hashedEmails. |
| Pencocokan nomor telepon | Setidaknya satu nilai ditetapkan ke kolom hashedPhoneNumbers. |
| Pencocokan alamat surat | Nilai yang ditetapkan ke kolom hashedFirstName, hashedLastName, zipCodes, dan countryCode. |
| Pencocokan gabungan alamat email, alamat surat, dan telepon | Nilai yang ditetapkan ke kolom hashedEmails, hashedPhoneNumbers, hashedFirstName, hashedLastName, zipCodes, dan countryCode. |
Sertakan semua objek ContactInfo untuk satu upload dalam objek
ContactInfoList.
ID Perangkat seluler
Jika Anda menggunakan ID perangkat seluler untuk mencocokkan pengguna:
- Gunakan jenis audiens
CUSTOMER_MATCH_DEVICE_ID. - Teruskan data menggunakan string ID perangkat seluler.
Sertakan semua ID perangkat seluler untuk satu upload dalam objek
MobileDeviceIdList.
Menetapkan izin pengguna
Tetapkan kolom consent di objek data yang relevan untuk meneruskan sinyal izin yang diberikan oleh pengguna yang disertakan.
Menetapkan salah satu kolom dalam objek Consent ke
CONSENT_STATUS_DENIED akan menampilkan error.
Sinyal izin berlaku untuk semua pengguna dalam permintaan. Gunakan permintaan terpisah untuk mengupload pengguna dengan sinyal izin yang berbeda.