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 berhasil diterima dan diproses.

• UserData: Data yang disediakan pengguna seperti alamat email atau nomor telepon.

• IpData: Data IP seperti alamat IP dan stempel waktu terkait.

• PairData: ID Publisher Advertiser Identity Reconciliation (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 menjadi 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: [e-mail] → [e-mail] Jika alamat email memiliki domain selain gmail.com atau googlemail.com, jangan hapus titik atau tanda plus. Contoh: [e-mail] → [e-mail] Spasi kosong Memangkas spasi kosong di awal, akhir, dan di antara karakter. Hashing Lakukan hashing menggunakan algoritma SHA-256 dan enkode byte hash.
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 Memangkas spasi kosong di awal dan akhir. Hashing Lakukan hashing menggunakan algoritma SHA-256 dan enkode byte hash.
address	Objek AddressInfo Lihat spesifikasi pemformatan AddressInfo.

Format AddressInfo

Gunakan panduan pemformatan berikut untuk membuat atribut address dari UserIdentifier.

AddressInfo
given_name	Format string Konversi menjadi huruf kecil. Jangan sertakan awalan seperti Mrs. Spasi kosong Memangkas spasi kosong di awal dan akhir. Hashing Lakukan hashing menggunakan algoritma SHA-256 dan enkode byte hash.
family_name	Format string Konversi menjadi huruf kecil. Jangan sertakan akhiran seperti Jr. Spasi kosong Memangkas spasi kosong di awal dan akhir. Hashing Lakukan hashing menggunakan algoritma SHA-256 dan enkode byte hash.
region_code	Format string Kode ISO-3166-1 alpha-2 dua karakter. Spasi kosong Memangkas spasi kosong di awal dan akhir. Hashing Jangan lakukan hashing pada region_code.
postal_code	Format string Kode pos AS dan internasional diizinkan. Untuk alamat AS, gunakan 5 digit atau 5 digit 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 Memangkas spasi kosong di awal dan akhir. Hashing Jangan lakukan hashing pada postal_code.
address_line	Format string Hanya digunakan untuk Google Analytics. Jalan dan nomor untuk alamat pengguna. Konversi menjadi huruf kecil. Hapus karakter simbol. Spasi kosong Memangkas spasi kosong di awal dan akhir. Hashing Lakukan hashing menggunakan algoritma SHA-256 dan enkode byte hash.
city	Format string Hanya digunakan untuk Google Analytics. Kota alamat pengguna. Konversi menjadi huruf kecil. Hapus karakter simbol. Spasi kosong Memangkas spasi kosong di awal dan akhir. Hashing Jangan lakukan hashing pada city.
administrative_area	Format string Hanya digunakan untuk Google Analytics. Wilayah administratif (negara bagian atau provinsi) alamat pengguna. Gunakan singkatan dua huruf (misalnya, ca) atau nama lengkap (misalnya, california). Konversi menjadi huruf kecil. Hapus karakter simbol. Spasi kosong Memangkas spasi kosong di awal dan akhir. Hashing Jangan lakukan hashing pada administrative_area.

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 Memangkas 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 melakukan hashing pada ID iklan 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 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 merupakan 4 jam sebelum UTC pada saat itu: 2025-08-08T13:18:44.291-04:00

• Zona waktu PDT, yang merupakan 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 menerapkan waktu musim panas: 2025-08-08T22:18:44.291+09:00

Jika menggunakan format buffering 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

Persyaratan encoding berbeda-beda, bergantung pada apakah Anda mengenkripsi data pengguna:

• Data pengguna yang tidak dienkripsi: Enkode byte hash SHA-256 menggunakan encoding heksadesimal (hex) atau encoding Base64.

• Data pengguna terenkripsi: Jika Anda mengenkripsi data pengguna, Anda harus mengenkode byte hash mentah dengan Base64 sebelum enkripsi. Encoding heksadesimal tidak didukung untuk hash pra-enkripsi. Kemudian, Anda dapat mengenkode ciphertext yang dihasilkan menggunakan encoding heksadesimal atau Base64.

Catatan: Huruf besar/kecil output encoding tidak menjadi masalah saat menggunakan encoding heksadesimal.