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.

• UserData: Data yang diberikan pengguna seperti alamat email atau nomor telepon.
• IpData: Data IP seperti alamat IP dan stempel waktu terkait.
• PairData: ID Rekonsiliasi Identitas Pengiklan Penayang (PAIR).
• MobileData: Data yang mengidentifikasi perangkat seluler.

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 Hapus spasi kosong di awal, akhir, dan tengah. Hashing Lakukan hashing 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 angka. Misalnya, nomor telepon AS [phone] harus diformat dan dinormalisasi menjadi [phone]. Spasi kosong Hapus spasi kosong di awal dan akhir. Hashing Lakukan hashing menggunakan algoritma SHA-256. Enkode byte hash menggunakan encoding hex atau Base64.
address	AddressInfo objek 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 Hapus spasi kosong di awal dan akhir. Hashing Lakukan hashing 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 Hapus spasi kosong di awal dan akhir. Hashing Lakukan hashing 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 Hapus spasi kosong di awal dan akhir. Hashing Jangan lakukan hashing pada region_code.
postal_code	Format string Kode zip/pos AS dan internasional diizinkan. Untuk alamat di AS, gunakan 5 digit atau 5 digit diikuti dengan ekstensi 4 digit. Menggunakan ekstensi 4 digit dapat meningkatkan tingkat kecocokan. Untuk semua negara lainnya, jangan gunakan ekstensi kode pos. Spasi kosong Hapus spasi kosong di awal dan akhir. Hashing Jangan lakukan hashing pada 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 berpengaruh (huruf besar atau huruf kecil dapat digunakan). Spasi kosong Hapus spasi kosong di awal dan akhir. Hashing Jangan lakukan hashing pada ip_address.

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 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 lakukan hashing pada 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 berpengaruh saat menggunakan encoding heksadesimal (hex).
• Huruf besar/kecil pada output encoding berpengaruh saat menggunakan encoding Base64.