โปรดเตรียมข้อกำหนด OpenRTB 2.6 ไว้ขณะอ่านหน้านี้
Display & Video 360 ไม่รองรับทุกช่องในข้อกําหนด OpenRTB และอาจมีรายละเอียดปลีกย่อย ส่วนต่างๆ ของเอกสารนี้มีข้อมูลและ คำแนะนำเฉพาะสำหรับการติดตั้งใช้งาน Display & Video 360 คุณควรปฏิบัติตามหลักเกณฑ์ที่ระบุไว้ในข้อกำหนด OpenRTB ด้วย เว้นแต่จะได้รับคำสั่งเป็นอย่างอื่น
ระบบไม่รองรับบางฟิลด์ แต่จะยังคงแยกวิเคราะห์อยู่ ช่องเหล่านี้ต้อง จัดรูปแบบอย่างถูกต้อง แต่จะไม่ส่งผลต่อผลลัพธ์การเสนอราคา
ข้อกำหนดของคำขอราคาเสนอ
คำขอราคาเสนอคือคำขอ HTTP Post ที่มีเนื้อหาเป็นออบเจ็กต์คำขอราคาเสนอ รูปแบบของเนื้อหาจะกำหนดไว้ในส่วนหัวของ
Content-Type
การตอบกลับที่เกี่ยวข้องคือ HTTP 204 ที่ไม่มีเนื้อหาสำหรับการไม่เสนอราคา หรือ HTTP 200 ที่มีเนื้อหาเป็นการตอบกลับการเสนอราคา
หากคำขอราคาเสนอมีรูปแบบไม่ถูกต้อง ระบบอาจแสดงผล HTTP 200 ที่มีเนื้อหาเป็น bid
response พร้อมกับฟิลด์ nbr
ที่มีข้อมูล
รูปแบบการตอบกลับจะควบคุมโดยส่วนหัว Accept
รูปแบบ JSON
ระบบจะใช้รูปแบบเริ่มต้นเมื่อไม่ได้ระบุประเภท MIME ที่ยอมรับ
คำขอและการตอบกลับ JSON เป็นไปตามข้อกำหนด OpenRTB 2.6 ของ IAB เอกสารต่อไปนี้อธิบายการรองรับส่วนขยายและฟิลด์
ส่วนหัว Content-Type
: application/json
ระบุคำขอเสนอราคา JSON
Accept
: application/json
ระบุว่าการตอบกลับคำขอเสนอราคาควรอยู่ในรูปแบบ JSON
รูปแบบ Protobuf
หมายเหตุ: การรองรับ Protobuf อยู่ในเวอร์ชันเบต้า โปรดติดต่อ DV360 หากสนใจ
คำขอและการตอบกลับ JSON เป็นไปตามข้อกำหนด Protobuf ของ OpenRTB 2.6 ของ IAB
ส่วนขยายมีการรองรับแบบจำกัด โปรดติดต่อ DV360 หากสนใจ
ส่งส่วนหัว Content-Type
: application/x-protobuf
เพื่อระบุคำขอเสนอราคา Protobuf และตั้งค่า Accept
: application/x-protobuf
เพื่อรับการตอบกลับคำขอเสนอราคา Protobuf
ออบเจ็กต์คำขอราคาเสนอ
ช่อง | ประเภท | รายละเอียด |
---|---|---|
id |
สตริง | ต้องระบุ รหัสที่ไม่ซ้ำกันของคำขอราคาเสนอ ซึ่งใช้เพื่อระบุ คำขอแต่ละรายการได้ในระยะเวลาที่จำกัดมากหลังจากที่แสดงแล้ว |
imp |
อาร์เรย์ Imp | ต้องมีออบเจ็กต์ imp อย่างน้อย 1 รายการ
สำหรับพ็อดเสียง ระบบรองรับออบเจ็กต์ |
site |
เว็บไซต์ | ต้องระบุสำหรับคำขอเว็บไซต์site และ app จะเป็นข้อมูลแยกกัน |
app |
App | ต้องระบุสำหรับคำขอแอปapp และ site จะเป็นข้อมูลแยกกัน |
device |
อุปกรณ์ | ต้องระบุ |
user |
ผู้ใช้ | ต้องระบุ |
test |
จำนวนเต็ม | ไม่รองรับ |
at |
จำนวนเต็ม |
1 : การประมูลแบบใช้ราคาอันดับ 1 ที่ผู้ลงโฆษณาจะถูกเรียกเก็บเงินตาม
จํานวนราคาเสนอ2 (ค่าเริ่มต้น): การประมูลราคาที่ 2 ซึ่งผู้ลงโฆษณาจะ
ถูกเรียกเก็บเงินสูงกว่าผู้เสนอราคาสูงสุดเป็นอันดับ 2 เพียงเล็กน้อย3 : ราคาพื้นอยู่ในคำขอ และไม่เกี่ยวข้องกับ
ราคาเสนอที่แข่งขัน
|
tmax |
จำนวนเต็ม | ไม่บังคับ ค่าเริ่มต้นคือกำหนดเองต่อการผสานรวม |
wseat |
อาร์เรย์สตริง | รายชื่อที่นั่งของผู้ซื้อที่อนุญาต แนะนําเว้นแต่จะอนุญาตให้ผู้ลงโฆษณาทุกรายเสนอราคา การยกเลิกการตั้งค่าหมายความว่าไม่มีข้อจำกัด |
bseat |
อาร์เรย์สตริง | รายชื่อที่นั่งของผู้ซื้อที่ควรบล็อกราคาเสนอ ระบบจะบล็อกผู้ซื้อที่ระบุ ไม่ให้เสนอราคาในดีลและการประมูลแบบเปิด |
allimps |
จำนวนเต็ม | ไม่รองรับ |
cur |
อาร์เรย์สตริง | ไม่บังคับ แต่แนะนำเป็นอย่างยิ่ง ค่าเริ่มต้นคือต่อการผสานรวม สกุลเงินในคำขอราคาเสนอต้องตรงกับสกุลเงินใดสกุลเงินหนึ่งที่ลงทะเบียนไว้ ในระหว่างการผสานรวม ขอแนะนำเป็นอย่างยิ่งให้รองรับสกุลเงินเดียวต่อการแลกเปลี่ยน |
wlang |
อาร์เรย์สตริง | ไม่รองรับ |
bcat |
อาร์เรย์สตริง | หมวดหมู่ผู้ลงโฆษณาที่ถูกบล็อกโดยใช้หมวดหมู่เนื้อหาของ IAB เมื่อไม่กำหนดค่า จะไม่มีหมวดหมู่ที่ถูกบล็อก |
badv |
อาร์เรย์สตริง | ระบุผู้ลงโฆษณาที่ถูกบล็อกตามโดเมนที่ผู้ลงโฆษณาระบุ Unset คือไม่มีผู้ลงโฆษณาที่ถูกบล็อก |
bapp |
อาร์เรย์สตริง | ไม่รองรับ |
source |
แหล่งที่มา | ต้องระบุสำหรับ schain |
regs |
Regs | ไม่บังคับ |
ext |
ส่วนขยายคำขอราคาเสนอ | ไม่บังคับ |
ออบเจ็กต์ส่วนขยายคำขอราคาเสนอ
ช่อง | ประเภท | รายละเอียด |
---|---|---|
schain |
ซัพพลายเชน |
การผสานรวมใหม่ควร
ใช้ฟิลด์ BidRequest.source.schain ใน
แหล่งที่มาแทน
|
purch |
จำนวนเต็ม |
พารามิเตอร์การเข้าชมที่ซื้อคือการเข้าชมที่เปลี่ยนเส้นทางมาจาก
พร็อพเพอร์ตี้นอกเหนือจากที่เป็นเจ้าของ ได้มา หรือกิจกรรมที่จูงใจ
ซึ่งเป็นไปตามข้อกำหนด IVT 2.0 ของ MRCใหม่
ซึ่งจะเรียกว่าแหล่งที่มาของการเข้าชมของผู้เผยแพร่โฆษณาในการรายงานที่แสดงต่อผู้ซื้อ และจะมีค่าใดค่าหนึ่งต่อไปนี้ |
gdemsignals |
สตริง | Blob สัญญาณ SCAR API จาก GMA SDK แนะนําให้ใช้หากเป็นทราฟิก GMA SDK แต่ห้ามใช้ในกรณีอื่นๆ |
disable_gma_format |
int |
จะระบุหรือไม่ก็ได้หากระบุ gdemsignals แต่ห้ามระบุหากไม่ได้ระบุ gdemsignals 0 (ค่าเริ่มต้น): เมื่อมีการระบุ gdemsignals
โฆษณาในการตอบกลับราคาเสนอจะเป็น JSON Blob1 : ระบบจะให้แท็กโฆษณาแทน Blob json ด้วย
|
ออบเจ็กต์ต้นทาง
ช่อง | ประเภท | รายละเอียด |
---|---|---|
fd |
จำนวนเต็ม | หน่วยงานที่รับผิดชอบในการตัดสินใจขายการแสดงผลขั้นสุดท้าย0 (ค่าเริ่มต้น): Exchange เป็นผู้ตัดสิน1 : แหล่งที่มาต้นทางเป็นผู้กำหนด
|
tid |
สตริง | ไม่รองรับ |
pchain |
สตริง | ไม่รองรับ |
schain |
ซัพพลายเชน |
ต้องระบุในเกือบทุกกรณี
เราขอแนะนำให้ใช้ฟิลด์นี้แทนการระบุ |
ext |
ส่วนขยายแหล่งที่มา | ไม่บังคับ |
ออบเจ็กต์ส่วนขยายแหล่งที่มา
เราขอแนะนำให้ใช้ส่วนขยายนี้อย่างยิ่งเนื่องจากมีผลต่อวิธีรายงานการวัดค่าการมองเห็น ใน DV3 ให้แก่ลูกค้า หากชื่อพาร์ทเนอร์ OMID ไม่อยู่ในรายการการรับรอง ของ IAB เราต้องรายงานเมตริกการมองเห็นแยกจากเมตริกที่ได้รับการรับรองจาก MRC ตามที่ MRC กำหนด ดูข้อมูล เพิ่มเติม
ช่อง | ประเภท | รายละเอียด |
---|---|---|
omidpn |
สตริง | ตัวระบุของการผสานรวม OM SDK ซึ่งเหมือนกับพารามิเตอร์ "name" ของออบเจ็กต์พาร์ทเนอร์ OMID |
omidpv |
สตริง | เวอร์ชันของการผสานรวม OM SDK ซึ่งเหมือนกับพารามิเตอร์ "versionString" ของออบเจ็กต์พาร์ทเนอร์ OMID |
schain |
ซัพพลายเชน |
การผสานรวมใหม่ควรใช้ฟิลด์
schain ใน
แหล่งที่มาแทน
|
ออบเจ็กต์ Regs
ช่อง | ประเภท | รายละเอียด |
---|---|---|
coppa |
จำนวนเต็ม | 0 (ค่าเริ่มต้น): COPPA ไม่เกี่ยวข้องกับคำขอนี้1 : คำขอนี้เกี่ยวข้องกับ COPPA |
ext |
ส่วนขยาย Regs | ไม่บังคับ |
ออบเจ็กต์ส่วนขยาย Regs
ช่อง | ประเภท | รายละเอียด |
---|---|---|
gdpr |
จำนวนเต็ม | ระบุว่าคำขอราคาเสนอมาจากภูมิภาค EEA หรือไม่0 (ค่าเริ่มต้น): ภูมิภาคที่ไม่ใช่ EEA1 : ภูมิภาค EEAดูรายละเอียดเพิ่มเติมได้ที่โซลูชันผู้ให้บริการที่ได้รับความยินยอม สำหรับ GDPR |
us_privacy |
สตริง | โปรดปฏิบัติตามข้อกำหนดทางเทคนิคที่ IAB Tech Lab ระบุเพื่อใช้สตริง
us_privacy
เมื่อเราได้รับสตริง |
ออบเจ็กต์ Imp
ช่อง | ประเภท | รายละเอียด |
---|---|---|
id |
สตริง | ตัวระบุที่ไม่ซ้ำกันสำหรับการแสดงผลนี้ภายในบริบทของคำขอราคาเสนอ (โดยปกติ ค่าจะเริ่มต้นด้วย 1 และเพิ่มขึ้นจนถึง n สำหรับการแสดงผล n รายการ) |
metric |
วัตถุ | ไม่รองรับ |
banner |
แบนเนอร์ | ต้องระบุสำหรับโอกาสแสดงโฆษณาแบนเนอร์ |
video |
วิดีโอ | ต้องระบุสำหรับโอกาสโฆษณาวิดีโอ |
audio |
เสียง | ต้องระบุสำหรับโอกาสโฆษณาเสียง |
native |
เนทีฟ | ต้องระบุสำหรับโอกาสในการโฆษณาเนทีฟ |
pmp |
Pmp | ดีลมาร์เก็ตเพลสส่วนตัวที่มีผลกับการแสดงผลนี้ |
displaymanager |
สตริง | ชื่อพาร์ทเนอร์สื่อกลางโฆษณา เทคโนโลยี SDK หรือเพลเยอร์ที่รับผิดชอบ การแสดงโฆษณา (โดยปกติคือวิดีโอหรืออุปกรณ์เคลื่อนที่) ใช้โดยเซิร์ฟเวอร์โฆษณาบางรายการเพื่อ ปรับแต่งโค้ดโฆษณาตามพาร์ทเนอร์ แนะนำสำหรับวิดีโอและ/หรือแอป |
displaymanagerver |
สตริง | เวอร์ชันของพาร์ทเนอร์สื่อกลางโฆษณา เทคโนโลยี SDK หรือเพลเยอร์ที่รับผิดชอบ ในการแสดงโฆษณา (โดยปกติคือวิดีโอหรืออุปกรณ์เคลื่อนที่) ใช้โดยเซิร์ฟเวอร์โฆษณาบางรายการเพื่อ ปรับแต่งโค้ดโฆษณาตามพาร์ทเนอร์ แนะนำสำหรับวิดีโอและ/หรือแอป |
instl |
จำนวนเต็ม |
0 (ค่าเริ่มต้น): ไม่ใช่โฆษณาคั่นหน้า1 : โฆษณาเป็นโฆษณาคั่นระหว่างหน้าหรือโฆษณาแบบเต็มหน้าจอ
|
tagid |
สตริง | ตัวระบุสำหรับตำแหน่งโฆษณาหรือแท็กโฆษณาที่เฉพาะเจาะจงซึ่งใช้ในการเริ่มต้น การประมูล ซึ่งจะเป็นประโยชน์ในการแก้ไขข้อบกพร่องของปัญหา หรือเพื่อ การเพิ่มประสิทธิภาพโดยผู้ซื้อ |
bidfloor |
ทศนิยม | ราคาเสนอขั้นต่ำสำหรับการแสดงผลนี้ซึ่งแสดงใน CPM |
bidfloorcur |
สตริง |
สกุลเงินที่ระบุโดยใช้รหัสตัวอักษร ISO-4217 |
clickbrowser |
จำนวนเต็ม |
ระบุประเภทเบราว์เซอร์ที่เปิดขึ้นเมื่อคลิกครีเอทีฟโฆษณาในแอป โปรดทราบว่า Safari View Controller ในอุปกรณ์ iOS 9.x ถือเป็น เบราว์เซอร์ดั้งเดิมสำหรับวัตถุประสงค์ของช่องนี้ |
secure |
จำนวนเต็ม |
หากการแสดงผลนี้ต้องใช้ URL แบบ HTTPS ที่ปลอดภัย หรือ URL แบบ HTTP ที่ไม่ปลอดภัย0 (ค่าเริ่มต้น):insecure1 : secure
|
iframebuster |
อาร์เรย์สตริง | |
exp |
จำนวนเต็ม | DV360 จะกำหนดการหมดอายุของการเสนอราคาโดยไม่คำนึงถึงค่าที่พาร์ทเนอร์ส่งในช่องนี้ ระบบจะทิ้งเหตุการณ์การแสดงผลที่ได้รับหลังจากกรอบเวลาความล้าสมัยของการแสดงผล (โดยทั่วไปคือ 1 ชั่วโมง) เนื่องจากล้าสมัย และ DV360 จะไม่ถือว่าเหตุการณ์ดังกล่าวเรียกเก็บเงินได้ |
rwdd |
จำนวนเต็ม |
ระบุว่าผู้ใช้จะได้รับรางวัลจากการดูโฆษณาหรือไม่0 (ค่าเริ่มต้น): ไม่มีการให้รางวัล1 : มีการให้รางวัล
โดยปกติแล้ว การติดตั้งใช้งานโฆษณาวิดีโอจะช่วยให้ผู้ใช้อ่านบทความข่าวเพิ่มเติมได้ฟรี รับชีวิตเพิ่มในเกม หรือรับเซสชันเพลงแบบไม่มีโฆษณาที่ได้รับการสนับสนุน โดยปกติแล้ว ระบบจะแจกจ่ายรางวัลหลังจากดูโฆษณาวิดีโอ จนจบ |
ออบเจ็กต์ส่วนขยาย Imp
ช่อง | ประเภท | รายละเอียด |
---|---|---|
bcrid |
สตริง | รายการรหัสครีเอทีฟโฆษณาที่ควรบล็อก |
ออบเจ็กต์แบนเนอร์
ช่อง | ประเภท | รายละเอียด |
---|---|---|
format |
อาร์เรย์รูปแบบ | รายการรูปแบบที่รองรับ |
w |
จำนวนเต็ม |
format แทน
|
h |
จำนวนเต็ม |
format แทน
|
wmax |
จำนวนเต็ม | ไม่รองรับ |
hmax |
จำนวนเต็ม | ไม่รองรับ |
wmin |
จำนวนเต็ม | ไม่รองรับ |
hmin |
จำนวนเต็ม | ไม่รองรับ |
btype |
อาร์เรย์จำนวนเต็ม |
รายการประเภทโฆษณาแบนเนอร์ที่ถูกบล็อก
|
battr |
อาร์เรย์จำนวนเต็ม | รองรับค่าต่อไปนี้
|
pos |
จำนวนเต็ม |
ตำแหน่งของโฆษณา
|
mimes |
อาร์เรย์สตริง |
ไม่รองรับ
DV360 จะใช้ข้อความ/html สำหรับครีเอทีฟโฆษณาแบนเนอร์ทั้งหมด |
topframe |
จำนวนเต็ม |
0 (ค่าเริ่มต้น): ระบบจะแสดงแบนเนอร์ใน iframe1 : ไม่รองรับ: ระบบแสดงแบนเนอร์ในเฟรมบน
|
expdir |
อาร์เรย์จำนวนเต็ม |
1 : ซ้าย2 : ขวา3 : ขึ้น4 : ลง5 : เต็มหน้าจอแบบขยายได้
|
api |
อาร์เรย์จำนวนเต็ม |
เฟรมเวิร์ก API ที่รองรับ
|
id |
สตริง |
ตัวระบุสำหรับออบเจ็กต์แบนเนอร์และควรไม่ซ้ำกันในการแสดงผล
แนะนําเมื่อใช้ออบเจ็กต์ |
vcm |
จำนวนเต็ม |
เกี่ยวข้องกับ 0 : แบนเนอร์จะแสดงพร้อมกับครีเอทีฟโฆษณาวิดีโอ1 : แบนเนอร์คือการ์ดตอนจบหลังวิดีโอ
|
จัดรูปแบบออบเจ็กต์
ช่อง | ประเภท | รายละเอียด |
---|---|---|
w |
จำนวนเต็ม | ความกว้างเป็นพิกเซลอิสระของอุปกรณ์ (DIPS) |
h |
จำนวนเต็ม | ความสูงเป็นพิกเซลอิสระของอุปกรณ์ (DIP) |
wratio |
จำนวนเต็ม | ไม่รองรับ |
hratio |
จำนวนเต็ม | ไม่รองรับ |
wmin |
จำนวนเต็ม | ไม่รองรับ |
ออบเจ็กต์วิดีโอ
เราขอแนะนำอย่างยิ่งให้ระบุตําแหน่งวิดีโอในคําขอราคาเสนอ ระบบจะจัดประเภทฟิลด์ตำแหน่งที่ขาดหายไปเป็นตำแหน่งที่ไม่รู้จัก ดูรายละเอียดเพิ่มเติมได้ในบทความเกี่ยวกับการกำหนดเป้าหมายตามตำแหน่ง
ช่อง | ประเภท | รายละเอียด |
---|---|---|
mimes |
อาร์เรย์สตริง |
ต้องระบุประเภท MIME อย่างน้อย 1 ประเภท
|
minduration |
จำนวนเต็ม | ระยะเวลาขั้นต่ำของวิดีโอเป็นวินาที ค่าเริ่มต้นคือไม่มีขั้นต่ำ |
maxduration |
จำนวนเต็ม | ระยะเวลาสูงสุดของวิดีโอเป็นวินาที โดยค่าเริ่มต้นคือไม่มีระยะเวลาสูงสุด |
protocols |
อาร์เรย์จำนวนเต็ม |
ต้องระบุโปรโตคอลที่รองรับอย่างน้อย 1 รายการ
|
w |
จำนวนเต็ม | ความกว้างของวิดีโอเพลเยอร์ในหน่วยพิกเซลอิสระของอุปกรณ์ (DIP) |
h |
จำนวนเต็ม | ความสูงของวิดีโอเพลเยอร์ในหน่วยพิกเซลอิสระของอุปกรณ์ (DIP) |
startdelay |
จำนวนเต็ม | เริ่มหน่วงเวลาเป็นวินาทีสำหรับตำแหน่งโฆษณาตอนต้น ตอนกลาง หรือตอนท้าย |
placement |
จำนวนเต็ม | ขอแนะนำอย่างยิ่งให้ระบุ plcmt (และ/หรือ) ตำแหน่งของวิดีโอในคำขอราคาเสนอ
หากไม่มีทั้ง 2 ช่อง ระบบจะจัดประเภทเป็นตําแหน่งที่ไม่รู้จัก
|
plcmt |
จำนวนเต็ม | ขอแนะนำอย่างยิ่งให้ระบุ plcmt (และ/หรือ) ตำแหน่งของวิดีโอในคำขอราคาเสนอ
หากไม่มีทั้ง 2 ช่อง ระบบจะจัดประเภทเป็นตําแหน่งที่ไม่รู้จัก
หมายเหตุ: หากต้องการให้ระบบพิจารณาเป็นโฆษณาวิดีโอในสตรีม (ตำแหน่งหรือประเภท Plcmt 1) ต้องตั้งค่าตำแหน่ง/การแสดงผลวิดีโอเป็น "เปิดเสียง" และส่งสัญญาณอย่างถูกต้องในวิธีการเล่น (ค่า 1, 3, 4 และ 5 มีสิทธิ์ทั้งหมด)
หมายเหตุ: หากระบุทั้ง plcmt: Accompanying Content (2) ถือเป็น placement: In Article (3) plcmt: No Content/Standalone (4) ถือเป็น placement: In feed (4) placement: In Banner ไม่มีแมปใน plcmt
|
linearity |
จำนวนเต็ม | ไม่รองรับ |
skip |
จำนวนเต็ม |
หากวิดีโอเพลเยอร์จะอนุญาตให้ข้ามโฆษณา
|
skipmin |
จำนวนเต็ม | ไม่รองรับ |
skipafter |
จำนวนเต็ม | ไม่รองรับ |
sequence |
จำนวนเต็ม | หากมีการเสนอการแสดงโฆษณาหลายครั้งในคำขอราคาเสนอเดียวกัน หมายเลขลำดับจะช่วยให้ส่งครีเอทีฟโฆษณาหลายรายการ ได้อย่างสอดคล้องกัน |
battr |
อาร์เรย์จำนวนเต็ม | แอตทริบิวต์ครีเอทีฟโฆษณาที่ถูกบล็อก |
maxextended |
จำนวนเต็ม |
ระยะเวลาสูงสุดของโฆษณาวิดีโอแบบขยาย หากอนุญาตให้ขยาย
|
minbitrate |
จำนวนเต็ม | อัตราบิตขั้นต่ำในหน่วย Kbps |
maxbitrate |
จำนวนเต็ม | อัตราบิตสูงสุดในหน่วย Kbps |
boxingallowed |
จำนวนเต็ม |
ระบุว่าอนุญาตให้แสดงเนื้อหา 4:3 ในหน้าต่าง 16:9 โดยมีแถบดำด้านบนและด้านล่างหรือไม่
|
playbackmethod |
อาร์เรย์จำนวนเต็ม |
วิธีการเล่นที่อาจมีการใช้งาน หากไม่ได้ระบุ ระบบจะใช้วิธีการใดก็ได้
|
playbackend |
จำนวนเต็ม |
เหตุการณ์ที่ทำให้การเล่นสิ้นสุด
|
delivery |
อาร์เรย์จำนวนเต็ม | วิธีการนำส่งที่รองรับ หากไม่ได้ระบุ ให้ถือว่ารองรับทั้งหมด
|
pos |
จำนวนเต็ม |
ตำแหน่งโฆษณาบนหน้าจอ
|
companionad |
อาร์เรย์ Banner | โฆษณาที่แสดงร่วม (หากมี) |
api |
อาร์เรย์จำนวนเต็ม |
|
companiontype |
อาร์เรย์จำนวนเต็ม | ไม่รองรับ |
maxseq |
จำนวนเต็ม | จำนวนโฆษณาสูงสุดที่จะแสดงในพ็อดวิดีโอแบบไดนามิก |
poddur |
อาร์เรย์จำนวนเต็ม | ความยาวสูงสุดของพ็อดวิดีโอแบบไดนามิกเป็นวินาที |
นามสกุลที่รองรับสำหรับออบเจ็กต์วิดีโอ
ช่อง | ประเภท | รายละเอียด |
---|---|---|
rewarded |
จำนวนเต็ม | ฟิลด์นี้ใช้เพื่อส่งสัญญาณว่าคำขอได้รับรางวัลหรือไม่ ควรส่งเป็นจำนวนเต็ม
|
ออบเจ็กต์เสียง
ช่อง | ประเภท | รายละเอียด |
---|---|---|
mimes |
อาร์เรย์สตริง |
ต้องระบุประเภท MIME อย่างน้อย 1 ประเภท
|
minduration |
จำนวนเต็ม | ระยะเวลาโฆษณาขั้นต่ำเป็นวินาที |
maxduration |
จำนวนเต็ม | ระยะเวลาโฆษณาสูงสุดเป็นวินาที |
protocols |
อาร์เรย์จำนวนเต็ม |
|
startdelay |
จำนวนเต็ม | การหน่วงเวลาเริ่มต้นเป็นวินาทีสำหรับตำแหน่งโฆษณาตอนต้น ตอนกลาง หรือตอนท้าย
|
sequence |
จำนวนเต็ม | ไม่รองรับ |
battr |
อาร์เรย์จำนวนเต็ม | ไม่รองรับ |
maxextended |
จำนวนเต็ม | ไม่รองรับ |
minbitrate |
จำนวนเต็ม | อัตราบิตขั้นต่ำในหน่วย Kbps |
maxbitrate |
จำนวนเต็ม | อัตราบิตสูงสุดในหน่วย Kbps |
delivery |
อาร์เรย์จำนวนเต็ม | ไม่รองรับ |
companionad |
อาร์เรย์ออบเจ็กต์แบนเนอร์ | ช่องครีเอทีฟโฆษณาที่แสดงร่วมที่เป็นแบนเนอร์ |
api |
อาร์เรย์จำนวนเต็ม |
รายการเฟรมเวิร์ก API ที่รองรับสําหรับการแสดงผลนี้
|
companiontype |
อาร์เรย์จำนวนเต็ม | ไม่รองรับ |
maxseq |
อาร์เรย์จำนวนเต็ม | ไม่รองรับ |
feed |
จำนวนเต็ม |
ประเภทของฟีดเสียง
|
stitched |
จำนวนเต็ม | ไม่รองรับ |
nvol |
จำนวนเต็ม | ไม่รองรับ |
ออบเจ็กต์เนทีฟ
ดูรายละเอียดเพิ่มเติมได้ที่ข้อกำหนดของโฆษณาเนทีฟ DV360
ช่อง | ประเภท | รายละเอียด |
---|---|---|
request |
สตริง | สตริงที่เข้ารหัสออบเจ็กต์ JSON ดั้งเดิม |
ver |
สตริง |
1.0 : ไม่รองรับ1.1 : ไม่รองรับ1.2
|
api |
อาร์เรย์จำนวนเต็ม |
รายการเฟรมเวิร์ก API ที่รองรับสําหรับการแสดงผลนี้
|
battr |
อาร์เรย์จำนวนเต็ม | ไม่รองรับ |
ออบเจ็กต์ PMP
ช่อง | ประเภท | รายละเอียด |
---|---|---|
private_auction |
จำนวนเต็ม |
0 (ค่าเริ่มต้น): อนุญาตราคาเสนอทั้งหมด1 : ดีลเท่านั้น
|
deals |
อาร์เรย์ออบเจ็กต์ดีล | ดีลที่จะรวม |
ออบเจ็กต์ดีล
ช่อง | ประเภท | รายละเอียด |
---|---|---|
id |
สตริง | ออบเจ็กต์ PMP ต้องมีออบเจ็กต์ดีลไม่เกิน 1 รายการต่อรหัส |
bidfloor |
ดับเบิล |
ราคาเสนอขั้นต่ำสำหรับการแสดงผลนี้ใน CPM
ต้องระบุหากมี |
bidfloorcur |
สตริง |
สกุลเงินที่ระบุโดยใช้รหัสตัวอักษร ISO-4217
หากไม่ได้ระบุไว้ ค่าเริ่มต้นจะเป็นสกุลเงินของคำขอเสนอราคา |
at |
จำนวนเต็ม |
ค่าเริ่มต้นคือ bid_request.at หากไม่ได้ระบุ
|
wseat |
อาร์เรย์สตริง |
รหัสพาร์ทเนอร์ของพาร์ทเนอร์ที่มีสิทธิ์สำหรับดีล
ไม่มีที่นั่งหมายความว่าไม่มีข้อจำกัดเกี่ยวกับที่นั่ง |
wadomain |
อาร์เรย์สตริง |
โดเมนของผู้ลงโฆษณาที่ได้รับอนุญาตให้เสนอราคาในดีลนี้
การไม่มีที่นั่งหมายความว่าไม่มีข้อจำกัดของโดเมน |
guar |
จำนวนเต็ม |
ฟิลด์นี้ใช้เพื่อส่งสัญญาณว่าดีลเป็นดีลที่รับประกันหรือไม่ ควรส่งเป็นจำนวนเต็ม
การแลกเปลี่ยนต้องอยู่ในรายการที่อนุญาตเพื่อให้ DV360 ยอมรับดีลที่มีการรับประกัน ติดต่อเพื่อขอดีลนี้ หากปัจจุบันการแลกเปลี่ยนของคุณใช้กลไกอื่นในการส่งสัญญาณดีลที่รับประกัน กับ DV360 โปรดติดต่อ เพื่อหารือเกี่ยวกับการเปลี่ยนไปใช้ส่วนขยายที่ต้องการนี้
|
ext |
ส่วนขยายดีล | ไม่บังคับ |
ส่วนขยายที่รองรับสำหรับออบเจ็กต์ดีล
ช่อง | ประเภท | รายละเอียด |
---|---|---|
guaranteed |
จำนวนเต็ม |
ฟิลด์นี้ใช้เพื่อส่งสัญญาณว่าดีลเป็นดีลที่รับประกันหรือไม่ ควรส่งเป็นจำนวนเต็ม
การแลกเปลี่ยนต้องอยู่ในรายการที่อนุญาตเพื่อให้ DV360 ยอมรับดีลที่มีการรับประกัน ติดต่อเพื่อขอดีลนี้ หากปัจจุบันการแลกเปลี่ยนของคุณใช้กลไกอื่นในการส่งสัญญาณดีลที่รับประกัน กับ DV360 โปรดติดต่อ เพื่อหารือเกี่ยวกับการเปลี่ยนไปใช้ส่วนขยายที่ต้องการนี้
ขอแนะนำให้ใช้ |
ออบเจ็กต์เว็บไซต์
ช่อง | ประเภท | รายละเอียด |
---|---|---|
id |
สตริง | รหัสของเว็บไซต์ใน Exchange |
name |
สตริง | ไม่รองรับ |
domain |
สตริง |
โดเมนของเว็บไซต์
เราขอแนะนำให้ส่ง URL แบบเต็มใน site.page แทนการระบุเฉพาะ site.domain |
cat |
อาร์เรย์สตริง | ไม่รองรับ |
sectioncat |
อาร์เรย์สตริง | ไม่รองรับ |
pagecat |
อาร์เรย์สตริง | ไม่รองรับ |
page |
สตริง |
URL แบบเต็มที่จะแสดงอิมเพรสชัน
เราขอแนะนำให้ส่ง URL แบบเต็มเพื่อวัตถุประสงค์ในการกำหนดเป้าหมาย |
ref |
สตริง | URL ของผู้เข้าชมที่ทําให้เกิดการนําทางไปยังหน้าปัจจุบัน |
search |
สตริง | ไม่รองรับ |
mobile |
จำนวนเต็ม | ไม่รองรับ |
privacypolicy |
จำนวนเต็ม | ไม่รองรับ |
publisher |
ออบเจ็กต์ผู้เผยแพร่โฆษณา | รายละเอียดเกี่ยวกับผู้เผยแพร่เว็บไซต์ |
content |
ออบเจ็กต์เนื้อหา | รายละเอียดเกี่ยวกับเนื้อหาภายในเว็บไซต์ |
keywords |
สตริง (รูปแบบ CSV) | ไม่รองรับ |
ext |
ส่วนขยายเว็บไซต์ | ส่วนขยายสำหรับออบเจ็กต์เว็บไซต์ |
ออบเจ็กต์ส่วนขยายเว็บไซต์
ช่อง | ประเภท | รายละเอียด |
---|---|---|
inventorypartnerdomain |
สตริง | ใช้สำหรับการแชร์พื้นที่โฆษณา CTV โปรดดู คำอธิบายเพิ่มเติมเกี่ยวกับแอป CTV ของ IAB |
ออบเจ็กต์แอป
ช่อง | ประเภท | รายละเอียด |
---|---|---|
id |
สตริง | รหัสแอปพลิเคชันใน Exchange |
name |
สตริง |
ชื่อแอปพลิเคชัน ซึ่งอาจมีการตั้งชื่อแทนตามคำขอของผู้เผยแพร่โฆษณา
ผู้เผยแพร่โฆษณาสามารถระบุชื่อแอปสำหรับคำขอที่ไม่ใช้ SDK (ส่วนใหญ่เป็นทีวีที่เชื่อมต่ออินเทอร์เน็ต) ได้โดยตรงในคำขอ |
bundle |
สตริง |
ต้องระบุ
สำหรับ iOS จะต้องเป็นรหัส App Store ที่เป็นตัวเลข เราไม่ยอมรับรหัสชุดซอฟต์แวร์รูปแบบ DNS ย้อนกลับ สําหรับแอป CTV เราขอแนะนําให้ ส่งตัวระบุแอปที่กำหนดโดย Store โปรดปฏิบัติตาม หลักเกณฑ์เกี่ยวกับรหัสที่กำหนดโดยร้านค้าของ IAB OTT/CTV ที่เผยแพร่เมื่อเร็วๆ นี้ |
domain |
สตริง | เช่น โดเมน mygame.foo.com |
storeurl |
สตริง | จำเป็นสำหรับการยืนยัน app-ads.txt และการตรวจสอบ App Store ของทีวีที่เชื่อมต่ออินเทอร์เน็ต |
cat |
อาร์เรย์สตริง | ไม่รองรับ |
sectioncat |
อาร์เรย์สตริง | ไม่รองรับ |
pagecat |
อาร์เรย์สตริง | ไม่รองรับ |
ver |
สตริง | ไม่รองรับ |
privacypolicy |
จำนวนเต็ม | ไม่รองรับ |
paid |
จำนวนเต็ม | ไม่รองรับ |
publisher |
ออบเจ็กต์ผู้เผยแพร่โฆษณา | ข้อมูลเกี่ยวกับผู้เผยแพร่แอป |
content |
ออบเจ็กต์เนื้อหา | ข้อมูลเกี่ยวกับเนื้อหาของแอป |
keywords |
สตริง (รูปแบบ CSV) | ไม่รองรับ |
ext |
ส่วนขยายแอป | ส่วนขยายสำหรับออบเจ็กต์แอป |
ออบเจ็กต์ส่วนขยายแอป
ช่อง | ประเภท | รายละเอียด |
---|---|---|
inventorypartnerdomain |
สตริง | ใช้สำหรับการแชร์พื้นที่โฆษณา CTV โปรดดู คำอธิบายเพิ่มเติมเกี่ยวกับแอป CTV ของ IAB |
ออบเจ็กต์เนื้อหา
เราขอแนะนำให้ส่งแอตทริบิวต์เหล่านี้หากมี
ช่อง | ประเภท | รายละเอียด |
---|---|---|
id |
สตริง | รหัสที่ระบุเนื้อหาได้อย่างไม่ซ้ำกัน |
episode |
จำนวนเต็ม | หมายเลขตอนของเนื้อหา (โดยปกติจะใช้กับเนื้อหาวิดีโอ) |
title |
สตริง | แนะนำสำหรับคำขอ CTV, วิดีโอ และเสียง |
series |
สตริง | แนะนำสำหรับคำขอ CTV, วิดีโอ และเสียง |
season |
สตริง | ป้ายกำกับสำหรับซีซันของเนื้อหา |
artist |
สตริง | ศิลปินที่ได้รับเครดิตในเนื้อหา |
genre |
สตริง | ประเภทที่อธิบายเนื้อหาได้ดีที่สุด DV360 ขอแนะนําให้ระบุสัญญาณนี้สําหรับคําขอ CTV, วิดีโอ และเสียง
DV360 รองรับอนุกรมวิธานค่าประเภทวิดีโอ 2-3 รายการสำหรับฟิลด์นี้ |
album |
สตริง | อัลบั้มที่เนื้อหาอยู่ โดยปกติแล้วจะเป็นเนื้อหาเสียง |
isrc |
สตริง | รหัสการบันทึกมาตรฐานสากลที่สอดคล้องกับ ISO-3901 |
producer |
ออบเจ็กต์ Producer | รายละเอียดเกี่ยวกับผู้ผลิตเนื้อหา |
url |
สตริง | URL ของเนื้อหา |
cat |
อาร์เรย์สตริง | หมวดหมู่เนื้อหาของ IAB ที่อธิบายเนื้อหา |
prodq |
จำนวนเต็ม |
คุณภาพการผลิต
|
videoquality |
จำนวนเต็ม | ไม่รองรับ |
context |
จำนวนเต็ม |
ประเภทเนื้อหา:
|
contentrating |
สตริง | แนะนำสำหรับเสียงและวิดีโอ/CTV เนื่องจากเราจะเริ่มพิจารณาแอตทริบิวต์นี้ |
userrating |
สตริง | จำนวนดาว การกดชอบ ฯลฯ |
qagmediarating |
จำนวนเต็ม |
การจัดประเภทสื่อตาม[หลักเกณฑ์ของ QAG](http://www.iab.net/ne_guidelines)
|
keywords |
สตริง (รูปแบบ CSV) | ไม่รองรับ |
livestream |
จำนวนเต็ม |
หากเนื้อหาเป็นเนื้อหาสตรีมแบบสด
|
sourcerelationship |
จำนวนเต็ม |
|
len |
จำนวนเต็ม |
ความยาวของเนื้อหาเป็นวินาที
แนะนำสำหรับคำขอ CTV/วิดีโอและเสียง |
language |
สตริง (ISO-639-1-alpha-2) | ภาษาของเนื้อหา |
embeddable |
จำนวนเต็ม |
ตัวบ่งชี้ว่าฝังเนื้อหาได้หรือไม่ (เช่น โปรแกรมเล่นวิดีโอแบบฝัง)
|
data |
อาร์เรย์ของออบเจ็กต์ข้อมูล | ข้อมูลเพิ่มเติม |
ออบเจ็กต์ผู้ผลิต
ช่อง | ประเภท | รายละเอียด |
---|---|---|
id |
สตริง | ไม่รองรับ |
name |
สตริง | ไม่รองรับ |
cat |
อาร์เรย์สตริง | ไม่รองรับ |
domain |
สตริง | โดเมนระดับสูงสุดของผู้ผลิต |
ออบเจ็กต์ข้อมูล
ช่อง | ประเภท | รายละเอียด |
---|---|---|
id |
สตริง | รหัสของผู้ให้บริการข้อมูล |
name |
สตริง | ชื่อการแลกเปลี่ยนสำหรับผู้ให้บริการข้อมูล |
segment |
อาร์เรย์ของออบเจ็กต์กลุ่ม | ค่าข้อมูลจริง |
ext |
ส่วนขยายข้อมูล | ส่วนขยายสำหรับออบเจ็กต์ข้อมูล |
ส่วนขยายที่รองรับสำหรับออบเจ็กต์ข้อมูล
ช่อง | ประเภท | รายละเอียด |
---|---|---|
segtax |
จำนวนเต็ม | รหัสการจัดหมวดหมู่ ดูรายละเอียดเพิ่มเติมได้ที่การจัดหมวดหมู่กลุ่มเป้าหมาย |
segclass |
สตริง | เวอร์ชันของเครื่องมือแยกประเภทที่สร้างรหัสกลุ่มภายในอนุกรมวิธาน |
ออบเจ็กต์กลุ่ม
ช่อง | ประเภท | รายละเอียด |
---|---|---|
id |
สตริง | รหัสของกลุ่มข้อมูลที่เฉพาะเจาะจงสำหรับผู้ให้บริการข้อมูล |
name |
สตริง | ชื่อกลุ่มข้อมูล |
value |
สตริง | ค่าของกลุ่มข้อมูล |
ออบเจ็กต์ผู้เผยแพร่โฆษณา
ช่อง | ประเภท | รายละเอียด |
---|---|---|
id |
สตริง | ต้องระบุ |
name |
สตริง | ไม่รองรับ |
cat |
อาร์เรย์สตริง | ไม่รองรับ |
domain |
สตริง | ไม่รองรับ |
ออบเจ็กต์อุปกรณ์
ช่อง | ประเภท | รายละเอียด |
---|---|---|
ua |
สตริง | ต้องระบุ |
sua |
ออบเจ็กต์ UserAgent | ข้อมูล User Agent ที่มีโครงสร้าง |
geo |
ออบเจ็กต์ทางภูมิศาสตร์ | ตำแหน่งของอุปกรณ์ |
dnt |
จำนวนเต็ม |
ค่าสถานะห้ามติดตามตามที่ตั้งค่าไว้ในส่วนหัวของเบราว์เซอร์
|
lmt |
จำนวนเต็ม |
สัญญาณการติดตามโฆษณาแบบจำกัดที่ได้รับการรับรองในเชิงพาณิชย์
|
ip |
สตริง |
ต้องระบุหากเป็น IPv4
หากมีการตัดที่อยู่ IP คุณต้องประกาศใน |
ipv6 |
สตริง |
ต้องระบุหากเป็น IPv6
หากมีการตัดที่อยู่ IP คุณต้องประกาศใน |
devicetype |
จำนวนเต็ม | แนะนำอย่างยิ่งสำหรับพื้นที่โฆษณาทุกประเภท ใช้เพื่อปรับปรุงการจดจำประเภทอุปกรณ์ |
make |
สตริง | |
model |
สตริง | |
os |
สตริง |
ระบบปฏิบัติการของอุปกรณ์
ช่องนี้ไม่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ |
osv |
สตริง | ไม่รองรับ |
hwv |
สตริง | เวอร์ชันฮาร์ดแวร์ของอุปกรณ์ |
h |
จำนวนเต็ม | ความสูงจริงของหน้าจอเป็นพิกเซล |
w |
จำนวนเต็ม | ความกว้างจริงของหน้าจอในหน่วยพิกเซล |
ppi |
จำนวนเต็ม | ไม่รองรับ |
pxratio |
ดับเบิล | อัตราส่วนของพิกเซลจริงต่อพิกเซลอิสระของอุปกรณ์ |
js |
จำนวนเต็ม | ไม่รองรับ |
geofetch |
จำนวนเต็ม | ไม่รองรับ |
flashver |
สตริง | ไม่รองรับ |
language |
สตริง (ISO-639-1-alpha-2) | ภาษาของอุปกรณ์ |
carrier |
สตริง | ไม่รองรับ |
mccmnc |
สตริง | ไม่รองรับ |
connectiontype |
จำนวนเต็ม | ประเภทการเชื่อมต่อเครือข่าย |
ifa |
สตริง | รหัสที่ได้รับอนุญาตให้ผู้ลงโฆษณาใช้ได้อย่างชัดเจน |
didsha1 |
สตริง | ไม่รองรับ |
didmd5 |
สตริง | ไม่รองรับ |
dpidsha1 |
สตริง | ไม่รองรับ |
dpidmd5 |
สตริง | ไม่รองรับ |
macsha1 |
สตริง | ไม่รองรับ |
macmd5 |
สตริง | ไม่รองรับ |
ext |
ส่วนขยายอุปกรณ์ | ส่วนขยายสำหรับออบเจ็กต์อุปกรณ์ |
ส่วนขยายที่รองรับสำหรับออบเจ็กต์อุปกรณ์
หากมีการเปลี่ยนแปลงหรือตัดทอน ip
เราขอแนะนำให้ส่งส่วนขยายต่อไปนี้
เพื่อป้องกันไม่ให้ระบบประกาศว่าการเข้าชมเป็นการเข้าชมที่ไม่ถูกต้อง
ช่อง | ประเภท | รายละเอียด |
---|---|---|
truncated_ip |
จำนวนเต็ม |
ระบุว่าที่อยู่ IP ในช่อง device.ip ของ
คำขอราคาเสนอถูกตัดทอนหรือไม่
ค่าเริ่มต้นคือไม่ตัดทอน และต้องระบุหากมีการตัดทอนที่อยู่ IP หากไม่ได้ประกาศ ระบบอาจจัดประเภทคำขอราคาเสนอเป็นการเข้าชมที่ไม่ถูกต้อง |
ifa_type |
สตริง |
ระบุแหล่งที่มาของฟิลด์ device.ifa ไม่ว่าจะมาจาก
อุปกรณ์เอง หรือสร้างโดยผู้เผยแพร่โฆษณาหรือ SSP ในซัพพลายเชน
|
attestation_token |
สตริง (การเข้ารหัส Base64) | โทเค็นการรับรองตามอุปกรณ์สำหรับการแลกเปลี่ยนที่รองรับการตรวจสอบอุปกรณ์ระดับนั้น |
atts |
จำนวนเต็ม |
(iOS เท่านั้น) จำนวนเต็มที่ส่งผ่านเพื่อแสดงสถานะการให้สิทธิ์การติดตามแอปของแอป
|
cdep |
สตริง |
ป้ายกำกับการเลิกใช้งานคุกกี้ของบุคคลที่สามใน Chrome
ดู การทดสอบที่ Chrome ช่วยอำนวยความสะดวกและ ข้อกำหนดของชุมชน IAB |
ออบเจ็กต์ UserAgent
ช่อง | ประเภท | รายละเอียด |
---|---|---|
browsers |
อาร์เรย์ของออบเจ็กต์ BrandVersion | ออบเจ็กต์ BrandVersion แต่ละรายการจะระบุเบราว์เซอร์หรือซอฟต์แวร์ที่คล้ายกัน |
platform |
ออบเจ็กต์ BrandVersion | ระบุแพลตฟอร์ม |
mobile |
จำนวนเต็ม |
0 (ค่าเริ่มต้น): ตัวแทนต้องการเนื้อหา "เดสก์ท็อป" หรือ "เต็ม"
1 : ตัวแทนต้องการเนื้อหา "อุปกรณ์เคลื่อนที่"
|
architecture |
สตริง | สถาปัตยกรรมของอุปกรณ์ เช่น "x86" หรือ "arm" |
bitness |
สตริง | บิตของอุปกรณ์ เช่น "64" สำหรับสถาปัตยกรรม 64 บิต |
model |
สตริง | รุ่นอุปกรณ์ |
source |
จำนวนเต็ม | แหล่งที่มาของข้อมูลที่ใช้สร้างออบเจ็กต์นี้ โปรดดู รายการ: แหล่งที่มาของ User-Agent แนะนำเมื่อส่ง ออบเจ็กต์ UserAgent |
ออบเจ็กต์ BrandVersion
ช่อง | ประเภท | รายละเอียด |
---|---|---|
brand |
สตริง | ตัวระบุแบรนด์ เช่น "Chrome" หรือ "Windows" ต้องระบุ |
version |
อาร์เรย์สตริง | ลำดับของคอมโพเนนต์เวอร์ชันตามลำดับชั้นจากมากไปน้อย (หลัก ย่อย ไมโคร และอื่นๆ) |
ออบเจ็กต์ทางภูมิศาสตร์
ช่อง | ประเภท | รายละเอียด |
---|---|---|
lat |
ดับเบิล | ไม่รองรับ |
lon |
ดับเบิล | ไม่รองรับ |
type |
จำนวนเต็ม | ไม่รองรับ |
accuracy |
จำนวนเต็ม | ไม่รองรับ |
lastfix |
จำนวนเต็ม | ไม่รองรับ |
ipservice |
จำนวนเต็ม | ไม่รองรับ |
country |
สตริง | ไม่รองรับ |
region |
สตริง | ไม่รองรับ |
regionfips104 |
สตริง | ไม่รองรับ |
metro |
สตริง | ไม่รองรับ |
city |
สตริง | ไม่รองรับ |
zip |
สตริง | ไม่รองรับ |
utcoffset |
จำนวนเต็ม | ไม่รองรับ |
ออบเจ็กต์ผู้ใช้
ช่อง | ประเภท | รายละเอียด |
---|---|---|
id |
สตริง | รองรับหาก Google โฮสต์ตารางการจับคู่รหัส |
buyeruid |
สตริง | รองรับในกรณีที่ SSP โฮสต์ตารางการจับคู่รหัส |
yob |
จำนวนเต็ม | แนะนำสำหรับการกำหนดเป้าหมายตามข้อมูลประชากร |
gender |
สตริง | แนะนำสำหรับการกำหนดเป้าหมายตามข้อมูลประชากร |
keywords |
สตริง (CSV) | ไม่รองรับ |
customdata |
สตริง | ไม่รองรับ |
geo |
ออบเจ็กต์ทางภูมิศาสตร์ | ไม่รองรับ |
data |
อาร์เรย์ของออบเจ็กต์ข้อมูล | ข้อมูลเพิ่มเติม |
eids |
อาร์เรย์ของออบเจ็กต์รหัสเพิ่มเติม | อินสแตนซ์รหัสแบบขยายที่แลกเปลี่ยนให้ |
ext |
ส่วนขยายผู้ใช้ | ส่วนขยายสำหรับออบเจ็กต์ผู้ใช้ |
ส่วนขยายที่รองรับสำหรับออบเจ็กต์ผู้ใช้
ช่อง | ประเภท | รายละเอียด |
---|---|---|
consent |
สตริง (Base64 ที่ปลอดภัยบนเว็บ) |
สตริงความยินยอมของ IAB
มีข้อมูลเมตาเกี่ยวกับข้อมูลที่ผู้ใช้ยินยอมให้เก็บรวบรวม และผู้ให้บริการที่ได้รับอนุญาตให้ใช้ข้อมูลดังกล่าว ค่านี้คือสตริงไบนารีที่เข้ารหัส Web-safe base64 โดยใช้รูปแบบไบนารีที่กำหนดเอง |
us_privacy |
สตริง | หากผู้ใช้เห็นการปฏิบัติตามข้อกำหนดสำหรับ CCPA หรือกฎหมายที่คล้ายกัน |
consented_providers_settings .consented_providers |
ออบเจ็กต์ภายนอก (consented_providers_settings) ที่ครอบอาร์เรย์จำนวนเต็มภายใน (consented_providers) | เมื่อรวบรวมความยินยอมตาม GDPR ผ่าน TCF ฟิลด์นี้จะแสดงรายชื่อผู้ให้บริการเทคโนโลยีโฆษณาที่ได้รับความยินยอมจากผู้ใช้ซึ่งไม่ได้เข้าร่วม TCF ดู "ข้อกำหนดทางเทคนิคเกี่ยวกับความยินยอมเพิ่มเติมของ Google" |
eids |
อาร์เรย์ของออบเจ็กต์รหัสเพิ่มเติม | อินสแตนซ์รหัสแบบขยายที่แลกเปลี่ยนให้ |
ออบเจ็กต์รหัสแบบขยาย
ช่อง | ประเภท | รายละเอียด |
---|---|---|
source |
สตริง | ผู้ให้บริการตัวระบุ |
uids |
อาร์เรย์ของออบเจ็กต์ UID ของรหัสที่ขยาย | ตัวระบุจริง |
ออบเจ็กต์ UID ของรหัสแบบขยาย
ช่อง | ประเภท | รายละเอียด |
---|---|---|
id |
สตริง | ตัวระบุเอง |
atype |
จำนวนเต็ม | ประเภทของ User Agent ที่เชื่อมโยงกับรหัสนี้ |
ออบเจ็กต์ซัพพลายเชน
ช่อง | ประเภท | รายละเอียด |
---|---|---|
complete |
จำนวนเต็ม | 0 (ค่าเริ่มต้น): ซัพพลายเชนไม่สมบูรณ์1 : ซัพพลายเชนจะสมบูรณ์กลับไปที่ผู้เผยแพร่โฆษณา
|
ver |
สตริง | ต้องระบุ ค่าจะอยู่ในรูปแบบ "major.minor" เช่น เวอร์ชัน 1.0 คือ สตริง "1.0" |
nodes |
อาร์เรย์โหนดซัพพลายเชน | ต้องระบุ ในซัพพลายเชนที่สมบูรณ์ โหนดแรกแสดงถึงระบบโฆษณาและรหัสผู้ขายเริ่มต้นที่เกี่ยวข้องกับธุรกรรม นั่นคือ เจ้าของเว็บไซต์ แอป หรือสื่ออื่นๆ ในซัพพลายเชนที่ไม่สมบูรณ์ จะแสดงถึงโหนดแรกที่รู้จัก โหนดสุดท้ายแสดงถึงเอนทิตี ที่ส่งคำขอราคาเสนอนี้ |
ออบเจ็กต์โหนดซัพพลายเชน
ช่อง | ประเภท | รายละเอียด |
---|---|---|
asi |
สตริง | ชื่อโดเมน Canonical ของ SSP, Exchange, Header Wrapper ฯลฯ
ระบบที่ผู้เสนอราคาเชื่อมต่อ โดยอาจเป็นโดเมนการดำเนินงาน
ของระบบ หากแตกต่างจากโดเมนองค์กรหลัก
เพื่อสนับสนุน WHOIS และ Reverse IP Lookup ในการสร้างการเป็นเจ้าของที่ชัดเจน
ของระบบที่ได้รับมอบสิทธิ์
ค่านี้ควรเป็นค่าเดียวกับที่ใช้เพื่อระบุผู้ขายในไฟล์ ads.txt หากมี |
sid |
สตริง | ตัวระบุที่เชื่อมโยงกับบัญชีผู้ขายหรือตัวแทนจำหน่ายภายใน
ระบบโฆษณา ช่องนี้ต้องมีค่าเหมือนกับที่ใช้ใน
ธุรกรรม (เช่น คำขอราคาเสนอ OpenRTB) ในช่องที่ระบุโดย
SSP/Exchange
โดยปกติใน OpenRTB นี่คือ publisher.id สำหรับ OpenDirect โดยปกติแล้วจะเป็นรหัสองค์กรของผู้เผยแพร่โฆษณา ควรมีความยาวไม่เกิน 64 อักขระ |
rid |
สตริง | RequestId ของคำขอ OpenRTB ตามที่ผู้ขายนี้ออกให้ |
name |
สตริง | ชื่อบริษัท (นิติบุคคล) ที่ได้รับชำระเงินสำหรับพื้นที่โฆษณา
ที่ทำธุรกรรมภายใต้ seller_id ที่ระบุ ค่านี้ไม่บังคับและไม่ควรระบุหากมีอยู่ในไฟล์ sellers.json ของระบบโฆษณา |
domain |
สตริง | ชื่อโดเมนธุรกิจของเอนทิตีที่โหนดนี้เป็นตัวแทน
ค่านี้ไม่บังคับและไม่ควรระบุหากมีอยู่ใน ไฟล์ sellers.json ของระบบโฆษณา |
hp |
จำนวนเต็ม | ระบุว่าโหนดนี้จะมีส่วนร่วมในขั้นตอนการชำระเงินสำหรับพื้นที่โฆษณาหรือไม่
สำหรับ SupplyChain เวอร์ชัน 1.0 พร็อพเพอร์ตี้นี้ควรเป็น 1 เสมอ ต้องระบุอย่างชัดเจน เนื่องจากคาดว่าข้อกำหนดเวอร์ชันในอนาคต จะมีการนำโหนดการจัดการที่ไม่ใช่การชำระเงินมาใช้ ผู้ติดตั้งใช้งานควรตรวจสอบว่าตนรองรับฟิลด์นี้และส่งต่อ เมื่อสร้างออบเจ็กต์ SupplyChain ในคำขอราคาเสนอที่ส่ง ไปยังระบบโฆษณาดาวน์สตรีม |
ข้อกำหนดการเสนอราคาตอบ
ออบเจ็กต์ BidResponse
แอตทริบิวต์ | รองรับ | รายละเอียดการติดตั้งใช้งาน | ผ่านเสมอ |
---|---|---|---|
id | หากเกิดข้อผิดพลาดในการแยกวิเคราะห์ ค่านี้อาจเป็น "0" แทนที่จะเป็นรหัสคำขอเสนอราคา | ใช่ | |
seatbid | |||
bidid | |||
cur | หากเกิดข้อผิดพลาดในการแยกวิเคราะห์ ระบบจะไม่ส่งค่านี้ สําหรับการเข้าชมคําขอราคาเสนอที่ถูกต้อง ระบบจะระบุ cur เสมอ | ใช่ | |
customdata | |||
nbr |
ซึ่งจะรวมอยู่ด้วยก็ต่อเมื่อพบปัญหาเกี่ยวกับคำขอเสนอราคา ค่าที่เป็นไปได้ ได้แก่2 : คำขอไม่ถูกต้อง12 : การละเมิดการให้สิทธิ์ ads.txt16 : SupplyChain ไม่สมบูรณ์17 : โหนด SupplyChain ที่ถูกบล็อกหมายเหตุ: เมื่อตรวจพบการละเมิด (app-)ads.txt หรือ SupplyChain ที่เฉพาะเจาะจง ระบบจะป้อนรหัส 12, 16 หรือ 17 อย่างใดอย่างหนึ่งในเศษส่วน (1%) ของการตอบกลับ ระบบจะป้อนรหัส 2 สำหรับคำขอที่ไม่ถูกต้องอื่นๆ ทั้งหมด คำขอที่มี NBR จะมีลักษณะคล้ายกับตัวอย่างต่อไปนี้ { "id": "0", "nbr": 2, "ext": { "err": "Bid request body was empty.", "errHelp": "https://.../ortb-spec" } } |
||
ext | หากมีปัญหาเกี่ยวกับคำขอเสนอราคา ส่วนขยายอาจมีข้อมูลที่จะช่วยวินิจฉัยข้อผิดพลาดได้ในกรณีที่ระบบรองรับ |
ส่วนขยายที่รองรับสำหรับออบเจ็กต์ BidResponse
แอตทริบิวต์ | รายละเอียดการติดตั้งใช้งาน |
---|---|
err | คำอธิบายที่มนุษย์อ่านได้ของข้อผิดพลาดเกี่ยวกับคำขอราคาเสนอ กรณีการตอบกลับ มีดังนี้
|
errHelp | ลิงก์ไปยังหน้านี้ |
ออบเจ็กต์ Seatbid
แอตทริบิวต์ | รองรับ | รายละเอียดการติดตั้งใช้งาน | ผ่านเสมอ |
---|---|---|---|
ราคาเสนอ | ใช่ | ||
ที่นั่ง | ใช่ | ||
กลุ่ม |
ออบเจ็กต์การเสนอราคา
แอตทริบิวต์ | รองรับ | รายละเอียดการติดตั้งใช้งาน | ผ่านเสมอ |
---|---|---|---|
id | ใช่ | ||
impid | ใช่ | ||
ราคา | ใช่ | ||
nurl | |||
ปุ่ม | |||
lurl | |||
adm | |||
adid | |||
adomain | |||
กลุ่ม | |||
iurl | |||
cid | ใช่ | ||
crid | ใช่ | ||
กลยุทธ์ | |||
cat | |||
attr | |||
api | |||
โปรโตคอล | |||
qagmediarating | |||
ภาษา | |||
dealid | |||
w | |||
h | |||
wratio | |||
hratio | |||
exp |
ส่วนขยายที่รองรับสำหรับออบเจ็กต์การเสนอราคา
แอตทริบิวต์ | รายละเอียดการติดตั้งใช้งาน |
---|---|
apis |
DV360 จะส่ง seatbid.bid.apis หากรองรับทั้ง OMID และ MRAID
DV360 จะตั้งค่าทั้ง OMID_1 และ MRAID เป็นอาร์เรย์จำนวนเต็ม |
ตัวเลือกการแสดงโฆษณา
ในส่วนที่ 4.3 ของข้อกำหนด OpenRTB มีตัวเลือกการแสดงโฆษณา 2 แบบดังนี้
- มาร์กอัปที่แสดงในประกาศการชนะ
- มาร์กอัปที่แสดงในการเสนอราคา
DV360 รองรับทั้ง 2 ตัวเลือก
- สำหรับโฆษณาแบนเนอร์ DV360 จะแสดงมาร์กอัปในช่อง
adm
เสมอ มาร์กอัปที่แสดง ในประกาศการชนะเป็นตัวเลือกที่ไม่บังคับ - สำหรับโฆษณาวิดีโอ/เสียงที่ใช้โปรโตคอล VAST นั้น DV360 รองรับการส่งคืน VAST XML ในฟิลด์
adm
หรือในการตอบกลับของประกาศการชนะตามข้อกำหนดจากพาร์ทเนอร์การแลกเปลี่ยน
โปรดดูข้อกำหนด OpenRTB เพื่อทราบข้อดีและข้อเสียของตัวเลือกทั้ง 2
แนวทางปฏิบัติแนะนำ
ขอแนะนำอย่างยิ่งให้ใช้รหัสพาร์ทเนอร์ของ Display & Video 360 เป็น รหัสที่นั่ง ไม่แนะนําให้ใช้รหัสที่นั่งเฉพาะการแลกเปลี่ยน
ตรวจสอบว่าผู้เผยแพร่โฆษณามีไฟล์ ads.txt หรือแอปพลิเคชันที่มีไฟล์ app-ads.txt ที่เชื่อมโยงอยู่ และระบุคุณในไฟล์เป็นผู้ขายที่ได้รับอนุญาตหรือ ผู้ขายต่อ ดูข้อมูลเพิ่มเติม
นอกจากนี้ โปรดตรวจสอบว่ามีการส่งข้อมูลที่สอดคล้องกันในคำขอราคาเสนอ เช่น app.bundle
ต้องสอดคล้องกับข้อมูลอุปกรณ์เคลื่อนที่และapp.storeurl
ทีวีที่เชื่อมต่ออินเทอร์เน็ต
ปฏิบัติตามหลักเกณฑ์ IFA ของ IAB OTT
ในการส่ง device.ifa
และ device.lmt
นอกจากนี้ คุณควรใช้
device.ext.ifa_type
เพื่อให้เป็นไปตามหลักเกณฑ์ ความสามารถในการกำหนดความถี่สูงสุดและการกำหนดเป้าหมายตามกลุ่มเป้าหมายของ CTV ทั้งหมดของเราจะกำหนดให้ต้องมี IFA
นอกจากนี้ ให้ปฏิบัติตามหลักเกณฑ์เกี่ยวกับรหัสที่กำหนดโดยร้านค้า OTT/CTV ของ IAB ที่เผยแพร่เมื่อเร็วๆ นี้ด้วย ซึ่งหลักเกณฑ์นี้
จะกำหนดวิธีส่ง app.bundle
สำหรับแอป CTV โดยส่วนใหญ่จะใช้
รหัสที่กำหนดโดย App Store
การวัดมุมมองแอ็กทีฟ
มุมมองแอ็กทีฟเป็นเทคโนโลยีของ Google ที่ใช้เพื่อวัดว่าการแสดงผลมองเห็นได้หรือไม่ และมองเห็นได้นานเท่าใด มุมมองแอ็กทีฟใช้ OMID สำหรับทั้งโฆษณา Display และโฆษณาวิดีโอ หากต้องการเปิดใช้การวัดผลโดยใช้ OMID การแลกเปลี่ยนโฆษณาต้องเพิ่มฟิลด์ต่อไปนี้ในคำขอ OpenRTB เพื่อให้ DV360 ทราบว่าไคลเอ็นต์รองรับ OMID
- ต้องระบุ: เพิ่มเฟรมเวิร์ก API (
Video.api=7
สำหรับOMSDK
) ลงในคำขอเสนอราคา ซึ่งเป็นข้อกำหนดสำหรับมุมมองแอ็กทีฟในการเปิดใช้การวัด โดยใช้ OMID - แนะนํา: ขอแนะนําเป็นอย่างยิ่งให้เพิ่ม
omidpn
และomidpv
ลงในSource.Ext
เนื่องจากจะส่งผลต่อวิธีรายงานการวัดค่าการมองเห็นใน DV360 ให้กับลูกค้า หากชื่อพาร์ทเนอร์ OMID ไม่อยู่ในรายการ การรับรองของ IAB MRC กำหนดให้เราต้องรายงานเมตริกการมองเห็นแยกต่างหาก จากเมตริกที่ได้รับการรับรองจาก MRC ดูข้อมูลเพิ่มเติม
คำถามที่พบบ่อย
- DV360 รองรับส่วนขยายที่กำหนดเองของการแลกเปลี่ยนไหม
- ได้ นอกเหนือจากส่วนขยายที่ระบุไว้ในข้อกำหนดนี้แล้ว Display & Video 360 ยังอาจรองรับส่วนขยายที่กำหนดเองเป็นรายกรณีด้วย เราขอแนะนำให้ระบุและทดสอบส่วนขยายที่กำหนดเองในระหว่างระยะเวลาการผสานรวม
- DV360 รองรับวิดีโอที่มีการให้รางวัลไหม
- ได้ โปรดส่งส่วนขยายวิดีโอที่มีการให้รางวัลมาให้เรา
- พื้นที่โฆษณาส่วนใหญ่ของฉันแสดงเป็นข้อมูลประชากรที่ไม่รู้จัก ฉันจะปรับปรุงความครอบคลุมของข้อมูลประชากรได้อย่างไร
- ป้อนข้อมูล
user.yob
และuser.gender
ในคำขอราคาเสนอไปยัง DV360 เพื่อเพิ่ม ความครอบคลุม - DV360 มีปลายทางสำหรับแต่ละภูมิภาคไหม
- ไม่ได้ เราใช้ปลายทางเดียวทั่วโลกและจะกำหนดเส้นทางการส่งคำขอไปยัง ศูนย์ข้อมูลที่ใกล้ที่สุดโดยอัตโนมัติ ดังนั้นจึงไม่มีปลายทางเฉพาะภูมิภาคที่เราจะให้ได้
- คำขอแบบเซิร์ฟเวอร์ต่อเซิร์ฟเวอร์ (S2S) มีข้อกำหนดอะไรบ้าง
- ติดต่อเพื่อขอเพิ่ม ในรายการที่อนุญาต ต้องส่งต่อ User Agent ของไคลเอ็นต์ และตรวจสอบว่าได้ปิดใช้/ละเว้นคุกกี้ในการตอบกลับการดึงข้อมูล VAST แบบ s2s
- DV360 รองรับ OMID ไหม
- เราสามารถวัดการมองเห็นโฆษณาโดยใช้ OMID ได้ตราบใดที่มีการประกาศเป็น เปิดใช้ OMID ในเวลาที่ส่งคำขอราคาเสนอ รายละเอียดเกี่ยวกับเรื่องนี้สรุปไว้ในหน้า 24-25
- คุณรองรับโฆษณาเนทีฟเวอร์ชันใด คุณมีข้อกำหนดเกี่ยวกับโฆษณาเนทีฟไหม
- เรารองรับเฉพาะโฆษณาเนทีฟเวอร์ชัน 1.2 ข้อกำหนด โฆษณาเนทีฟ
- DV360 รองรับคำขอราคาเสนอที่ส่งเป็น GZIP ไหม
- DV360 สามารถรับคำขอเสนอราคาที่บีบอัดด้วย gzip และจะตอบกลับด้วยการตอบกลับที่บีบอัดด้วย gzip หากส่วนหัว Accept-Encoding ระบุว่ารองรับ
- DV360 รองรับ DBURL ไหม
- ยังไม่ได้ในตอนนี้
- DV360 รองรับการแจ้งเตือนการชนะ/แพ้ไหม
- ยังไม่ได้ในตอนนี้ หากคุณคิดว่าเราควรให้การสนับสนุนฟีเจอร์นี้ โปรด ติดต่อเราพร้อมรายละเอียดเพิ่มเติม
- DV360 ต้องใช้ App.name สำหรับการกำหนดเป้าหมายไหม
- ไม่ DV360 ใช้ App.name เป็นข้อมูลอ้างอิง แต่ไม่จำเป็นสำหรับการกำหนดเป้าหมาย
App.bundle
ใช้สำหรับการกำหนดเป้าหมาย - DV360 รองรับโฆษณาหลายขนาดที่ส่งในคำขอราคาเสนอเดียวได้ไหม
- ได้ เราจะพิจารณาขนาดครีเอทีฟโฆษณาทั้งหมดที่มีสิทธิ์ใน banner.format
- DV360 รองรับรูปแบบหลายรูปแบบในคำขอราคาเสนอเดียวกันไหม
- เรามีการสนับสนุนคำขอราคาเสนอแบบหลายรูปแบบอย่างจำกัด แต่กำลังดำเนินการ ปรับปรุง เรารองรับรูปแบบ Display และวิดีโอสำหรับโฆษณาคั่นระหว่างหน้า แต่ไม่รองรับรูปแบบ Display และเนทีฟในขณะนี้ หากคุณส่งคำขอราคาเสนอแบบหลายรูปแบบ โปรดติดต่อเพื่อขอรับการทดสอบ
- DV360 รองรับการแสดงผลแบบผสมในคำขอเดียวกันไหม
- ปัจจุบันเรารองรับเฉพาะโฆษณาวิดีโอ/แบนเนอร์คั่นระหว่างหน้า เรากำลังดำเนินการกับ เนทีฟ/แบนเนอร์และวิดีโอ/แบนเนอร์ หากมีการผสมผสานอื่นๆ โปรดติดต่อทีมของเรา
- ผู้ซื้อหลายรายสามารถส่งราคาเสนอหลายรายการสำหรับโอกาสในการแสดงผลดังกล่าวอย่างน้อย 1 รายการในคำขอเดียวกันได้ไหม
- ได้
- DV360 มีโซลูชันหรือความต้องการเฉพาะเกี่ยวกับการจำกัดจำนวนครั้งหรือการแสดงผู้ลงโฆษณารายเดียวกันสำหรับโอกาสในการแสดงผลดังกล่าวหลายครั้งในคำขอเดียวกันหรือไม่
- DV360 บังคับใช้ว่าผู้ลงโฆษณารายหนึ่งๆ จะเสนอราคาได้สูงสุดเพียง 1 โอกาสในการแสดงผล ต่อคำขอแต่ละรายการ เราคาดหวังให้ SSP จัดกลุ่มออบเจ็กต์ Imp อย่างมีความหมาย เช่น ทั้งหมดในหน้าเดียวกัน ทั้งหมดในแอปเดียวกัน เป็นต้น
- DV360 รองรับการแสดงผลหลายรายการในคำขอราคาเสนอเดียวกันไหม
- ปัจจุบัน DV360 รองรับออบเจ็กต์เสียงที่มีการแสดงผลหลายรายการ อย่างไรก็ตาม เราจะต้องทดสอบ/เปิดใช้แต่ละ
การแลกเปลี่ยนที่ต้องการใช้ฟีเจอร์นี้ ดูข้อมูลเพิ่มเติมได้ที่ข้อกำหนดของคำขอเสนอราคา เรากำลังขยายการให้บริการนี้ไปยังรูปแบบอื่นๆ ดังนี้
{ id: "2bbdc94f-7289-4fe2-9a5f-e2a530e06b38", seatbid { bid { id: "0", impid: "234232", price: 41.373926619828261, adid: "123", adm: "...", adomain: "xxx.com", cid: "0", crid: "123", dealid: "sample-deal-id-1", language: "xx", }, bid { id: "1", impid: "234255", price: 2.34192037470726, adid: "234", adm: "...", adomain: "xyz.com", cid: "0", crid: "234", dealid: "sample-deal-id-2", language: "xx", }, seat: "123456" }, cur: "EUR" }
ติดต่อเรา
หากมีคำถามหรือพบปัญหา โปรดติดต่อทีมสนับสนุนการแลกเปลี่ยน