Memformat data pengguna

Data Manager API mendukung upload beberapa jenis data pengguna. Ikuti persyaratan format, hashing, dan encoding untuk setiap elemen data guna memastikan data Anda berhasil diterima dan diproses.

Persyaratan UserData

Objek UserData adalah kumpulan objek UserIdentifier. Setiap UserIdentifier memiliki tepat satu atribut dalam tabel berikut.

UserIdentifier
email_address
Format
string
Konversi ke huruf kecil.
Spasi kosongMemangkas spasi kosong di awal, akhir, dan menengah.
HashingHash menggunakan algoritma SHA-256. Lakukan enkode byte hash menggunakan encoding hex atau Base64.
phone_number
Format
string
Gunakan format E.164.
Sertakan tanda plus (+) dan kode negara.
Spasi kosongMemangkas spasi kosong di awal dan di akhir.
HashingHash menggunakan algoritma SHA-256. Lakukan enkode byte hash menggunakan encoding hex atau Base64.
address

Format AddressInfo

Gunakan panduan pemformatan berikut untuk membuat atribut address dari UserIdentifier.

AddressInfo
given_name
Format
string
Konversi ke huruf kecil.
Jangan sertakan awalan seperti Mrs.
Spasi kosongMemangkas spasi kosong di awal dan di akhir.
HashingHash menggunakan algoritma SHA-256. Lakukan enkode byte hash menggunakan encoding hex atau Base64.
family_name
Format
string
Konversi ke huruf kecil.
Jangan sertakan akhiran seperti Jr.
Spasi kosongMemangkas spasi kosong di awal dan di akhir.
HashingHash menggunakan algoritma SHA-256. Lakukan enkode byte hash menggunakan encoding hex atau Base64.
region_code
Format
string
Kode ISO-3166-1 alpha-2 yang terdiri dari dua karakter.
Spasi kosongMemangkas spasi kosong di awal dan di akhir.
HashingJangan melakukan hashing pada region_code.
postal_code
Format
string
Kode pos AS dan internasional diizinkan.
Untuk alamat di AS, gunakan 5 digit atau 5 digit yang diikuti dengan ekstensi 4 digit. Menggunakan ekstensi 4 digit dapat meningkatkan tingkat kecocokan.
Untuk semua negara lainnya, jangan gunakan ekstensi kode pos.
Spasi kosongMemangkas spasi kosong di awal dan di akhir.
HashingJangan melakukan hashing pada postal_code.

Persyaratan PairData

Isi kolom pair_ids objek PairData dengan daftar ID. Format setiap elemen dalam daftar menggunakan langkah-langkah berikut:

  1. Lakukan hashing pada data PII yang disediakan cleanroom menggunakan algoritma SHA-256.
  2. Enkripsi byte hash dengan cipher komutatif EC menggunakan kunci penayang untuk daftar pengguna PAIR.
  3. Lakukan encoding data terenkripsi menggunakan encoding hex atau Base64.

Persyaratan MobileData

Isi kolom mobile_ids objek MobileData dengan daftar ID seluler. Jangan melakukan hashing pada ID seluler.

Langkah berikutnya