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

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

  • UserData: ข้อมูลที่ได้จากผู้ใช้ เช่น อีเมล หรือหมายเลขโทรศัพท์
  • IpData: ข้อมูล IP เช่น ที่อยู่ IP และการประทับเวลาที่เกี่ยวข้อง
  • PairData: รหัส Publisher Advertiser Identity Reconciliation (PAIR)
  • MobileData: ข้อมูลที่ระบุอุปกรณ์เคลื่อนที่

ข้อกำหนดของ 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
ใส่เครื่องหมายบวก (+) และรหัสประเทศ อักขระทั้งหมดหลังเครื่องหมายบวกต้องเป็นตัวเลข
ตัวอย่างเช่น หมายเลขโทรศัพท์ในสหรัฐอเมริกา (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
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. เข้ารหัสไบต์แฮชด้วยการเข้ารหัสลับแบบสลับที่ใช้ 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

การเข้ารหัส

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

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