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

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

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

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

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

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

  • seconds: 1754683124
  • nanos: 291000000

การเข้ารหัส

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

ก่อนหน้า
กำหนดค่าปลายทางและส่วนหัว
ถัดไป
เข้ารหัสข้อมูลผู้ใช้