จัดรูปแบบข้อมูลผู้ใช้

API ของ Data Manager รองรับการอัปโหลดข้อมูลผู้ใช้หลายประเภท ทําตามข้อกําหนดด้านการจัดรูปแบบ การแฮช และการเข้ารหัสสําหรับองค์ประกอบข้อมูลแต่ละรายการเพื่อให้ระบบรับและประมวลผลข้อมูลได้สําเร็จ

ข้อกำหนดของ UserData

ออบเจ็กต์ UserData คือคอลเล็กชันของออบเจ็กต์ UserIdentifier แต่ละ UserIdentifierมีแอตทริบิวต์อย่างใดอย่างหนึ่งในตารางต่อไปนี้

UserIdentifier
email_address
รูปแบบ
string
แปลงเป็นตัวพิมพ์เล็ก
เว้นวรรค ตัดช่องว่างขึ้นต้น ต่อท้าย และตรงกลาง
การแฮช แฮชโดยใช้อัลกอริทึม SHA-256 เข้ารหัสไบต์ของแฮชโดยใช้การเข้ารหัสแบบเลขฐานสิบหกหรือ Base64
phone_number
รูปแบบ
string
ใส่เครื่องหมายบวก (+) และรหัสประเทศ
เว้นวรรค ตัดช่องว่างขึ้นต้นและต่อท้าย
การแฮช แฮชโดยใช้อัลกอริทึม SHA-256 เข้ารหัสไบต์ของแฮชโดยใช้การเข้ารหัสแบบเลขฐานสิบหกหรือ Base64
address
AddressInfo ออบเจ็กต์

รูปแบบAddressInfo

ใช้หลักเกณฑ์การจัดรูปแบบต่อไปนี้เพื่อสร้างaddress แอตทริบิวต์ของ UserIdentifier

AddressInfo
given_name
รูปแบบ
string
แปลงเป็นตัวพิมพ์เล็ก
อย่าใส่คำนำหน้า เช่น Mrs.
เว้นวรรค ตัดช่องว่างขึ้นต้นและต่อท้าย
การแฮช แฮชโดยใช้อัลกอริทึม SHA-256 เข้ารหัสไบต์ของแฮชโดยใช้การเข้ารหัสแบบเลขฐานสิบหกหรือ Base64
family_name
รูปแบบ
string
แปลงเป็นตัวพิมพ์เล็ก
อย่าใส่คำต่อท้าย เช่น Jr.
เว้นวรรค ตัดช่องว่างขึ้นต้นและต่อท้าย
การแฮช แฮชโดยใช้อัลกอริทึม SHA-256 เข้ารหัสไบต์ของแฮชโดยใช้การเข้ารหัสแบบเลขฐานสิบหกหรือ Base64
region_code
รูปแบบ
string
รหัส ISO-3166-1 Alpha-2 ที่มีอักขระ 2 ตัว
เว้นวรรค ตัดช่องว่างขึ้นต้นและต่อท้าย
การแฮช อย่าแฮช region_code
postal_code
รูปแบบ
string
อนุญาตให้ใช้รหัสไปรษณีย์ทั้งของสหรัฐอเมริกาและต่างประเทศ
สำหรับที่อยู่ในสหรัฐอเมริกา ให้ใช้ตัวเลข 5 หลักหรือตัวเลข 5 หลักตามด้วยส่วนขยาย 4 หลัก การใช้ส่วนขยาย 4 หลักอาจช่วยเพิ่มอัตราการจับคู่ ได้
สำหรับประเทศอื่นๆ ทั้งหมด อย่าใช้ส่วนขยายรหัสไปรษณีย์
เว้นวรรค ตัดช่องว่างขึ้นต้นและต่อท้าย
การแฮช อย่าแฮช postal_code

ข้อกำหนดของ PairData

ป้อนข้อมูลในช่อง pair_ids ของออบเจ็กต์ PairData ด้วยรายการรหัส จัดรูปแบบแต่ละองค์ประกอบในรายการโดยใช้ขั้นตอนต่อไปนี้

  1. แฮชข้อมูล PII ที่คลีนรูมระบุโดยใช้อัลกอริทึม SHA-256
  2. เข้ารหัสไบต์แฮชด้วยการเข้ารหัสแบบสลับเปลี่ยนของ EC โดยใช้คีย์ผู้เผยแพร่โฆษณา สำหรับรายชื่อผู้ใช้ PAIR
  3. เข้ารหัสข้อมูลที่เข้ารหัสโดยใช้การเข้ารหัสแบบเลขฐานสิบหกหรือ Base64

ข้อกำหนดของ MobileData

ป้อนข้อมูลในฟิลด์ mobile_ids ของออบเจ็กต์ MobileData ด้วยรายการรหัสอุปกรณ์เคลื่อนที่ อย่าแฮชรหัส อุปกรณ์เคลื่อนที่

รูปแบบการประทับเวลา

หากใช้รูปแบบ JSON สำหรับฟิลด์ Timestamp เช่น timestamp และ last_updated_timestamp ของ Event ให้ใช้รูปแบบ RFC 3339

หากใช้รูปแบบ Protocol Buffer ให้ตั้งค่า seconds และตั้งค่า nanos (ไม่บังคับ) เมื่อสร้าง Timestamp

ขั้นตอนถัดไป