Google ใช้เทคโนโลยี AI เพื่อแปลเนื้อหาเป็นภาษาที่คุณต้องการ การแปลโดย AI อาจมีข้อผิดพลาด
ส่งความคิดเห็น
ดูข้อกำหนดการดูแลจัดการแบบเรียลไทม์
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
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
อุปกรณ์
แอตทริบิวต์
ประเภท
คำอธิบาย
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
ส่งความคิดเห็น
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2026-09-23 UTC
หากต้องการบอกให้เราทราบเพิ่มเติม
[[["เข้าใจง่าย","easyToUnderstand","thumb-up"],["แก้ปัญหาของฉันได้","solvedMyProblem","thumb-up"],["อื่นๆ","otherUp","thumb-up"]],[["ไม่มีข้อมูลที่ฉันต้องการ","missingTheInformationINeed","thumb-down"],["ซับซ้อนเกินไป/มีหลายขั้นตอนมากเกินไป","tooComplicatedTooManySteps","thumb-down"],["ล้าสมัย","outOfDate","thumb-down"],["ปัญหาเกี่ยวกับการแปล","translationIssue","thumb-down"],["ตัวอย่าง/ปัญหาเกี่ยวกับโค้ด","samplesCodeIssue","thumb-down"],["อื่นๆ","otherDown","thumb-down"]],["อัปเดตล่าสุด 2026-09-23 UTC"],[],[]]