ข้อกําหนด OpenRTB ของ DV360

โปรดเตรียมข้อกำหนด OpenRTB 2.6 ไว้ขณะอ่านหน้านี้

Display & Video 360 ไม่รองรับทุกฟิลด์ในข้อกําหนด OpenRTB และอาจมีรายละเอียดปลีกย่อย ส่วนต่างๆ ของเอกสารนี้มีข้อมูลและคำแนะนำที่เฉพาะเจาะจงกับการติดตั้งใช้งาน Display & Video 360 คุณควรปฏิบัติตามหลักเกณฑ์ที่ระบุไว้ในข้อกำหนด OpenRTB ด้วย เว้นแต่จะได้รับคำสั่งเป็นอย่างอื่น

ระบบไม่รองรับบางฟิลด์ แต่จะยังคงแยกวิเคราะห์อยู่ ฟิลด์เหล่านี้ต้อง จัดรูปแบบอย่างถูกต้อง แต่จะไม่ส่งผลต่อผลลัพธ์การเสนอราคา

ข้อกำหนดของคำขอราคาเสนอ

คำขอราคาเสนอคือคำขอ HTTP Post ที่มีเนื้อหาเป็นออบเจ็กต์คำขอราคาเสนอ รูปแบบของเนื้อหาจะกำหนดไว้ในส่วนหัว Content-Type

การตอบกลับที่เกี่ยวข้องคือ HTTP 204 ที่ไม่มีเนื้อความสำหรับการไม่เสนอราคา หรือ HTTP 200 ที่มีเนื้อความของการเสนอราคาตอบ

หากคำขอราคาเสนอมีรูปแบบไม่ถูกต้อง ระบบอาจแสดงผล HTTP 200 ที่มีเนื้อหาเป็นการตอบกลับ การเสนอราคาพร้อมฟิลด์ 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 รายการ

สำหรับพอดแคสต์เสียง ระบบรองรับออบเจ็กต์ imp มากกว่า 1 รายการ
สำหรับกรณีการใช้งานอื่นๆ (เช่น ช่องโฆษณาอิสระหลายช่องในหน้าเว็บ) ระบบจะใช้ออบเจ็กต์ imp รายการแรก และทิ้งรายการที่เหลือ
site เว็บไซต์ ต้องระบุสำหรับคำขอเข้าถึงเว็บไซต์
site และ app จะเป็นข้อมูลแยกกัน
app App ต้องระบุสำหรับคำขอแอป
app และ site จะเป็นข้อมูลแยกกัน
device อุปกรณ์ ต้องระบุ
user ผู้ใช้ ต้องระบุ
test จำนวนเต็ม ไม่รองรับ
at จำนวนเต็ม 1: การประมูลแบบใช้ราคาอันดับ 1 ซึ่งผู้ลงโฆษณาจะถูกเรียกเก็บเงินตาม จำนวนราคาเสนอ
2 (ค่าเริ่มต้น): การประมูลราคาที่สองซึ่งผู้ลงโฆษณาจะ ถูกเรียกเก็บเงินสูงกว่าผู้เสนอราคาสูงสุดเป็นอันดับ 2 เพียงเล็กน้อย
3: ราคาพื้นอยู่ในคำขอและไม่เกี่ยวข้องกับราคาเสนอที่แข่งขันกัน
tmax จำนวนเต็ม ไม่บังคับ ค่าเริ่มต้นคือกำหนดเองต่อการผสานรวม
wseat อาร์เรย์สตริง รายชื่อที่นั่งของผู้ซื้อที่อนุญาต
แนะนําให้ใช้เว้นแต่จะอนุญาตให้ผู้ลงโฆษณาทุกรายเสนอราคา
การไม่ตั้งค่าหมายความว่าไม่มีข้อจำกัด
bseat อาร์เรย์สตริง รายชื่อที่นั่งของผู้ซื้อที่ควรบล็อกราคาเสนอ ระบบจะบล็อกไม่ให้ผู้ซื้อที่ระบุ เสนอราคาในดีลและการประมูลแบบเปิด
allimps จำนวนเต็ม ไม่รองรับ
cur อาร์เรย์สตริง

ไม่บังคับ แต่แนะนำอย่างยิ่ง ค่าเริ่มต้นคือต่อการผสานรวม

สกุลเงินในคำขอราคาเสนอต้องตรงกับสกุลเงินที่ลงทะเบียนไว้ ระหว่างการผสานรวม

เราขอแนะนำอย่างยิ่งให้รองรับสกุลเงินเดียวต่อการแลกเปลี่ยน
wlang อาร์เรย์สตริง ไม่รองรับ
bcat อาร์เรย์สตริง หมวดหมู่ผู้ลงโฆษณาที่ถูกบล็อกโดยใช้หมวดหมู่เนื้อหาของ IAB
Unset คือไม่มีหมวดหมู่ที่ถูกบล็อก
badv อาร์เรย์สตริง ระบุผู้ลงโฆษณาที่ถูกบล็อกตามโดเมนที่ผู้ลงโฆษณา ระบุ
Unset คือไม่มีผู้ลงโฆษณาที่ถูกบล็อก
bapp อาร์เรย์สตริง ไม่รองรับ
source แหล่งที่มา ต้องระบุสำหรับ schain
regs Regs ไม่บังคับ
ext ส่วนขยายคำขอราคาเสนอ ไม่บังคับ

ออบเจ็กต์ส่วนขยายคำขอราคาเสนอ

ช่อง ประเภท รายละเอียด
schain ซัพพลายเชน การผสานรวมใหม่ควร ใช้ฟิลด์ BidRequest.source.schain ใน แหล่งที่มาแทน
purch จำนวนเต็ม พารามิเตอร์การเข้าชมที่ซื้อคือการเข้าชมที่เปลี่ยนเส้นทางจาก พร็อพเพอร์ตี้นอกเหนือจากที่เป็นเจ้าของ ได้มา หรือกิจกรรมที่จูงใจ
ซึ่งเป็นไปตามข้อกำหนด IVT 2.0 ของ MRCใหม่

ซึ่งจะเรียกว่าแหล่งที่มาของการเข้าชมของผู้เผยแพร่โฆษณาในการรายงานที่แสดงต่อผู้ซื้อ และจะมีค่าใดค่าหนึ่งต่อไปนี้
0 (ค่าเริ่มต้น): ไม่ได้กำหนด - ไม่ได้ส่งค่าในคำขอราคาเสนอ ไม่สามารถบันทึกมูลค่าได้
1: ซื้อแล้ว - การเข้าชมที่เปลี่ยนเส้นทางจากพร็อพเพอร์ตี้นอกเหนือจากที่เป็นเจ้าของ (ได้มาหรือกิจกรรมที่จูงใจ)
2: การเข้าชมทั่วไป - การป้อน URL โดยตรง การค้นหาเว็บไซต์ หรือการดาวน์โหลดแอป

gdemsignals สตริง Blob สัญญาณ SCAR API จาก GMA SDK
แนะนําให้ใช้หากมีการเข้าชม GMA SDK มิฉะนั้นจะถูกห้าม
disable_gma_format int จะระบุหรือไม่ก็ได้หากระบุ gdemsignals แต่จะระบุไม่ได้หากไม่ระบุ
0 (ค่าเริ่มต้น): เมื่อมีการระบุ gdemsignals ไว้ใน การเสนอราคาตอบ adm จะเป็น JSON Blob
1: ระบบจะแสดงแท็กโฆษณาแทน Blob ของ JSON ด้วย

ออบเจ็กต์ต้นทาง

ช่อง ประเภท รายละเอียด
fd จำนวนเต็ม เอนทิตีที่รับผิดชอบต่อการตัดสินใจขายการแสดงผลขั้นสุดท้าย
0 (ค่าเริ่มต้น): Exchange เป็นผู้กำหนด
1: แหล่งที่มาต้นทางเป็นผู้กำหนด
tid สตริง ไม่รองรับ
pchain สตริง ไม่รองรับ
schain ซัพพลายเชน ต้องระบุในเกือบทุกกรณี

