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

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

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

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

UserIdentifier
email_address
รูปแบบ
string
แปลงเป็นตัวพิมพ์เล็ก
หากอีเมลมีโดเมน gmail.com หรือ googlemail.com ให้นำจุดทั้งหมด (.) ออก ก่อนสัญลักษณ์ @
เว้นวรรค ตัดช่องว่างขึ้นต้น ต่อท้าย และตรงกลาง
การแฮช แฮชโดยใช้อัลกอริทึม SHA-256 เข้ารหัสไบต์ของแฮชโดยใช้การเข้ารหัสแบบเลขฐานสิบหกหรือ Base64
phone_number
รูปแบบ
string
ใส่เครื่องหมายบวก (+) และรหัสประเทศ อักขระทั้งหมดหลังเครื่องหมายบวกต้องเป็นตัวเลข
ตัวอย่างเช่น หมายเลขโทรศัพท์ในสหรัฐอเมริกา (800)555-0100 ควรจัดรูปแบบและแปลงเป็น +18005550100
เว้นวรรค ตัดช่องว่างขึ้นต้นและต่อท้าย
การแฮช แฮชโดยใช้อัลกอริทึม 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 ตัวอย่างเวลา UTC ของวันที่ 8 สิงหาคม 2025 เวลา 17:18:44.291 น. ในรูปแบบ RFC 3339 และเขตเวลาต่างๆ มีดังนี้

  • เขตเวลา UTC: 2025-08-08T17:18:44.291Z
  • เขตเวลา EDT ซึ่งเร็วกว่า UTC 4 ชั่วโมงในขณะนั้น 2025-08-08T13:18:44.291-04:00
  • เขตเวลา PDT ซึ่งเร็วกว่า UTC 7 ชั่วโมงในขณะนั้น 2025-08-08T10:18:44.291-07:00
  • เขตเวลาของโตเกียว ประเทศญี่ปุ่น ซึ่งเร็วกว่า UTC 9 ชั่วโมงและไม่ได้ใช้ เวลาออมแสง 2025-08-08T22:18:44.291+09:00

หากใช้รูปแบบ Protocol Buffer ให้ตั้งค่า seconds และตั้งค่า nanos (ไม่บังคับ) เมื่อสร้าง Timestamp ค่า seconds และ nanos สำหรับเวลา UTC ของวันที่ 8 สิงหาคม 2025 เวลา 17:18:44.291 น. มีดังนี้

  • seconds: 1754683124
  • nanos: 291000000

การเข้ารหัส

โปรดคำนึงถึงสิ่งต่อไปนี้เมื่อเข้ารหัสข้อมูล

  • ตัวพิมพ์เล็กหรือตัวพิมพ์ใหญ่ของเอาต์พุตการเข้ารหัสไม่มีผลเมื่อใช้การเข้ารหัสฐานสิบหก (hex)
  • ตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ของเอาต์พุตการเข้ารหัสมีความสำคัญเมื่อใช้การเข้ารหัส Base64

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