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

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 ให้ทำดังนี้
    • นำจุด (.) ทั้งหมดที่อยู่ก่อนสัญลักษณ์ @ ออก
    • นำเครื่องหมายบวก (+) ออกจากส่วน local-part และนำอักขระทั้งหมดที่ตามหลังเครื่องหมายบวกออก
    • ตัวอย่างเช่น cloudy.sanfrancisco+shopping@gmail.com → cloudysanfrancisco@gmail.com
  • หากอีเมลมีโดเมนอื่นที่ไม่ใช่ gmail.com หรือ googlemail.com อย่านำจุดหรือเครื่องหมายบวกออก
    • ตัวอย่าง: user.name+NYC@Example.com → user.name+nyc@example.com
เว้นวรรค ตัดช่องว่างที่อยู่ด้านหน้า ด้านหลัง และคั่นกลางออก
การแฮช แฮชโดยใช้อัลกอริทึม SHA-256 และเข้ารหัสไบต์แฮช
phone_number
รูปแบบ
string
ใส่เครื่องหมายบวก (+) และรหัสประเทศ อักขระทั้งหมดหลังเครื่องหมายบวกต้องเป็นตัวเลข
ตัวอย่างเช่น หมายเลขโทรศัพท์ของสหรัฐอเมริกา (800)555-0100 ควรจัดรูปแบบและปรับให้เป็นมาตรฐานเป็น +18005550100
เว้นวรรค ตัดช่องว่างที่อยู่ด้านหน้าและด้านหลังออก
การแฮช แฮชโดยใช้อัลกอริทึม SHA-256 และเข้ารหัสไบต์แฮช
address
AddressInfo ออบเจ็กต์

รูปแบบAddressInfo

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

AddressInfo
given_name
รูปแบบ
string
แปลงเป็นตัวพิมพ์เล็ก
อย่าใส่คำนำหน้า เช่น Mrs.
เว้นวรรค ตัดช่องว่างที่อยู่ด้านหน้าและด้านหลังออก
การแฮช แฮชโดยใช้อัลกอริทึม SHA-256 และเข้ารหัสไบต์แฮช
family_name
รูปแบบ
string
แปลงเป็นตัวพิมพ์เล็ก
อย่าใส่คำต่อท้าย เช่น Jr.
เว้นวรรค ตัดช่องว่างที่อยู่ด้านหน้าและด้านหลังออก
การแฮช แฮชโดยใช้อัลกอริทึม SHA-256 และเข้ารหัสไบต์แฮช
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 และเข้ารหัสไบต์แฮช
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 ที่ Clean Room ระบุโดยใช้อัลกอริทึม SHA-256

  2. เข้ารหัสไบต์แฮชด้วยการเข้ารหัสแบบสับเปลี่ยน EC โดยใช้คีย์ของผู้เผยแพร่โฆษณาสำหรับรายการผู้ใช้ PAIR

  3. เข้ารหัสข้อมูลที่เข้ารหัสโดยใช้การเข้ารหัสฐานสิบหกหรือ Base64

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

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

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

หากใช้รูปแบบ 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

การเข้ารหัส

ข้อกำหนดในการเข้ารหัสจะแตกต่างกันไปขึ้นอยู่กับว่าคุณเข้ารหัสข้อมูลผู้ใช้หรือไม่ ดังนี้

เวิร์กโฟลว์การเข้ารหัส

  • ข้อมูลผู้ใช้ที่ไม่ได้เข้ารหัส: เข้ารหัสไบต์แฮช SHA-256 โดยใช้การเข้ารหัสเลขฐาน 16 (เลขฐาน 16) หรือการเข้ารหัส Base64

  • ข้อมูลผู้ใช้ที่เข้ารหัส: หากคุณเข้ารหัสข้อมูลผู้ใช้ คุณต้องเข้ารหัสไบต์แฮชดิบแบบ Base64 ก่อนการเข้ารหัส ระบบไม่รองรับการเข้ารหัสเลขฐาน 16 สำหรับแฮชก่อนการเข้ารหัส จากนั้นคุณสามารถเข้ารหัสข้อความเข้ารหัสลับที่ได้โดยใช้การเข้ารหัสเลขฐาน 16 หรือ Base64

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