Memformat data pengguna

Data Manager API mendukung upload beberapa jenis data pengguna. Ikuti persyaratan pemformatan, hashing, dan encoding untuk setiap elemen data agar data Anda diterima dan diproses dengan berhasil.

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.
Jika alamat email memiliki domain gmail.com atau googlemail.com, hapus semua titik (.) sebelum simbol @.
Spasi kosong Memangkas spasi kosong di awal, akhir, dan di antara kata.
Hashing Beri hash menggunakan algoritma SHA-256. Enkode byte hash menggunakan encoding hex atau Base64.
phone_number
Format
string
Gunakan format E.164.
Sertakan tanda plus (+) dan kode negara. Semua karakter setelah tanda plus harus berupa digit.
Misalnya, nomor telepon AS (800)555-0100 harus diformat dan dinormalisasi menjadi +18005550100.
Spasi kosong Pangkas spasi kosong di awal dan akhir.
Hashing Beri hash menggunakan algoritma SHA-256. Enkode byte hash menggunakan encoding hex atau Base64.
address
Lihat spesifikasi format AddressInfo.

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 kosong Pangkas spasi kosong di awal dan akhir.
Hashing Beri hash menggunakan algoritma SHA-256. Enkode byte hash menggunakan encoding hex atau Base64.
family_name
Format
string
Konversi ke huruf kecil.
Jangan sertakan akhiran seperti Jr.
Spasi kosong Pangkas spasi kosong di awal dan akhir.
Hashing Beri hash menggunakan algoritma SHA-256. Enkode byte hash menggunakan encoding hex atau Base64.
region_code
Format
string
Kode ISO-3166-1 alpha-2 dua karakter.
Spasi kosong Pangkas spasi kosong di awal dan akhir.
Hashing Jangan buat hash region_code.
postal_code
Format
string
Kode pos AS dan internasional diizinkan.
Untuk alamat AS, gunakan 5 digit atau 5 digit yang diikuti dengan ekstensi 4 digit. Menggunakan ekstensi 4 digit dapat meningkatkan tingkat kecocokan Anda.
Untuk semua negara lainnya, jangan gunakan ekstensi kode pos.
Spasi kosong Pangkas spasi kosong di awal dan akhir.
Hashing Jangan buat hash postal_code.

Persyaratan PairData

Isi kolom pair_ids dari 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 sandi komutatif EC menggunakan kunci penayang untuk daftar pengguna PAIR.
  3. Enkode data terenkripsi menggunakan encoding hex atau Base64.

Persyaratan MobileData

Isi kolom mobile_ids objek MobileData dengan daftar ID seluler. Jangan hash ID seluler.

Format stempel waktu

Jika menggunakan format JSON untuk kolom Timestamp, seperti timestamp dan last_updated_timestamp dari Event, gunakan format RFC 3339. Berikut beberapa contoh waktu UTC 8 Agustus 2025 pukul 17.18.44.291 dalam format RFC 3339 dan zona waktu yang berbeda:

  • Zona waktu UTC: 2025-08-08T17:18:44.291Z
  • Zona waktu EDT, yang 4 jam sebelum UTC pada saat itu: 2025-08-08T13:18:44.291-04:00
  • Zona waktu PDT, yang saat itu 7 jam sebelum UTC: 2025-08-08T10:18:44.291-07:00
  • Zona waktu untuk Tokyo, Jepang, yang 9 jam lebih awal dari UTC dan tidak menerapkan waktu musim panas: 2025-08-08T22:18:44.291+09:00

Jika menggunakan format buffer protokol, tetapkan seconds dan, secara opsional, nanos saat membuat Timestamp. Berikut adalah nilai seconds dan nanos untuk waktu UTC 8 Agustus 2025 pukul 17.18.44.291:

  • seconds: 1754683124
  • nanos: 291000000

Encoding

Perhatikan hal-hal berikut saat mengenkode data:

  • Huruf besar/kecil pada output encoding tidak menjadi masalah saat menggunakan encoding heksadesimal (hex).
  • Huruf besar/kecil pada output encoding penting saat menggunakan encoding Base64.

Langkah berikutnya