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 @.
    • 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 menghapus titik atau tanda tambah.
    • Contoh: user.name+NYC@Example.com → user.name+nyc@example.com
Spasi kosong Pangkas spasi kosong di awal, akhir, dan di antara karakter.
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

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 lakukan hashing region_code.
postal_code
Format
string
Kode zip/pos AS dan internasional diizinkan.
Untuk alamat di Amerika Serikat, 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 lakukan hashing postal_code.
address_line
Format
string
Hanya digunakan untuk Google Analytics.
Jalan dan nomor alamat pengguna.
Konversi ke huruf kecil.
Hapus karakter simbol.
Spasi kosong Pangkas spasi kosong di awal dan akhir.
Hashing Beri hash menggunakan algoritma SHA-256. Enkode byte hash menggunakan encoding hex atau Base64.
city
Format
string
Hanya digunakan untuk Google Analytics.
Kota alamat pengguna.
Konversi ke huruf kecil.
Hapus karakter simbol.
Spasi kosong Pangkas spasi kosong di awal dan akhir.
Hashing Jangan lakukan hashing 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 ke huruf kecil.
Hapus karakter simbol.
Spasi kosong Pangkas spasi kosong di awal dan akhir.
Hashing Jangan lakukan hashing 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 Pangkas spasi kosong di awal dan akhir.
Hashing Jangan lakukan hashing ip_address.

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 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 melakukan hashing 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 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 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.
Sebelumnya
Mengonfigurasi tujuan dan header
Berikutnya
Enkripsi data pengguna