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

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

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

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

UserIdentifier
email_address
รูปแบบ
string
  • แปลงเป็นตัวพิมพ์เล็ก
  • หากอีเมลมีโดเมน gmail.com หรือ googlemail.com ให้ทำดังนี้
    • นำจุดทั้งหมด (.) ออกก่อนสัญลักษณ์ @
    • นำเครื่องหมายบวก (+) ออกจากส่วนท้องถิ่น และนำอักขระทั้งหมดที่ตามมาออก
    • ตัวอย่าง: cloudy.sanfrancisco+shopping@gmail.com → cloudysanfrancisco@gmail.com
  • หากอีเมลมีโดเมนอื่นที่ไม่ใช่ gmail.com หรือ googlemail.com ให้นำจุดหรือเครื่องหมายบวกออก
    • ตัวอย่าง: user.name+NYC@Example.com → user.name+nyc@example.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
address_line
รูปแบบ
string
ใช้สำหรับ Google Analytics เท่านั้น
ถนนและหมายเลขของที่อยู่ผู้ใช้
แปลงเป็นตัวพิมพ์เล็ก
นำอักขระสัญลักษณ์ออก
เว้นวรรค นำช่องว่างที่อยู่ด้านหน้าและด้านหลังออก
การแฮช แฮชโดยใช้อัลกอริทึม SHA-256 เข้ารหัสไบต์แฮชโดยใช้การเข้ารหัสเลขฐานสิบหกหรือ Base64
city
รูปแบบ
string
ใช้สำหรับ Google Analytics เท่านั้น
เมืองของที่อยู่ผู้ใช้
แปลงเป็นตัวพิมพ์เล็ก
นำอักขระสัญลักษณ์ออก
เว้นวรรค นำช่องว่างที่อยู่ด้านหน้าและด้านหลังออก
การแฮช อย่าแฮช city
administrative_area
รูปแบบ
string
ใช้สำหรับ Google Analytics เท่านั้น
เขตการปกครอง (รัฐหรือจังหวัด) ของที่อยู่ผู้ใช้
ใช้ตัวย่อ 2 ตัวอักษร (เช่น ca) หรือชื่อเต็ม (เช่น california)
แปลงเป็นตัวพิมพ์เล็ก
นำอักขระสัญลักษณ์ออก
เว้นวรรค นำช่องว่างที่อยู่ด้านหน้าและด้านหลังออก
การแฮช อย่าแฮช administrative_area

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

ออบเจ็กต์ IpData มีแอตทริบิวต์ต่อไปนี้

IpData
ip_address
รูปแบบ
string
ที่อยู่ IPv4 หรือ IPv6
สำหรับที่อยู่ IPv6 ตัวพิมพ์เล็กหรือตัวพิมพ์ใหญ่ก็ได้
เว้นวรรค นำช่องว่างที่อยู่ด้านหน้าและด้านหลังออก
การแฮช อย่าแฮช ip_address

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

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

  1. แฮชข้อมูล PII ที่คลีนรูมให้มาโดยใช้อัลกอริทึม SHA-256
  2. เข้ารหัสไบต์แฮชด้วยการเข้ารหัสแบบสลับที่ใช้คีย์ของผู้เผยแพร่โฆษณาสำหรับรายการผู้ใช้ 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

การเข้ารหัส

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

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