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

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

ผู้ใช้

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

EID

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

UID

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

อุปกรณ์

แอตทริบิวต์ ประเภท คำอธิบาย
geo ภูมิศาสตร์ รองรับเฉพาะพาร์ทเนอร์การดูแลจัดการตามบริบท ตำแหน่งของอุปกรณ์ของผู้ใช้
devicetype int รองรับเฉพาะพาร์ทเนอร์การดูแลจัดการตามบริบท ประเภททั่วไปของอุปกรณ์ ดูข้อมูลเพิ่มเติมเกี่ยวกับประเภทอุปกรณ์ที่เป็นไปได้ได้ที่รายการ: ประเภทอุปกรณ์ใน AdCOM 1.0
os สตริง รองรับเฉพาะพาร์ทเนอร์การดูแลจัดการตามบริบท ระบบปฏิบัติการของอุปกรณ์ (เช่น "iOS")
make สตริง รองรับเฉพาะพาร์ทเนอร์การดูแลจัดการตามบริบท ยี่ห้ออุปกรณ์ (เช่น "Apple")
ifa สตริง รหัสโฆษณาของอุปกรณ์ที่ไม่ได้เข้ารหัส (ไม่ได้แฮช) ในโปรโตคอลการดูแลจัดการแบบเรียลไทม์ของ Google โดยทั่วไปแล้ว นี่คือ UUID ที่มี 36 อักขระ โดยรหัส Android จะเป็นตัวพิมพ์เล็กและ IDFA จะเป็นตัวพิมพ์ใหญ่ สำหรับอุปกรณ์ Samsung ค่าเหล่านี้จะเป็นค่าตัวอักษรและตัวเลขคละกัน 32 อักขระ

ภูมิศาสตร์

แอตทริบิวต์ ประเภท คำอธิบาย
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