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

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

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

SegmentRequest

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

ภูตน้อย

แอตทริบิวต์	ประเภท	คำอธิบาย
id	สตริง	รองรับเฉพาะพาร์ทเนอร์การดูแลจัดการตามบริบท ตัวระบุที่ไม่ซ้ำกันสำหรับการแสดงผลนี้ภายในบริบทของคำขอกลุ่มเป้าหมาย ค่าจะเริ่มต้นที่ 1 และเพิ่มขึ้นจนถึง n สำหรับการแสดงผล n ครั้ง
banner	แบนเนอร์	รองรับเฉพาะพาร์ทเนอร์การดูแลจัดการตามบริบท ช่องนี้จะป้อนข้อมูลไว้หากมีการเสนอการแสดงผลเป็นโอกาสในการโฆษณาแบนเนอร์
video	วิดีโอ	รองรับเฉพาะพาร์ทเนอร์การดูแลจัดการตามบริบท ช่องนี้จะป้อนข้อมูลหากมีการเสนอการแสดงผลเป็นโอกาสในการโฆษณาวิดีโอ
ext	ImpExt	ระบบจะป้อนข้อมูลนี้ด้วยส่วนขยายสำหรับออบเจ็กต์ Imp

แบนเนอร์

แอตทริบิวต์	ประเภท	คำอธิบาย
w	int	รองรับเฉพาะพาร์ทเนอร์การดูแลจัดการตามบริบท ความกว้างเป็นพิกเซลอิสระของอุปกรณ์ (DIPS)
h	int	รองรับเฉพาะพาร์ทเนอร์การดูแลจัดการตามบริบท ความสูงเป็นพิกเซลอิสระของอุปกรณ์ (DIP)
pos	int	รองรับเฉพาะพาร์ทเนอร์การดูแลจัดการตามบริบท อันดับโฆษณาบนหน้าจอ ดูข้อมูลเพิ่มเติมเกี่ยวกับตำแหน่งโฆษณาที่เป็นไปได้ได้ที่รายการ: ตำแหน่งโฆษณาใน AdCOM 1.0

วิดีโอ

แอตทริบิวต์	ประเภท	คำอธิบาย
w	int	รองรับเฉพาะพาร์ทเนอร์การดูแลจัดการตามบริบท ความกว้างของวิดีโอเพลเยอร์ในหน่วยพิกเซลอิสระของอุปกรณ์ (DIP)
h	int	รองรับเฉพาะพาร์ทเนอร์การดูแลจัดการตามบริบท ความสูงของวิดีโอเพลเยอร์ในหน่วยพิกเซลอิสระของอุปกรณ์ (DIP)
pos	int	รองรับเฉพาะพาร์ทเนอร์การดูแลจัดการตามบริบท อันดับโฆษณาบนหน้าจอ ดูข้อมูลเพิ่มเติมเกี่ยวกับตำแหน่งโฆษณาที่เป็นไปได้ได้ที่รายการ: ตำแหน่งโฆษณาใน AdCOM 1.0

ImpExt

แอตทริบิวต์	ประเภท	คำอธิบาย
gpid	สตริง	รองรับเฉพาะพาร์ทเนอร์การดูแลจัดการตามบริบท อธิบายรหัสตำแหน่งโฆษณาทั่วโลก รหัสที่แตกต่างกันและคงอยู่ซึ่งผู้เผยแพร่โฆษณาระบุไว้ และสอดคล้องกันในเส้นทางอุปทานสำหรับหน่วยโฆษณาแต่ละหน่วยในหน้าเว็บ ดูบทความนี้

ไซต์

แอตทริบิวต์	ประเภท	คำอธิบาย
page	สตริง	รองรับเฉพาะพาร์ทเนอร์การดูแลจัดการตามบริบท URL ของหน้าที่แสดงการแสดงผล
mobile	int	รองรับเฉพาะพาร์ทเนอร์การดูแลจัดการตามบริบท ระบุว่ามีการตั้งโปรแกรมเว็บไซต์เพื่อเพิ่มประสิทธิภาพเลย์เอาต์เมื่อดูบนอุปกรณ์เคลื่อนที่หรือไม่ โดย 0 = ไม่ และ 1 = ใช่

แอป

แอตทริบิวต์	ประเภท	คำอธิบาย
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	ภูมิศาสตร์	รองรับเฉพาะพาร์ทเนอร์การดูแลจัดการตามบริบท ตำแหน่งของอุปกรณ์ของผู้ใช้
devicetype	int	รองรับเฉพาะพาร์ทเนอร์การดูแลจัดการตามบริบท ประเภททั่วไปของอุปกรณ์ ดูข้อมูลเพิ่มเติมเกี่ยวกับประเภทอุปกรณ์ที่เป็นไปได้ได้ที่รายการ: ประเภทอุปกรณ์ใน AdCOM 1.0
os	สตริง	รองรับเฉพาะพาร์ทเนอร์การดูแลจัดการตามบริบท ระบบปฏิบัติการของอุปกรณ์ (เช่น "iOS")
make	สตริง	รองรับเฉพาะพาร์ทเนอร์การดูแลจัดการตามบริบท ยี่ห้ออุปกรณ์ (เช่น "Apple")

ภูมิศาสตร์

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

SegmentResponse

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

กลุ่ม

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