เราขอแนะนำให้ใช้ฟิลด์นี้แทนการระบุ 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
gdpr สตริง Flag ที่ระบุว่าคำขออยู่ภายใต้กฎระเบียบ GDPR หรือไม่ 0 = ไม่ 1 = ใช่ การละเว้นหมายถึงไม่ทราบ ดูรายละเอียดเพิ่มเติมได้ที่เอกสารประกอบ GDPR ของ DV360 คาดว่าจะมีเพียง regs.gdpr และ regs.ext.gdpr เท่านั้น
us_privacy สตริง สื่อสารสัญญาณเกี่ยวกับความเป็นส่วนตัวของผู้บริโภคภายใต้กฎระเบียบด้านความเป็นส่วนตัวของสหรัฐอเมริกา ดูข้อกำหนดของสตริงความเป็นส่วนตัวของสหรัฐอเมริกา เมื่อเราได้รับสตริง us_privacy ในคำขอราคาเสนอและ สตริง IAB ระบุว่าผู้ใช้เลือกไม่ใช้ Display & Video 360 จะถือว่าคำขอไม่มีสิทธิ์สำหรับราคาเสนอที่ปรับตามโปรไฟล์ของผู้ใช้ เราจะไม่กระจายสัญญาณ IAB ไปยังผู้ให้บริการรายอื่นๆ

คาดว่าจะมีเพียง regs.us_privacy, user.us_privacy และ user.ext.us_privacy เท่านั้น
gpp สตริง มีสตริงความยินยอมของ Global Privacy Protocol DV360 ยอมรับเฉพาะบางส่วนของ GPP รวมถึงระดับประเทศของสหรัฐอเมริกา แคลิฟอร์เนีย และอื่นๆ ระบบไม่ยอมรับส่วน TCF ของ IAB Europe โปรดใช้ user.consent หรือ user.ext.consent แทน
gpp_sid อาร์เรย์จำนวนเต็ม อาร์เรย์ของส่วนในสตริงความยินยอมตาม Global Privacy Protocol ที่ควรใช้กับธุรกรรมนี้
ext ส่วนขยาย Regs ไม่บังคับ

ออบเจ็กต์ส่วนขยาย Regs

ช่อง ประเภท รายละเอียด
gdpr จำนวนเต็ม Flag ที่ระบุว่าคำขออยู่ภายใต้กฎระเบียบ GDPR หรือไม่ ตามที่อธิบายไว้ในregs.gdpr ด้านบน คาดว่าจะมีเพียง regs.gdpr และ regs.ext.gdpr
us_privacy สตริง ดูเอกสารประกอบของ regs.us_privacy คาดว่าจะมีเพียง regs.us_privacy, regs.ext.us_privacy และ user.ext.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 จำนวนเต็ม

ระบุประเภทเบราว์เซอร์ที่เปิดขึ้นเมื่อคลิกครีเอทีฟโฆษณาในแอป
0 (ค่าเริ่มต้น): ฝัง
1: เนทีฟ

โปรดทราบว่า Safari View Controller ในอุปกรณ์ iOS 9.x ถือเป็น เบราว์เซอร์เนทีฟเพื่อวัตถุประสงค์ของช่องนี้

secure จำนวนเต็ม หากการแสดงผลนี้ต้องใช้ HTTPS URL ที่ปลอดภัย หรือ HTTP URL ที่ไม่ปลอดภัย
0 (ค่าเริ่มต้น):ไม่ปลอดภัย
1: ปลอดภัย
iframebuster อาร์เรย์สตริง
exp จำนวนเต็ม DV360 จะกำหนดการหมดอายุของการเสนอราคาโดยไม่คำนึงถึงค่าที่พาร์ทเนอร์ส่งในช่องนี้ ระบบจะทิ้งเหตุการณ์การแสดงผลที่ได้รับหลังจากกรอบเวลาความเก่าของการแสดงผล (โดยทั่วไปคือ 1 ชั่วโมง) เนื่องจากถือว่าเก่า และ DV360 จะไม่ถือว่าเหตุการณ์ดังกล่าวเรียกเก็บเงินได้
rwdd จำนวนเต็ม ระบุว่าผู้ใช้จะได้รับรางวัลจากการดูโฆษณาหรือไม่
0 (ค่าเริ่มต้น): ไม่มีการให้รางวัล
1: มีการให้รางวัล

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

ออบเจ็กต์ส่วนขยายการแสดงผล

ช่อง ประเภท รายละเอียด
bcrid สตริง รายการรหัสครีเอทีฟโฆษณาที่ควรบล็อก
ช่อง ประเภท รายละเอียด
format อาร์เรย์รูปแบบ รายการรูปแบบที่รองรับ
w จำนวนเต็ม

ระบบจะผสาน h และ w เข้ากับช่อง format

ขอแนะนำให้ใช้ format แทน
h จำนวนเต็ม

ระบบจะผสาน h และ w เข้ากับช่อง format

ขอแนะนำให้ใช้ format แทน
wmax จำนวนเต็ม ไม่รองรับ
hmax จำนวนเต็ม ไม่รองรับ
wmin จำนวนเต็ม ไม่รองรับ
hmin จำนวนเต็ม ไม่รองรับ
btype อาร์เรย์จำนวนเต็ม รายการประเภทโฆษณาแบนเนอร์ที่ถูกบล็อก

1: โฆษณาแบบข้อความ HTML
2: โฆษณาแบนเนอร์ HTML
3: โฆษณา JavaScript
4: โฆษณา IFrame

battr อาร์เรย์จำนวนเต็ม รองรับค่าต่อไปนี้

1: เล่นเสียงอัตโนมัติ
2: ผู้ใช้เริ่มเล่นเสียง
3: ขยายได้อัตโนมัติ
4: ขยายได้เมื่อคลิก
5: ขยายได้เมื่อวางเมาส์
6: เล่นวิดีโอในแบนเนอร์อัตโนมัติ
7: ผู้ใช้เริ่มเล่นวิดีโอในแบนเนอร์
8: ป๊อปอัป(เหนือ/ใต้/เมื่อออกจากหน้า)
9: ยั่วยุหรือชี้นำ
10: "น่ารำคาญ" เช่น สั่นไหว กะพริบ แวบๆ ภาพเคลื่อนไหวมากเกินไป อีโมจิ
11: แบบสำรวจ
12: ข้อความเท่านั้น
13: โต้ตอบกับผู้ใช้ (เกม)
14: รูปแบบกล่องโต้ตอบหรือการแจ้งเตือนของ Windows
15: มีปุ่มเปิด/ปิดเสียง
16: ข้ามโฆษณาได้
17: Flash

pos จำนวนเต็ม ตำแหน่งของโฆษณา

0 (ค่าเริ่มต้น): ไม่ทราบ
1: ครึ่งหน้าบน
2: ไม่รองรับ: น่าจะอยู่ครึ่งหน้าล่าง
3: ครึ่งหน้าล่าง
4: ส่วนหัว
5: ส่วนท้าย
6: แถบด้านข้าง
7: เต็มหน้าจอ
mimes อาร์เรย์สตริง ไม่รองรับ

DV360 จะใช้ข้อความ/html สำหรับครีเอทีฟโฆษณาแบนเนอร์ทั้งหมด

topframe จำนวนเต็ม 0 (ค่าเริ่มต้น): แสดงแบนเนอร์ใน iframe
1: ไม่รองรับ: ระบบจะแสดงแบนเนอร์ในเฟรมด้านบน
expdir อาร์เรย์จำนวนเต็ม 1: ซ้าย
2: ขวา
3: ขึ้น
4: ลง
5: เต็มหน้าจอแบบขยายได้
api อาร์เรย์จำนวนเต็ม เฟรมเวิร์ก API ที่รองรับ

1: ซ้าย
2: ขวา
3: ขึ้น
4: ลง
5: เต็มหน้าจอแบบขยายได้

id สตริง ตัวระบุสำหรับออบเจ็กต์แบนเนอร์และควรไม่ซ้ำกันในการแสดงผล

แนะนําเมื่อใช้ออบเจ็กต์ banner กับออบเจ็กต์วิดีโอ

vcm จำนวนเต็ม

เกี่ยวข้องกับ banner ที่ใช้กับออบเจ็กต์วิดีโอเท่านั้น

