Memformat data pengguna

Data Manager API mendukung penguploadan 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 @.
    • Hapus tanda plus (+) dari bagian lokal dan hapus semua karakter yang mengikutinya.
    • Contoh: cloudy.sanfrancisco+shopping@gmail.com → cloudysanfrancisco@gmail.com
  • Jika alamat email memiliki domain selain gmail.com atau googlemail.com, jangan hapus titik atau tanda plus.
    • Contoh: user.name+NYC@Example.com → user.name+nyc@example.com
Spasi kosong Pangkas spasi kosong di awal, akhir, dan tengah.
Hashing 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 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 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 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 hash region_code.
postal_code
Format
string
Kode zip/pos AS dan internasional diizinkan.
Untuk alamat AS, gunakan 5 digit atau 5 digit diikuti dengan a 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 hash postal_code.

Persyaratan IpData

Objek IpData memiliki atribut berikut.

IpData
ip_address
Format
string
Alamat IPv4 atau IPv6.
Untuk alamat IPv6, huruf besar/kecil tidak masalah (dapat menggunakan huruf besar atau huruf kecil).
Spasi kosong Pangkas spasi kosong di awal dan akhir.
Hashing Jangan hash ip_address.

Persyaratan PairData

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

  1. Hash 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. Enkode data terenkripsi menggunakan encoding hex atau Base64.

Persyaratan MobileData

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

Format stempel waktu

Jika menggunakan format JSON untuk Timestamp kolom, seperti timestamp dan last_updated_timestamp dari Event, gunakan format RFC 3339. Berikut beberapa contoh waktu UTC pada 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 7 jam sebelum UTC pada saat itu: 2025-08-08T10:18:44.291-07:00
  • Zona waktu untuk Tokyo, Jepang, yang 9 jam lebih awal dari UTC dan tidak menggunakan 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 nilai seconds dan nanos untuk waktu UTC pada 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 masalah saat menggunakan encoding heksadesimal (hex).
  • Huruf besar/kecil pada output encoding penting saat menggunakan encoding Base64.
Sebelumnya
Mengonfigurasi tujuan dan header
Berikutnya
Enkripsi data pengguna