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

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

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

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

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

UserIdentifier
email_address	รูปแบบ string แปลงเป็นตัวพิมพ์เล็ก เว้นวรรค ตัดช่องว่างขึ้นต้น ต่อท้าย และกลาง การแฮช แฮชโดยใช้อัลกอริทึม SHA-256 เข้ารหัสไบต์แฮชโดยใช้การเข้ารหัสฐาน 16 หรือ Base64
phone_number	รูปแบบ string ใช้รูปแบบ E.164 ใส่เครื่องหมายบวก (+) และรหัสประเทศ เว้นวรรค ตัดช่องว่างขึ้นต้นและต่อท้าย การแฮช แฮชโดยใช้อัลกอริทึม SHA-256 เข้ารหัสไบต์แฮชโดยใช้การเข้ารหัสฐาน 16 หรือ Base64
address	AddressInfo ออบเจ็กต์ โปรดดูข้อกำหนดเกี่ยวกับรูปแบบ AddressInfo

รูปแบบAddressInfo

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

AddressInfo
given_name	รูปแบบ string แปลงเป็นตัวพิมพ์เล็ก อย่าใส่คำนำหน้า เช่น Mrs. เว้นวรรค ตัดช่องว่างขึ้นต้นและต่อท้าย การแฮช แฮชโดยใช้อัลกอริทึม SHA-256 เข้ารหัสไบต์แฮชโดยใช้การเข้ารหัสฐาน 16 หรือ Base64
family_name	รูปแบบ string แปลงเป็นตัวพิมพ์เล็ก อย่าใส่คำต่อท้าย เช่น Jr. เว้นวรรค ตัดช่องว่างขึ้นต้นและต่อท้าย การแฮช แฮชโดยใช้อัลกอริทึม SHA-256 เข้ารหัสไบต์แฮชโดยใช้การเข้ารหัสฐาน 16 หรือ 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 ที่ได้จาก Cleanroom โดยใช้อัลกอริทึม SHA-256
2. เข้ารหัสไบต์แฮชด้วยการเข้ารหัสแบบเปลี่ยนตำแหน่งได้ของ EC โดยใช้คีย์ผู้เผยแพร่สำหรับรายการผู้ใช้ PAIR
3. เข้ารหัสข้อมูลที่เข้ารหัสโดยใช้การเข้ารหัสฐาน 16 หรือ Base64

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

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

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

• ดูวิธีเข้ารหัสข้อมูลผู้ใช้