0: แบนเนอร์จะแสดงพร้อมกับครีเอทีฟโฆษณาวิดีโอ
1: แบนเนอร์คือการ์ดตอนจบหลังจากวิดีโอ

จัดรูปแบบออบเจ็กต์

ช่อง ประเภท รายละเอียด
w จำนวนเต็ม ความกว้างเป็นพิกเซลอิสระของอุปกรณ์ (DIPS)
h จำนวนเต็ม ความสูงเป็นพิกเซลอิสระของอุปกรณ์ (DIPS)
wratio จำนวนเต็ม ไม่รองรับ
hratio จำนวนเต็ม ไม่รองรับ
wmin จำนวนเต็ม ไม่รองรับ

ออบเจ็กต์วิดีโอ

เราขอแนะนำอย่างยิ่งให้ระบุตำแหน่งวิดีโอในคำขอราคาเสนอ ระบบจะจัดประเภทฟิลด์ตําแหน่งที่ขาดหายไปเป็นตําแหน่งที่ไม่รู้จัก ดูรายละเอียดเพิ่มเติมได้ที่บทความเกี่ยวกับการกำหนดเป้าหมายตามตำแหน่ง

ช่อง ประเภท รายละเอียด
mimes อาร์เรย์สตริง ต้องระบุประเภท MIME อย่างน้อย 1 ประเภท

video/flv หรือ video/x-f4v
video/mp4, video/x-mp4 หรือ application/mp4
video/webm หรือ video/x-webm
video/x-ms-wmv
video/3gpp
video/ogg หรือ application/ogg
application/javascript หรือ application/x-javascript

minduration จำนวนเต็ม ระยะเวลาขั้นต่ำของวิดีโอเป็นวินาที โดยค่าเริ่มต้นคือไม่มีขั้นต่ำ
maxduration จำนวนเต็ม ระยะเวลาสูงสุดของวิดีโอเป็นวินาที โดยค่าเริ่มต้นคือไม่มีระยะเวลาสูงสุด
protocols อาร์เรย์จำนวนเต็ม ต้องระบุโปรโตคอลที่รองรับอย่างน้อย 1 รายการ

1: VAST 1.0
2: VAST 2.0
3: VAST 3.0
4: VAST 1.0 Wrapper
5: VAST 2.0 Wrapper
6: VAST 3.0 Wrapper
7: VAST 4.0
8: VAST 4.0 Wrapper
9: DAAST 1.0
10: DAAST 1.0 Wrapper

w จำนวนเต็ม ความกว้างของวิดีโอเพลเยอร์ในพิกเซลอิสระของอุปกรณ์ (DIP)
h จำนวนเต็ม ความสูงของวิดีโอเพลเยอร์ในพิกเซลอิสระของอุปกรณ์ (DIP)
startdelay จำนวนเต็ม การหน่วงเวลาเริ่มต้นเป็นวินาทีสำหรับตำแหน่งโฆษณาตอนต้น โฆษณาตอนกลาง หรือโฆษณาตอนท้าย
placement จำนวนเต็ม ขอแนะนำอย่างยิ่งให้ระบุ plcmt (และ/หรือ) ตำแหน่งของวิดีโอในคำขอราคาเสนอ หากไม่มีทั้ง 2 ช่อง ระบบจะจัดประเภทเป็นตําแหน่งที่ไม่รู้จัก

0 (ค่าเริ่มต้น): ไม่ทราบ
1: ในสตรีม
2: ในแบนเนอร์
3: ในบทความ
4: ในฟีด
5: ลอย

หมายเหตุ: หากต้องการให้ระบบพิจารณาเป็นโฆษณาวิดีโอในสตรีม (ตำแหน่งหรือประเภท Plcmt 1) คุณต้องตั้งค่าตำแหน่ง/การแสดงผลวิดีโอเป็น "เปิดเสียง" และส่งสัญญาณอย่างถูกต้องในวิธีการเล่น (ค่า 1, 3, 4 และ 5 มีสิทธิ์ทั้งหมด)
plcmt จำนวนเต็ม ขอแนะนำอย่างยิ่งให้ระบุ plcmt (และ/หรือ) ตำแหน่งของวิดีโอในคำขอราคาเสนอ หากไม่มีทั้ง 2 ช่อง ระบบจะจัดประเภทเป็นตําแหน่งที่ไม่รู้จัก

0 (ค่าเริ่มต้น): ไม่ทราบ
1: ในสตรีม
2: เนื้อหาประกอบ
3: โฆษณาคั่นระหว่างหน้า
4: ไม่มีเนื้อหา/สแตนด์อโลน

หมายเหตุ: หากต้องการให้ระบบพิจารณาเป็นโฆษณาวิดีโอในสตรีม (ตำแหน่งหรือประเภท Plcmt 1) คุณต้องตั้งค่าตำแหน่ง/การแสดงผลวิดีโอเป็น "เปิดเสียง" และส่งสัญญาณอย่างถูกต้องในวิธีการเล่น (ค่า 1, 3, 4 และ 5 มีสิทธิ์ทั้งหมด)

หมายเหตุ: หากระบุทั้ง plcmt และ placement plcmt จะมีความสำคัญเหนือกว่า ดูคำแนะนำของ IAB เกี่ยวกับการย้ายข้อมูลไปยัง plcmt

หมายเหตุ: plcmt: Accompanying Content (2) ถือเป็น placement: In Article (3)
plcmt: No Content/Standalone (4) ถือเป็น placement: In feed (4)
placement: In Banner ไม่มีแมปใน plcmt
linearity จำนวนเต็ม ไม่รองรับ
skip จำนวนเต็ม หากวิดีโอเพลเยอร์อนุญาตให้ข้ามโฆษณา

0 (ค่าเริ่มต้น): ข้ามไม่ได้
1: ข้ามได้
skipmin จำนวนเต็ม ไม่รองรับ
skipafter จำนวนเต็ม ไม่รองรับ
sequence จำนวนเต็ม หากมีการเสนอการแสดงโฆษณาหลายครั้งในคำขอราคาเสนอเดียวกัน หมายเลขลำดับจะช่วยให้ส่งครีเอทีฟโฆษณาหลายรายการได้ อย่างสอดคล้องกัน
battr อาร์เรย์จำนวนเต็ม แอตทริบิวต์ครีเอทีฟโฆษณาที่ถูกบล็อก
maxextended จำนวนเต็ม ระยะเวลาสูงสุดของโฆษณาวิดีโอแบบขยาย หากอนุญาตให้ขยาย

0 (ค่าเริ่มต้น): ไม่อนุญาตให้ใช้ส่วนขยาย
-1: อนุญาตให้ใช้ส่วนขยายและไม่มีการกำหนดเวลา
>0: จำนวนวินาทีของการเล่นที่ขยายเวลาซึ่งรองรับนอกเหนือจากค่า maxduration

minbitrate จำนวนเต็ม อัตราบิตขั้นต่ำในหน่วย Kbps
maxbitrate จำนวนเต็ม อัตราบิตสูงสุดในหน่วย Kbps
boxingallowed จำนวนเต็ม ระบุว่าอนุญาตให้แสดงเนื้อหา 4:3 ในหน้าต่าง 16:9 โดยมีแถบดำด้านบนและด้านล่างหรือไม่

0: ไม่อนุญาต
1 (ค่าเริ่มต้น): อนุญาต
playbackmethod อาร์เรย์จำนวนเต็ม วิธีการเล่นที่อาจมีการใช้งาน หากไม่ได้ระบุไว้ ระบบจะใช้วิธีการใดก็ได้

0 (ค่าเริ่มต้น): ไม่ทราบ
1: เล่นอัตโนมัติ เปิดเสียง
2: เล่นอัตโนมัติ ปิดเสียง
3: คลิกเพื่อเล่น
4: วางเมาส์
5: เริ่มเล่นเมื่อเข้าสู่ Viewport เปิดเสียง
6: เริ่มเล่นเมื่อเข้าสู่ Viewport ปิดเสียง

