ดูข้อกำหนดการดูแลจัดการแบบเรียลไทม์

Google จะส่ง SegmentRequest ตามคำขอโฆษณาที่ตรงกับพื้นที่โฆษณาเป้าหมายไปยังการผสานรวมการดูแลจัดการแบบเรียลไทม์ ออบเจ็กต์ SegmentRequest จะให้สัญญาณตามบริบทหรือสัญญาณที่ปลอดภัยที่คุณ ใช้เพื่อระบุได้ว่ากลุ่มเป้าหมายใดที่ใช้กับพื้นที่โฆษณาที่ระบุใน SegmentResponse การดูแลจัดการแบบเรียลไทม์รองรับออบเจ็กต์ SegmentRequest และ SegmentResponse ที่ส่งในรูปแบบ JSON

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

SegmentRequest

แอตทริบิวต์	ประเภท	คำอธิบาย
site	เว็บไซต์	รองรับเฉพาะพาร์ทเนอร์การดูแลจัดการตามบริบท คำอธิบายของเว็บไซต์ ระบบจะป้อนข้อมูลในช่อง site หากเนื้อหาที่รองรับโฆษณาเป็นเว็บไซต์ ไม่ใช่แอปพลิเคชันที่ไม่ใช่เบราว์เซอร์
app	App	รองรับเฉพาะพาร์ทเนอร์การดูแลจัดการตามบริบท คำอธิบายของแอป ระบบจะป้อนข้อมูลในช่อง app หากเนื้อหาที่โฆษณาสนับสนุนเป็นแอปพลิเคชันที่ไม่ใช่เบราว์เซอร์แทนที่จะเป็นเว็บไซต์
pub	ผู้เผยแพร่โฆษณา	รองรับเฉพาะพาร์ทเนอร์การดูแลจัดการตามบริบท คำอธิบายของผู้เผยแพร่เนื้อหา
user	ผู้ใช้	ตัวอธิบายของผู้ใช้ที่เรียกดูเนื้อหาของผู้เผยแพร่โฆษณาซึ่งเริ่มต้นคำขอเซ็กเมนต์
device	อุปกรณ์	รองรับเฉพาะพาร์ทเนอร์การดูแลจัดการตามบริบท ตัวอธิบายอุปกรณ์ของผู้ใช้
segment_request_id	สตริง	ตัวระบุที่ไม่ซ้ำซึ่งใช้เพื่อระบุคำขอกลุ่มโดยไม่ขึ้นอยู่กับคำขอกลุ่มอื่นๆ ทั้งหมด

ไซต์

แอตทริบิวต์	ประเภท	คำอธิบาย
page	สตริง	รองรับเฉพาะพาร์ทเนอร์การดูแลจัดการตามบริบท URL ของหน้าที่แสดงการแสดงผล

แอป

แอตทริบิวต์	ประเภท	คำอธิบาย
bundle	สตริง	รองรับเฉพาะพาร์ทเนอร์การดูแลจัดการตามบริบท ตัวระบุแอปพลิเคชันเฉพาะแพลตฟอร์มซึ่งมีจุดประสงค์เพื่อให้ไม่ซ้ำกับแอป ใน Android ฟิลด์ bundle คือชื่อแพ็กเกจหรือชื่อชุด ใน iOS จะเป็นรหัสตัวเลข

ผู้เผยแพร่

แอตทริบิวต์	ประเภท	คำอธิบาย
id	สตริง	รองรับเฉพาะพาร์ทเนอร์การดูแลจัดการตามบริบท รหัสผู้เผยแพร่โฆษณาที่กำหนดโดยคำต่อท้ายรหัสผู้เผยแพร่โฆษณาของรหัสพร็อพเพอร์ตี้ของเว็บ ตัวอย่างเช่น ผู้เผยแพร่โฆษณาที่มีรหัสพร็อพเพอร์ตี้ของเว็บเป็น ca-pub-123 จะมีรหัสตั้งค่าเป็น pub-123

ผู้ใช้

แอตทริบิวต์	ประเภท	คำอธิบาย
consent	สตริง	สตริงความยินยอมของกรอบความโปร่งใสและความยินยอม (TCF) เวอร์ชัน 2 ของ IAB ที่เข้ารหัส base64 แบบปลอดภัยบนเว็บ ซึ่งดึงมาจากแพลตฟอร์มการจัดการความยินยอมของ IAB (CMP) ของผู้เผยแพร่โฆษณา ระบบจะป้อนข้อมูลในฟิลด์ consent หากผู้เผยแพร่โฆษณาผสานรวมกับ CMP สำหรับ TCF เวอร์ชัน 2 และ CMP นั้นระบุว่า GDPR มีผลกับคำขอโฆษณาและระบุสตริงความยินยอมที่ถูกต้อง ดูรายละเอียดเกี่ยวกับผู้ให้บริการที่ระบุไว้ในสตริงความยินยอมได้ที่รายชื่อผู้ให้บริการทั่วโลกของ IAB ที่ vendor-list.consensu.org/v2/vendor-list.json
eids	EID อาร์เรย์	ใช้ได้กับพาร์ทเนอร์การดูแลจัดการสัญญาณที่ปลอดภัยเท่านั้น อินสแตนซ์ของรหัสที่ขยาย ในฟีเจอร์การดูแลจัดการ eids คือข้อมูลที่ผู้เผยแพร่โฆษณาจัดหาให้ เช่น สัญญาณที่ปลอดภัย

EID

แอตทริบิวต์	ประเภท	คำอธิบาย
source	สตริง	ใช้ได้กับพาร์ทเนอร์การดูแลจัดการสัญญาณที่ปลอดภัยเท่านั้น แหล่งที่มาหรือผู้ให้บริการเทคโนโลยีที่รับผิดชอบชุดข้อมูลที่รวมไว้ แสดงเป็น โดเมนระดับบนสุด
uids	UID อาร์เรย์	ใช้ได้กับพาร์ทเนอร์การดูแลจัดการสัญญาณที่ปลอดภัยเท่านั้น อาร์เรย์ของออบเจ็กต์ UID จากแหล่งที่มาที่ระบุ

UID

แอตทริบิวต์	ประเภท	คำอธิบาย
id	สตริง	ใช้ได้กับพาร์ทเนอร์การดูแลจัดการสัญญาณที่ปลอดภัยเท่านั้น ตัวระบุ ในฟีเจอร์คัดสรร id คือสัญญาณที่ปลอดภัย ดูข้อมูลเพิ่มเติมเกี่ยวกับสัญญาณที่ปลอดภัยได้ที่แชร์สัญญาณที่ปลอดภัยกับผู้เสนอราคาและพาร์ทเนอร์การดูแลจัดการของ Ad Manager

อุปกรณ์

แอตทริบิวต์	ประเภท	คำอธิบาย
geo	ภูมิศาสตร์	รองรับเฉพาะพาร์ทเนอร์การดูแลจัดการตามบริบท ตำแหน่งของอุปกรณ์ของผู้ใช้

ภูมิศาสตร์

แอตทริบิวต์	ประเภท	คำอธิบาย
country	สตริง	รองรับเฉพาะพาร์ทเนอร์การดูแลจัดการตามบริบท ประเทศที่ใช้มาตรฐาน ISO-3166-1 Alpha-3
region	สตริง	รองรับเฉพาะพาร์ทเนอร์การดูแลจัดการตามบริบท รหัสภูมิภาคตามมาตรฐาน ISO-3166-2 รหัสรัฐ 2 ตัวอักษรหากเป็นสหรัฐอเมริกา
metro	สตริง	รองรับเฉพาะพาร์ทเนอร์การดูแลจัดการตามบริบท รหัสเขตเมืองของ Google ที่อยู่ในไฟล์ geo-table.csv

SegmentResponse

แอตทริบิวต์	ประเภท	คำอธิบาย
segment	กลุ่ม อาร์เรย์	ตัวอธิบายสำหรับกลุ่ม

กลุ่ม

แอตทริบิวต์	ประเภท	คำอธิบาย
segment_id	สตริง	รหัสของกลุ่ม รหัสควรตรงกับ curatorDataSegmentId ที่พบใน ชื่อของกลุ่มใน curators.dataSegments ของ Marketplace API