หมายเหตุ: การแสดงผลทั้งหมดที่มีการปิดเสียงเริ่มต้น (วิธีการเล่นเป็น 2, 6 หรือ 0) ต้องส่งสัญญาณตําแหน่งนอกสตรีมประเภท 2, 3, 4 หรือ 5 (oRTB 2.5) หรือประเภทย่อยของ Plcmt เป็น 2, 3 หรือ 4
playbackend จำนวนเต็ม เหตุการณ์ที่ทำให้การเล่นสิ้นสุด

1: วิดีโอเล่นจนจบหรือผู้ใช้ปิด
2: ออกจากวิวพอร์ตหรือผู้ใช้ปิด
3: เมื่อออกจากวิวพอร์ต จะเล่นต่อเป็นหน้าต่างลอยจนกว่าจะจบหรือผู้ใช้ปิด
delivery อาร์เรย์จำนวนเต็ม วิธีการนำส่งที่รองรับ หากไม่ได้ระบุ ให้ถือว่ารองรับทั้งหมด

1: สตรีมมิง
2: โปรเกรสซีฟ
pos จำนวนเต็ม อันดับโฆษณาบนหน้าจอ

0 (ค่าเริ่มต้น): ไม่ทราบ
1: ครึ่งหน้าบน
2: ไม่รองรับ: น่าจะอยู่ครึ่งหน้าล่าง
3: ครึ่งหน้าล่าง
4: ส่วนหัว
5: ส่วนท้าย
6: แถบด้านข้าง
7: เต็มหน้าจอ
companionad อาร์เรย์แบนเนอร์ โฆษณาที่แสดงร่วม (หากมี)
api อาร์เรย์จำนวนเต็ม

0 (ค่าเริ่มต้น): ไม่ทราบ
1: VPAID 1
2: VPAID 2
3: MRAID 1
4: ORMMA
5: MRAID 2
6: MRAID 3
7: OMID 1 - ต้องเปิดใช้การวัดผลโดยใช้ OMID สำหรับมุมมองแอ็กทีฟ
8: SIMID 1
companiontype อาร์เรย์จำนวนเต็ม ไม่รองรับ
maxseq จำนวนเต็ม จำนวนโฆษณาสูงสุดที่จะแสดงในพ็อดวิดีโอแบบไดนามิก
poddur อาร์เรย์จำนวนเต็ม ความยาวสูงสุดของพ็อดวิดีโอแบบไดนามิกเป็นวินาที

ส่วนขยายที่รองรับสำหรับออบเจ็กต์วิดีโอ

ช่อง ประเภท รายละเอียด
rewarded จำนวนเต็ม ฟิลด์นี้ใช้เพื่อส่งสัญญาณว่าคำขอได้รับรางวัลหรือไม่ ควร ส่งเป็นจำนวนเต็ม

0 (ค่าเริ่มต้น): ไม่มีการให้รางวัล
1: มีการให้รางวัล

ออบเจ็กต์เสียง

ช่อง ประเภท รายละเอียด
mimes อาร์เรย์สตริง ต้องระบุประเภท MIME อย่างน้อย 1 ประเภท

audio/m4a, audio/mp4 หรือ audio/x-m4a
audio/mpeg หรือ audio/mp3
audio/ogg หรือ audio/x-ogg

minduration จำนวนเต็ม ระยะเวลาโฆษณาขั้นต่ำเป็นวินาที
maxduration จำนวนเต็ม ระยะเวลาสูงสุดของโฆษณาเป็นวินาที
protocols อาร์เรย์จำนวนเต็ม

3: VAST 3.0
6: VAST 3.0 Wrapper
7: VAST 4.0
8: VAST 4.0 Wrapper
startdelay จำนวนเต็ม การหน่วงเวลาเริ่มต้นเป็นวินาทีสำหรับตำแหน่งโฆษณาตอนต้น โฆษณาตอนกลาง หรือโฆษณาตอนท้าย

-2: โฆษณาตอนท้าย
-1: โฆษณาตอนกลาง
0: โฆษณาตอนต้น
>0: โฆษณาตอนกลาง

sequence จำนวนเต็ม ไม่รองรับ
battr อาร์เรย์จำนวนเต็ม ไม่รองรับ
maxextended จำนวนเต็ม ไม่รองรับ
minbitrate จำนวนเต็ม อัตราบิตขั้นต่ำในหน่วย Kbps
maxbitrate จำนวนเต็ม อัตราบิตสูงสุดในหน่วย Kbps
delivery อาร์เรย์จำนวนเต็ม ไม่รองรับ
companionad อาร์เรย์ออบเจ็กต์แบนเนอร์ ช่องครีเอทีฟโฆษณาที่แสดงร่วมที่เป็นแบนเนอร์
api อาร์เรย์จำนวนเต็ม รายการเฟรมเวิร์ก API ที่รองรับสําหรับการแสดงผลนี้

7: Omid V1

companiontype อาร์เรย์จำนวนเต็ม ไม่รองรับ
maxseq อาร์เรย์จำนวนเต็ม ไม่รองรับ
feed จำนวนเต็ม ประเภทของฟีดเสียง ดูรายการ: ประเภทฟีดใน AdCOM 1.0

1: บริการสตรีมมิงเพลง
2: การออกอากาศ FM/AM (เนื้อหาสดที่ออกอากาศผ่านอากาศ (OTA) แต่ก็พร้อมให้บริการโดยใช้การสตรีมออนไลน์ด้วย)
3: พอดแคสต์ (เนื้อหาต้นฉบับที่บันทึกไว้ล่วงหน้าซึ่งเผยแพร่เป็นตอนๆ ในซีรีส์)
4: วิทยุย้อนหลัง (ส่วนที่บันทึกไว้ของรายการวิทยุที่ออกอากาศสดในตอนแรก)
5: วิทยุบนเว็บ (เนื้อหาสดที่พร้อมให้บริการโดยใช้การสตรีมออนไลน์เท่านั้น ไม่ใช่การออกอากาศ AM/FM)
6: วิดีโอเกม (เสียงพื้นหลังในวิดีโอเกม)
7: อ่านออกเสียงข้อความ (หนังสือเสียง ปลั๊กอินเว็บไซต์ที่อ่านบทความได้)

stitched จำนวนเต็ม ไม่รองรับ
nvol จำนวนเต็ม ไม่รองรับ

ออบเจ็กต์เนทีฟ

ดูรายละเอียดเพิ่มเติมได้ที่ข้อกำหนดของโฆษณาเนทีฟ DV360

ช่อง ประเภท รายละเอียด
request สตริง สตริงที่เข้ารหัสออบเจ็กต์ JSON ดั้งเดิม
ver สตริง 1.0: ไม่รองรับ
1.1: ไม่รองรับ
1.2
api อาร์เรย์จำนวนเต็ม รายการเฟรมเวิร์ก API ที่รองรับสําหรับการแสดงผลนี้

7: Omid V1

battr อาร์เรย์จำนวนเต็ม ไม่รองรับ

ออบเจ็กต์ PMP

ช่อง ประเภท รายละเอียด
private_auction จำนวนเต็ม 0 (ค่าเริ่มต้น): อนุญาตราคาเสนอทั้งหมด
1: ดีลเท่านั้น
deals อาร์เรย์ Deal object ดีลที่จะรวม

ออบเจ็กต์ดีล

ช่อง ประเภท รายละเอียด
id สตริง ออบเจ็กต์ PMP มีออบเจ็กต์ดีลได้ไม่เกิน 1 รายการต่อรหัส
bidfloor ดับเบิล การเสนอราคาขั้นต่ำสำหรับการแสดงผลนี้ใน CPM

ต้องระบุหาก at=3

bidfloorcur สตริง สกุลเงินที่ระบุโดยใช้รหัสอัลฟ่า ISO-4217

หากไม่ได้ระบุไว้ ค่าเริ่มต้นจะเป็นสกุลเงินของคำขอเสนอราคา

at จำนวนเต็ม ค่าเริ่มต้นคือการจับคู่ bid_request.at หากไม่ได้ระบุไว้

1: ราคาแรก
2: ราคาที่สอง
3: ราคาคงที่

wseat อาร์เรย์สตริง รหัสพาร์ทเนอร์ของพาร์ทเนอร์ที่มีสิทธิ์สำหรับดีล

ไม่มีที่นั่งหมายความว่าไม่มีข้อจำกัดเกี่ยวกับที่นั่ง

wadomain อาร์เรย์สตริง โดเมนของผู้ลงโฆษณาที่ได้รับอนุญาตให้เสนอราคาในดีลนี้

ไม่มีที่นั่งหมายความว่าไม่มีข้อจำกัดของโดเมน

guar จำนวนเต็ม ฟิลด์นี้ใช้เพื่อระบุว่าดีลเป็นดีลที่รับประกันหรือไม่ ควรส่งเป็นจำนวนเต็ม

การแลกเปลี่ยนต้องอยู่ในรายการที่อนุญาตเพื่อให้ DV360 ยอมรับดีลที่มีการรับประกัน ติดต่อเพื่อขอสิทธิ์นี้

หากปัจจุบัน Exchange ของคุณใช้กลไกอื่นในการส่งสัญญาณดีลที่รับประกัน กับ DV360 โปรดติดต่อ เพื่อหารือเกี่ยวกับการเปลี่ยนไปใช้ส่วนขยายที่แนะนำนี้

0 (ค่าเริ่มต้น): ไม่รับประกัน
1: รับประกัน

ext ส่วนขยายดีล ไม่บังคับ

ส่วนขยายที่รองรับสำหรับออบเจ็กต์ดีล

ช่อง ประเภท รายละเอียด
guaranteed จำนวนเต็ม ฟิลด์นี้ใช้เพื่อระบุว่าดีลเป็นดีลที่รับประกันหรือไม่ ควรส่งเป็นจำนวนเต็ม

การแลกเปลี่ยนต้องอยู่ในรายการที่อนุญาตเพื่อให้ DV360 ยอมรับดีลที่มีการรับประกัน ติดต่อเพื่อขอดีลนี้

หากปัจจุบัน Exchange ของคุณใช้กลไกอื่นในการส่งสัญญาณดีลที่รับประกัน กับ DV360 โปรดติดต่อ เพื่อหารือเกี่ยวกับการเปลี่ยนไปใช้ส่วนขยายที่แนะนำนี้

0 (ค่าเริ่มต้น): ไม่รับประกัน
1: รับประกัน

ขอแนะนำให้ใช้ deal.guar แทนฟิลด์นี้

ออบเจ็กต์เว็บไซต์

ช่อง ประเภท รายละเอียด
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 โปรดปฏิบัติตาม หลักเกณฑ์เกี่ยวกับรหัสที่กำหนดโดยร้านค้า OTT/CTV ของ IAB ที่เผยแพร่เมื่อเร็วๆ นี้

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 รองรับอนุกรมวิธานบางอย่างของค่าประเภทวิดีโอสำหรับฟิลด์นี้
  • รายการประเภทของ Google (ดาวน์โหลด)
  • รายการประเภทเสียงของ Google (ดาวน์โหลด)
  • หมวดหมู่ทีวี/ภาพยนตร์/กีฬาของ IAB (ดาวน์โหลด)
  • การจัดหมวดหมู่วิดีโอตามประเภทของ Gracenote ของ Nielsen
album สตริง อัลบั้มที่มีเนื้อหานั้นอยู่ ซึ่งโดยปกติแล้วจะเป็นอัลบั้มของเสียง
isrc สตริง รหัสการบันทึกมาตรฐานสากลที่สอดคล้องกับ ISO-3901
producer ออบเจ็กต์ Producer รายละเอียดเกี่ยวกับผู้ผลิตเนื้อหา
url สตริง URL ของเนื้อหา
cat อาร์เรย์สตริง หมวดหมู่เนื้อหาของ IAB ที่อธิบายเนื้อหา
prodq จำนวนเต็ม คุณภาพการผลิต:

0 (ค่าเริ่มต้น): ไม่ทราบ
1: มืออาชีพ
2: กึ่งมืออาชีพ
3: ผู้ใช้สร้างขึ้น

videoquality จำนวนเต็ม ไม่รองรับ
context จำนวนเต็ม ประเภทเนื้อหา:

1: วิดีโอ
2: เกม
3: เพลง
4: แอปพลิเคชัน
5: ข้อความ
6: อื่นๆ
7: ไม่ทราบ

contentrating สตริง แนะนำสำหรับเสียงและวิดีโอ/CTV เนื่องจากเราจะเริ่มพิจารณาแอตทริบิวต์นี้
userrating สตริง จำนวนดาว การกดชอบ ฯลฯ
qagmediarating จำนวนเต็ม การจัดประเภทสื่อตาม[หลักเกณฑ์ QAG](http://www.iab.net/ne_guidelines)

1: กลุ่มเป้าหมายทั้งหมด
2: 12 ปีขึ้นไป
3: เหมาะสำหรับผู้ใหญ่

keywords สตริง (รูปแบบ CSV) ไม่รองรับ
livestream จำนวนเต็ม หากเนื้อหาเป็นเนื้อหาไลฟ์สด

0: ไม่ใช่ไลฟ์สด
1: เนื้อหากำลังถ่ายทอดสด

sourcerelationship จำนวนเต็ม

0: โดยอ้อม
1: โดยตรง

len จำนวนเต็ม ความยาวของเนื้อหาเป็นวินาที

แนะนำสำหรับคำขอ CTV/วิดีโอและเสียง

language สตริง (ISO-639-1-alpha-2) ภาษาของเนื้อหา
embeddable จำนวนเต็ม ตัวบ่งชี้ว่าเนื้อหานั้นฝังได้หรือไม่ (เช่น วิดีโอเพลเยอร์ที่ฝังได้)

0: ฝังไม่ได้
1: ฝังได้

data อาร์เรย์ของออบเจ็กต์ข้อมูล ข้อมูลเพิ่มเติม

ออบเจ็กต์ Producer

ช่อง ประเภท รายละเอียด
id สตริง ไม่รองรับ
name สตริง ไม่รองรับ
cat อาร์เรย์สตริง ไม่รองรับ
domain สตริง โดเมนระดับสูงสุดของผู้ผลิต

ออบเจ็กต์ข้อมูล

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

ส่วนขยายที่รองรับสำหรับออบเจ็กต์ข้อมูล

ช่อง ประเภท รายละเอียด
segtax จำนวนเต็ม รหัสการจัดหมวดหมู่ ดูรายละเอียดเพิ่มเติมได้ที่การจัดหมวดหมู่กลุ่มเป้าหมาย
segclass สตริง เวอร์ชันของเครื่องมือจัดประเภทที่สร้างรหัสกลุ่มภายในอนุกรมวิธาน

ออบเจ็กต์กลุ่ม

ช่อง ประเภท รายละเอียด
id สตริง รหัสของกลุ่มข้อมูลที่เฉพาะเจาะจงสำหรับผู้ให้บริการข้อมูล
name สตริง ชื่อกลุ่มข้อมูล
value สตริง มูลค่าของกลุ่มข้อมูล

ออบเจ็กต์ผู้เผยแพร่โฆษณา

ช่อง ประเภท รายละเอียด
id สตริง ต้องระบุ
name สตริง ไม่รองรับ
cat อาร์เรย์สตริง ไม่รองรับ
domain สตริง ไม่รองรับ

ออบเจ็กต์อุปกรณ์

ช่อง ประเภท รายละเอียด
ua สตริง ต้องระบุ
sua ออบเจ็กต์ UserAgent ข้อมูล User Agent ที่มีโครงสร้าง
geo ออบเจ็กต์ทางภูมิศาสตร์ ตำแหน่งของอุปกรณ์
dnt จำนวนเต็ม ค่าสถานะ Do Not Track ตามที่ตั้งค่าไว้ในส่วนหัวของเบราว์เซอร์

0: การติดตามไม่ถูกจำกัด
1: ไม่ติดตาม

lmt จำนวนเต็ม สัญญาณจำกัดการติดตามโฆษณาที่ได้รับการรับรองในเชิงพาณิชย์

0: การติดตามไม่ถูกจำกัด
1: ต้องจำกัดการติดตามตามหลักเกณฑ์เชิงพาณิชย์

ip สตริง ต้องระบุหากเป็น IPv4

หากมีการตัดที่อยู่ IP คุณต้องประกาศใน device.ext.truncated_ip

ipv6 สตริง ต้องระบุหากเป็น IPv6

หากมีการตัดที่อยู่ IP คุณต้องประกาศใน device.ext.truncated_ip

devicetype จำนวนเต็ม ขอแนะนำอย่างยิ่งสำหรับพื้นที่โฆษณาทุกประเภท ใช้เพื่อปรับปรุงการจดจำประเภทอุปกรณ์
make สตริง
model สตริง
os สตริง ระบบปฏิบัติการของอุปกรณ์

ios: ในคำขอแอป พารามิเตอร์นี้จะระบุการเข้าชม iOS
android: ระบุอุปกรณ์ Android หาก ua หรือ sua ไม่ระบุอุปกรณ์
[anything else]: ใช้ในการวินิจฉัยเพื่อแยกปัญหา

โดยช่องนี้ไม่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่

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 ของ คำขอเสนอราคาถูกตัดทอนหรือไม่

0: ไม่ได้ตัด
1: ตัด

ค่าเริ่มต้นคือไม่มีการตัดทอน และต้องระบุหากมีการตัดทอนที่อยู่ IP

หากไม่ได้ประกาศ ระบบอาจจัดประเภทคำขอราคาเสนอเป็นการเข้าชมที่ไม่ถูกต้อง

ifa_type สตริง ระบุแหล่งที่มาของฟิลด์ device.ifa ไม่ว่าจะมาจาก อุปกรณ์เอง หรือสร้างโดยผู้เผยแพร่โฆษณาหรือ SSP ในซัพพลายเชน

aaid: Android TV
rida: Roku
afai: Amazon Fire
idfa: Apple tvOS
msai: Xbox/Microsoft
dpid: รหัสแพลตฟอร์มอุปกรณ์ทั่วไป
ppid: รหัสที่ผู้เผยแพร่โฆษณาระบุ
sspid: รหัสที่ SSP ระบุ
sessionid: รหัสเซสชันแบบมีอายุสั้น (การจำกัดความถี่เท่านั้น)

attestation_token สตริง (การเข้ารหัส Base64) โทเค็นการรับรองตามอุปกรณ์สำหรับการแลกเปลี่ยนที่รองรับการตรวจสอบอุปกรณ์ระดับนั้น
atts จำนวนเต็ม (iOS เท่านั้น) จำนวนเต็มที่ส่งผ่านเพื่อแสดงสถานะการให้สิทธิ์การติดตามแอปของแอป

0: ไม่ได้กำหนด
1: ถูกจำกัด
2: ถูกปฏิเสธ
3: ได้รับอนุญาต

cdep สตริง ป้ายกำกับการเลิกใช้งานคุกกี้ของบุคคลที่สามใน Chrome

ดู การทดสอบที่ Chrome ช่วยอำนวยความสะดวกและ ข้อกำหนดของชุมชน IAB

ออบเจ็กต์ UserAgent

ช่อง ประเภท รายละเอียด
browsers อาร์เรย์ของออบเจ็กต์ BrandVersion ออบเจ็กต์ BrandVersion แต่ละรายการจะระบุเบราว์เซอร์หรือคอมโพเนนต์ซอฟต์แวร์ที่คล้ายกัน
platform ออบเจ็กต์ BrandVersion ระบุแพลตฟอร์ม
mobile จำนวนเต็ม 0 (ค่าเริ่มต้น): Agent ต้องการเนื้อหา "เดสก์ท็อป" หรือ "เต็ม"
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 ส่วนขยายผู้ใช้ ส่วนขยายสำหรับออบเจ็กต์ผู้ใช้

ส่วนขยายที่รองรับสำหรับออบเจ็กต์ผู้ใช้

ช่อง ประเภท รายละเอียด
eids อาร์เรย์ของออบเจ็กต์รหัสเพิ่มเติม อินสแตนซ์รหัสแบบขยายที่แลกเปลี่ยนให้
consented_providers_settings.consented_providers ออบเจ็กต์ภายนอก (consented_providers_settings) ที่ครอบอาร์เรย์จำนวนเต็มภายใน (consented_providers) เมื่อรวบรวมความยินยอมตาม GDPR ผ่าน TCF ฟิลด์นี้จะแสดงรายชื่อผู้ให้บริการเทคโนโลยีโฆษณาที่ได้รับความยินยอมจากผู้ใช้ซึ่งไม่ได้เข้าร่วม TCF ดู "รายละเอียดทางเทคนิคเกี่ยวกับความยินยอมเพิ่มเติมของ Google"
us_privacy สตริง ดูเอกสารประกอบของ regs.us_privacy คาดว่าจะมีเพียง regs.us_privacy, regs.ext.us_privacy และ user.ext.us_privacy เท่านั้น

ออบเจ็กต์รหัสแบบขยาย

ช่อง ประเภท รายละเอียด
source สตริง ผู้ให้บริการตัวระบุ
uids อาร์เรย์ของออบเจ็กต์ Extended ID 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 จำนวนเต็ม ระบุว่าโหนดนี้จะมีส่วนร่วมในขั้นตอนการชำระเงิน สำหรับพื้นที่โฆษณาหรือไม่

1: ระบบโฆษณาในฟิลด์ asi จะชำระเงินให้ผู้ขายในฟิลด์ sid ซึ่งมีหน้าที่ชำระเงินให้ โหนดก่อนหน้าในเชน
0: โหนดนี้ไม่มีส่วนเกี่ยวข้องกับขั้นตอนการชำระเงินสำหรับ พื้นที่โฆษณา

สำหรับ SupplyChain เวอร์ชัน 1.0 พร็อพเพอร์ตี้นี้ควรเป็น 1 เสมอ ต้องระบุอย่างชัดเจน เนื่องจากคาดว่าข้อกำหนดเวอร์ชันในอนาคต จะมีการนำโหนดการจัดการการชำระเงินมาใช้

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

ข้อกำหนดการเสนอราคาตอบ

ออบเจ็กต์ BidResponse

แอตทริบิวต์ รองรับ รายละเอียดการใช้งาน ผ่านเสมอ
id หากเกิดข้อผิดพลาดในการแยกวิเคราะห์ ค่านี้อาจเป็น "0" แทนรหัสคำขอเสนอราคา ใช่
seatbid
bidid
cur หากเกิดข้อผิดพลาดในการแยกวิเคราะห์ ระบบจะไม่ส่งค่านี้ สําหรับการเข้าชมคําขอราคาเสนอที่ถูกต้อง ระบบจะระบุ cur เสมอ ใช่
customdata
nbr ซึ่งจะรวมไว้ก็ต่อเมื่อพบปัญหาเกี่ยวกับคำขอเสนอราคา ค่าที่เป็นไปได้ ได้แก่
2: คำขอไม่ถูกต้อง
12: การละเมิดการให้สิทธิ์ ads.txt
16: 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

คำอธิบายที่มนุษย์อ่านได้ของข้อผิดพลาดเกี่ยวกับคำขอราคาเสนอ กรณีการตอบกลับ รวมถึง

  • เนื้อหาคำขอราคาเสนอว่างเปล่า
  • คำขอราคาเสนอไม่ได้อยู่ในสกุลเงินที่อยู่ในรายการที่อนุญาตสำหรับ การแลกเปลี่ยนนั้นๆ
  • คำขอราคาเสนอไม่มีประเภท MIME ที่ยอมรับ
errHelp ลิงก์ไปยังหน้านี้

ออบเจ็กต์ Seatbid

แอตทริบิวต์ รองรับ รายละเอียดการใช้งาน ผ่านเสมอ
ราคาเสนอ ใช่
ที่นั่ง ใช่
กลุ่ม

ออบเจ็กต์การเสนอราคา

แอตทริบิวต์ รองรับ รายละเอียดการใช้งาน ผ่านเสมอ
id ใช่
impid ใช่
ราคา ใช่
nurl
ตาไม้
lurl
adm
adid
adomain
กลุ่ม
iurl
cid ใช่
crid ใช่
กลยุทธ์
cat
แอตทริบิวต์
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 หรือในการตอบกลับของประกาศการชนะการประมูลตามข้อกำหนดจากพาร์ทเนอร์ Exchange

โปรดดูข้อกำหนด OpenRTB เพื่อทราบข้อดีและข้อเสียของตัวเลือกทั้ง 2 นี้

แนวทางปฏิบัติแนะนำ

ขอแนะนำอย่างยิ่งให้ใช้รหัสพาร์ทเนอร์ของ Display & Video 360 เป็น รหัสที่นั่ง ไม่แนะนำให้ใช้รหัสผู้ซื้อที่เฉพาะเจาะจงสำหรับ Exchange

ตรวจสอบว่าผู้เผยแพร่โฆษณามีไฟล์ ads.txt หรือแอปพลิเคชันที่มีไฟล์ app-ads.txt ที่เชื่อมโยงอยู่ และระบุคุณในไฟล์เป็นผู้ขายหรือ ผู้จำหน่ายที่ได้รับอนุญาต ดูข้อมูลเพิ่มเติม

นอกจากนี้ โปรดตรวจสอบว่ามีการส่งข้อมูลที่สอดคล้องกันในคำขอราคาเสนอ เช่น app.bundle ต้องสอดคล้องกับข้อมูลอุปกรณ์เคลื่อนที่และapp.storeurl

ทีวีที่เชื่อมต่ออินเทอร์เน็ต

ปฏิบัติตามหลักเกณฑ์ IFA ของ IAB OTT ในการส่ง device.ifa และ device.lmt นอกจากนี้ คุณควรใช้ device.ext.ifa_type เพื่อให้เป็นไปตามหลักเกณฑ์ ความสามารถในการกำหนดความถี่สูงสุดและการกำหนดกลุ่มเป้าหมายตามกลุ่มเป้าหมายของ CTV ทั้งหมดของเราจะต้องมี IFA

นอกจากนี้ ให้ปฏิบัติตามหลักเกณฑ์รหัสที่กำหนดของ Store สำหรับ OTT/CTV ของ IAB ที่เผยแพร่เมื่อเร็วๆ นี้ด้วย ซึ่งหลักเกณฑ์นี้ จะกำหนดวิธีส่ง app.bundle สำหรับแอป CTV โดยส่วนใหญ่จะใช้ รหัสที่กำหนดของ App Store

การวัดมุมมองแอ็กทีฟ

มุมมองแอ็กทีฟเป็นเทคโนโลยีของ Google ที่ใช้เพื่อวัดว่าการแสดงผลมองเห็นได้หรือไม่ และมองเห็นได้นานเท่าใด มุมมองแอ็กทีฟใช้ OMID สำหรับทั้งโฆษณา Display และโฆษณาวิดีโอ หากต้องการเปิดใช้ การวัดผลโดยใช้ OMID การแลกเปลี่ยนโฆษณาต้องเพิ่มฟิลด์ต่อไปนี้ในคำขอ OpenRTB เพื่อให้ DV360 ทราบว่าไคลเอ็นต์รองรับ OMID

  • ต้องระบุ: เพิ่มเฟรมเวิร์ก API (Video.api=7 สำหรับ Web Video OMSDK, Native.api=7 สำหรับ Native App OMSDK, Banner.api=7 หรือ Audio.api=7) ในคำขอเสนอราคา ซึ่งเป็นข้อกำหนดสำหรับมุมมองแอ็กทีฟในการเปิดใช้การวัด โดยใช้ OMID
  • แนะนํา: การเพิ่ม omidpn และ omidpv ลงใน Source.Ext เป็นสิ่งที่แนะนําเป็นอย่างยิ่ง เนื่องจากจะส่งผลต่อวิธีรายงานการวัดค่าการมองเห็นใน DV360 ให้กับ ลูกค้า หากชื่อพาร์ทเนอร์ OMID ไม่อยู่ใน รายการการรับรองของ IAB MRC กำหนดให้เราต้องรายงานเมตริกการมองเห็นโฆษณาแยกต่างหาก จากเมตริกที่ได้รับการรับรองจาก MRC ดูข้อมูลเพิ่มเติม
การวัดมุมมองแอ็กทีฟสําหรับโฆษณาเนทีฟ

หากต้องการเปิดใช้การวัดมุมมองแอ็กทีฟสําหรับโฆษณาเนทีฟ DV360 กําหนดให้ผู้เผยแพร่โฆษณาและ Exchange ดําเนินขั้นตอนเพิ่มเติม

  • โฆษณา Display เนทีฟ: DV360 จะเพิ่ม eventtrackers ต่อไปนี้ในการเสนอราคาตอบภายใต้ออบเจ็กต์ adm.native

    "eventtrackers": [
  {
    "event": 555,
    "method": 2,
    "url": "https://pagead2.googlesyndication.com/pagead/managed/js/activeview/current/rx_omid.js",
    "ext": {
      "vendorKey": "doubleclickbygoogle.com-omid-dsp",
      "verification_parameters": ""
    }
  }
]

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

    1. ติดตั้ง OMSDK
    2. โหลด OMSDK เมื่อแสดงโฆษณาเนทีฟ
    3. เรียกใช้ JavaScript ใน eventtrackers.url ด้วยพารามิเตอร์ที่ระบุ

  • โฆษณาวิดีโอเนทีฟ: DV360 ช่วยให้วัดการมองเห็นโฆษณาได้โดยการเพิ่มส่วนขยาย AdVerifications มาตรฐานภายใน VAST XML ดังนี้

    <Extension type="AdVerifications">
  <AdVerifications>
    <Verification vendor="doubleclickbygoogle.com-omid-video">
      <JavaScriptResource apiFramework="omid" browserOptional="true">
        <![CDATA[ https://www.googletagservices.com/activeview/js/current/rx_omid_video.js ]]>
      </JavaScriptResource>
      <VerificationParameters>
        <![CDATA[ {"activeview_flags":"...","activeview_metadata":"...", ...} ]]>
      </VerificationParameters>
      <TrackingEvents>
        <Tracking event="verificationNotExecuted">
          <![CDATA[ https://ade.googlesyndication.com/ddm/activity/... ]]>
        </Tracking>
      </TrackingEvents>
    </Verification>
  </AdVerifications>
</Extension>

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

กฎระเบียบด้าน AI ของสหภาพยุโรปสำหรับโฆษณาเนทีฟใน 3PE

เพื่อให้ผู้ลงโฆษณาสามารถปฏิบัติตามกฎระเบียบด้านความโปร่งใสที่เกิดขึ้นใหม่ กฎระเบียบด้าน AI ในสหภาพยุโรป อินเดีย และรัฐนิวยอร์กกำหนดให้โฆษณาที่มีชิ้นงานบางอย่างที่ AI สร้างขึ้นหรือแก้ไขด้วย AI ต้องมีการเปิดเผยข้อมูลเพื่อแจ้งให้ผู้บริโภคทราบว่าโฆษณาสร้างขึ้นด้วย AI ตั้งแต่เดือนกรกฎาคม 2026 เป็นต้นไป Display & Video 360 (DV360) จะอนุญาตให้ผู้ลงโฆษณาเพิ่มป้ายกำกับที่ระบุว่าครีเอทีฟโฆษณาสร้างขึ้นหรือแก้ไขโดยใช้ AI เพื่อช่วยให้ผู้ลงโฆษณาสามารถปฏิบัติตามกฎระเบียบด้านความโปร่งใสของ AI ที่กำลังจะเกิดขึ้น

ผู้ลงโฆษณาสามารถติดป้ายกำกับเหล่านี้ให้กับครีเอทีฟโฆษณาโดยตรง หรือใช้การตั้งค่าป้ายกำกับ AI ผ่าน UI และ API ของ Display & Video 360 ดูข้อมูลเพิ่มเติมเกี่ยวกับ วิธีใช้การตั้งค่าป้ายกำกับเนื้อหา AI เพื่อติดป้ายกำกับโฆษณา

สําหรับโฆษณาที่ Google แสดง กลยุทธ์การปฏิบัติตามข้อกําหนดที่เราเลือกใช้ป้ายกํากับ AI ก่อนคลิกขั้นต่ำและข้อจำกัดหลังคลิกในAbout This Ad (ATA)

สำหรับรูปแบบโฆษณาเนทีฟใน 3PE นั้น Google ไม่ได้ควบคุมการแสดงผลสุดท้ายของ โฆษณา ในกรณีเหล่านี้ ระบบจะเผยแพร่สัญญาณการรับรองนี้เป็นส่วนหนึ่ง ของการตอบกลับของโฆษณาเพื่อให้การแลกเปลี่ยนหรือผู้เผยแพร่โฆษณาสามารถแสดงโฆษณาสุดท้าย รวมถึงป้ายกำกับ AI หรือการเปิดเผยข้อมูล สัญญาณจะเป็นส่วนหนึ่งของadm.native.ext ฟิลด์ในการตอบกลับด้วยโฆษณาเนทีฟ ฟิลด์ใหม่ adm.native.ext อยู่ในรูปแบบต่อไปนี้ 

  "ext" {
     "should_disclose_ai": "true",
     "ai_disclosure_url": ""
  }
  • should_disclosure_ai (จริงหรือเท็จ) ระบุว่าโฆษณาสุดท้ายต้อง มีป้ายกำกับ AI หรือไม่
  • ai_disclosure_url อาจมีหรือไม่ก็ได้ จะแสดงก็ต่อเมื่อตั้งค่า should_disclosure_ai เป็น "จริง" และช่อง URL ของ native.privacy ว่างเปล่า ในกรณีนี้ การคลิกป้ายกำกับ AI ควรนำผู้ใช้ ไปยัง URL ที่ระบุในช่องนั้น หรือหากไม่มี ให้การคลิกป้ายกำกับ AI ควร นำผู้ใช้ไปยังช่อง URL มาตรฐานnative.privacy

ควรส่งต่อสัญญาณเหล่านี้ไปยังผู้เผยแพร่โฆษณาเพื่อให้แสดงโฆษณาที่มีป้ายกำกับ AI ได้

คำถามที่พบบ่อย

DV360 รองรับส่วนขยายที่กำหนดเองของการแลกเปลี่ยนไหม
ได้ นอกเหนือจากส่วนขยายที่ระบุไว้ในข้อกำหนดนี้แล้ว Display & Video 360 ยังอาจรองรับส่วนขยายที่กำหนดเองเป็นรายกรณีด้วย เราขอแนะนำให้ระบุและทดสอบส่วนขยายที่กำหนดเองในระหว่างระยะเวลาการผสานรวม
DV360 รองรับวิดีโอที่มีการให้รางวัลไหม
ได้ โปรดส่งส่วนขยายวิดีโอที่มีการให้รางวัลมาให้เรา
สินค้าคงคลังจำนวนมากของฉันแสดงเป็นข้อมูลประชากรที่ไม่รู้จัก ฉันจะปรับปรุงความครอบคลุมของข้อมูลประชากรได้อย่างไร
ป้อนข้อมูล user.yob และ user.gender ในคำขอเสนอราคาไปยัง DV360 เพื่อเพิ่ม ความครอบคลุม
DV360 มีปลายทางสำหรับแต่ละภูมิภาคไหม
ไม่ได้ เราใช้ปลายทางเดียวทั่วโลกและกำหนดเส้นทางการส่งคำขอไปยัง ศูนย์ข้อมูลที่ใกล้ที่สุดโดยอัตโนมัติ ดังนั้นจึงไม่มีปลายทางเฉพาะภูมิภาคที่เราจะให้ได้
คำขอแบบเซิร์ฟเวอร์ต่อเซิร์ฟเวอร์ (S2S) มีข้อกำหนดอะไรบ้าง
ติดต่อเพื่อขอ เพิ่มในรายการที่อนุญาต ต้องส่งต่อ User Agent ของไคลเอ็นต์ และตรวจสอบว่าได้ปิดใช้/ละเว้นคุกกี้ในการตอบกลับการดึงข้อมูล VAST แบบ s2s
DV360 รองรับ OMID ไหม
เราสามารถวัดการมองเห็นโฆษณาโดยใช้ OMID ได้ตราบใดที่มีการประกาศเป็น เปิดใช้ OMID ในเวลาที่ส่งคำขอราคาเสนอ รายละเอียดเกี่ยวกับเรื่องนี้สรุปไว้ในหน้า 24-25
คุณรองรับ Native เวอร์ชันใด คุณมีข้อกำหนดสำหรับโฆษณาเนทีฟไหม
เรารองรับเฉพาะโฆษณาเนทีฟเวอร์ชัน 1.2 ข้อกำหนด โฆษณาเนทีฟ
DV360 รองรับคำขอราคาเสนอที่ส่งเป็น GZIP ไหม
DV360 รับคำขอเสนอราคาที่บีบอัดด้วย gzip ได้ และจะตอบกลับด้วยการตอบกลับที่บีบอัดด้วย gzip หากส่วนหัว Accept-Encoding ระบุว่ารองรับ
DV360 รองรับ DBURL ไหม
ยังไม่ได้ในตอนนี้
DV360 รองรับการแจ้งเตือนการสูญเสียไหม
ใช่ DV360 จะป้อนข้อมูลฟิลด์ bid.lurl ในการเสนอราคาตอบ หากการเสนอราคาแพ้ การแลกเปลี่ยนอาจส่งคำสั่ง ping ไปยัง URL นี้พร้อมเหตุผล และ เหตุผลนั้นจะแสดงต่อผู้ลงโฆษณา เหตุผลเหล่านี้จะช่วยให้ ผู้ลงโฆษณาทราบวิธีหลีกเลี่ยงการสูญเสียในอนาคต
DV360 ต้องใช้ App.name สำหรับการกำหนดเป้าหมายไหม
ไม่ DV360 ใช้ App.name เพื่อการอ้างอิง แต่ไม่จำเป็นสำหรับการกำหนดเป้าหมาย App.bundle ใช้สำหรับการกำหนดเป้าหมาย
DV360 รองรับโฆษณาหลายขนาดที่ส่งในคำขอราคาเสนอเดียวได้ไหม
ได้ เราจะพิจารณาขนาดครีเอทีฟโฆษณาทั้งหมดที่มีสิทธิ์ใน banner.format
DV360 รองรับหลายรูปแบบในคำขอราคาเสนอเดียวกันไหม
เรามีการสนับสนุนคำขอราคาเสนอแบบ Multi-Format อย่างจำกัด แต่กำลังดำเนินการ ปรับปรุง เรารองรับรูปแบบ Display และวิดีโอสำหรับโฆษณาคั่นระหว่างหน้า แต่ไม่รองรับ Display และเนทีฟในขณะนี้ หากคุณส่งคำขอเสนอราคาแบบ Multi-Format โปรดติดต่อเพื่อขอรับการทดสอบ
DV360 รองรับการแสดงผลแบบผสมในคำขอเดียวกันไหม
ปัจจุบันเรารองรับเฉพาะโฆษณาวิดีโอ/แบนเนอร์คั่นระหว่างหน้า เรากำลังดำเนินการกับ เนทีฟ/แบนเนอร์และวิดีโอ/แบนเนอร์ หากมีการผสมผสานอื่นๆ โปรดติดต่อทีมของเรา
ผู้ซื้อหลายรายสามารถส่งราคาเสนอหลายรายการสำหรับโอกาสในการแสดงผลดังกล่าวอย่างน้อย 1 รายการในคำขอเดียวกันได้ไหม
ได้
DV360 มีโซลูชันหรือความต้องการเฉพาะเกี่ยวกับการจำกัดจำนวนครั้งหรือการแสดงผู้ลงโฆษณารายเดียวกันสำหรับโอกาสในการแสดงผลดังกล่าวหลายครั้งในคำขอเดียวกันหรือไม่
DV360 บังคับใช้ว่าผู้ลงโฆษณารายหนึ่งๆ จะเสนอราคาได้สูงสุดเพียง 1 โอกาสในการแสดงผล ต่อคำขอแต่ละรายการ เราคาดหวังให้ SSP จัดกลุ่มออบเจ็กต์การแสดงผล อย่างมีความหมาย เช่น ทั้งหมดในหน้าเดียวกัน ทั้งหมดในแอปเดียวกัน เป็นต้น
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"
}

ติดต่อเรา

หากมีข้อสงสัยหรือปัญหา โปรดติดต่อทีมสนับสนุนของ Exchange