คุณอาจใส่พารามิเตอร์การกำหนดเป้าหมายต่อไปนี้หรือไม่ก็ได้
เมื่อสร้างหรือกำหนดค่าแหล่งที่มาของเนื้อหาสำหรับวิดีโอออนดีมานด์ (VOD) หรือตั้งค่าสตรีมแบบสดสำหรับ DAI คุณจะต้องระบุแท็กโฆษณาวิดีโอเริ่มต้น โดยสตรีม DAI ทั้งหมดจะใช้แท็กโฆษณาดังกล่าวและพารามิเตอร์ของแท็กนั้นโดยค่าเริ่มต้น พารามิเตอร์แท็กโฆษณามีผลกับทั้งโฆษณาตอนกลางและโฆษณาตอนต้น หากต้องการให้วิดีโอเพลเยอร์ขอบางสิ่งอย่างเจาะจงสำหรับสตรีมใดก็ตาม คุณจะใช้ตัวเลือกเหล่านี้ได้
พารามิเตอร์แท็กโฆษณา Ad Manager ที่ลบล้างได้
ข้ามไปยังพารามิเตอร์ที่เฉพาะเจาะจง ดังนี้
addtl_consent an ciu_szs cust_params description_url gdpr gdpr_consent idtype is_lat |
iu ltd mpt mpv npa ppid ptpl ptpln rdid |
rdp sid sz tfcd trt vconp vpa vpmute wta |
ลบล้างแท็กโฆษณาเริ่มต้น
เมื่อวิดีโอเพลเยอร์ขอสตรีม ระบบจะใช้แท็กโฆษณาเริ่มต้นเหมือนที่คุณระบุไว้ในอินเทอร์เฟซทุกประการ อย่างไรก็ตาม คุณลบล้างพารามิเตอร์ที่ต้องการของแท็กนั้นได้ในคำขอสตรีม ซึ่งจะเป็นพารามิเตอร์เดียวที่ลบล้างได้
ดูวิธีลบล้างแท็กโฆษณาเริ่มต้นโดยใช้ IMA SDK หรือใช้ SSB
พารามิเตอร์ | คำอธิบาย | ค่าตัวอย่าง | |
---|---|---|---|
iu |
หน่วยโฆษณาปัจจุบัน ซึ่งควรเป็นไปตามรูปแบบต่อไปนี้ |
iu=/6062/video/example_unit |
|
cust_params |
คู่คีย์-ค่าที่ควรใช้สำหรับการกำหนดเป้าหมายแคมเปญ Ad Manager แพลตฟอร์มบางอย่างจำเป็นต้องใช้การเข้ารหัส URL ข้อกําหนดการเข้ารหัส URL จะไม่มีผลเมื่อใช้ IMA DAI SDK สําหรับ HTML5 เนื่องจากระบบจะเข้ารหัสค่าโดยอัตโนมัติ พารามิเตอร์นี้จะไม่ทํางานหากมีการเข้ารหัสใน HTML5 แล้ว |
ตัวอย่างการใช้คู่คีย์-ค่าหลายรายการมีดังนี้
สตรีม SSB: เข้ารหัสและเชื่อมโยงค่า
Chromecast:
Roku: เข้ารหัสและเชื่อมโยงค่า
iOS และ tvOS: อย่าเข้ารหัสข้อมูลใดๆ
Android: อย่าเข้ารหัสข้อมูลใดๆ
|
|
sz |
การลบล้างพารามิเตอร์ อย่าใส่ " |
sz=400x300 |
|
tfcd |
ติดแท็กคำขอเพื่อใช้การดูแลให้เหมาะสมกับเด็ก เมื่อคําขอ DAI มี |
|
|
ค่านี้ควรเป็นคำอธิบายวิดีโอที่กำลังเล่นอยู่ในหน้าเว็บ โดยปกติแล้วจะเป็นหน้าเว็บที่มีวิดีโอเพลเยอร์ติดตั้งอยู่ แต่ก็อาจเป็นแค่หน้าเว็บที่มีข้อความอธิบายวิดีโอก็ได้ IMA SDK ไม่ได้ตั้งค่าพารามิเตอร์นี้โดยอัตโนมัติ คุณจึงต้องตั้งค่าด้วยตนเอง |
ตัวอย่าง URL ที่เข้ารหัส: ตัวอย่างที่ไม่เข้ารหัส: |
||
ppid |
ตัวระบุที่ผู้เผยแพร่โฆษณามีให้ (PPID) ช่วยให้ผู้เผยแพร่โฆษณาส่งตัวระบุเพื่อใช้กำหนดความถี่สูงสุด การแบ่งกลุ่มเป้าหมายและการกำหนดเป้าหมาย การหมุนเวียนโฆษณาตามลำดับ และการควบคุมการแสดงโฆษณาตามกลุ่มเป้าหมายแบบอื่นๆ ในทุกอุปกรณ์ ดูข้อมูลเพิ่มเติม | ppid= |
|
ciu_szs |
รายการขนาดโฆษณาที่แสดงร่วมซึ่งคั่นด้วยคอมมา DAI รองรับโฆษณาที่แสดงร่วมเมื่อคุณใช้ HTML5 SDK เท่านั้น |
ciu_szs=728x90,300x250 |
|
mpt |
ระบุชื่อวิดีโอเพลเยอร์ของพาร์ทเนอร์ ซึ่งส่วนใหญ่จะใช้โดยพาร์ทเนอร์อย่างเช่น JWPlayer, Brightcove, Ooyala ที่ผสานรวมไว้กับ SDK |
mpt=JWPlayer |
|
mpv |
ระบุเวอร์ชันของวิดีโอเพลเยอร์ของพาร์ทเนอร์ ควรตั้งค่านี้เฉพาะเมื่อมีการตั้งค่า |
mpv=2.1 |
|
ptpl |
รหัสเทมเพลตช่วงพักโฆษณา
คุณจะเห็นรหัสนี้ใน URL ของ Ad Manager เมื่อดูการตั้งค่าของเทมเพลตช่วงพักโฆษณาในอินเทอร์เฟซของ Ad Manager ค่านี้จะแสดงเป็นค่าของพารามิเตอร์ |
ptpl=1234 |
|
ptpln |
ชื่อเทมเพลตช่วงพักโฆษณา พารามิเตอร์นี้จะสอดคล้องตรงกันกับช่อง "ชื่อ" ใน Ad Manager ไม่ใช่ชื่อที่แสดง
|
ptpln=my_break_template |
|
an |
พารามิเตอร์ ควรใช้พารามิเตอร์นี้กับคำขอที่ส่งจากแอปบนอุปกรณ์เคลื่อนที่และอุปกรณ์ทีวีที่เชื่อมต่ออินเทอร์เน็ต เนื่องจากโฆษณาวิดีโอแบบเป็นโปรแกรมส่วนใหญ่จำเป็นต้องใช้พารามิเตอร์ดังกล่าว* IMA SDK จะป้อนค่าพารามิเตอร์นี้ให้โดยอัตโนมัติ แต่คุณจะต้องระบุด้วยตนเองโดยใช้ DAI API และ SSB (สภาพแวดล้อมที่ไม่ใช่ SDK) * ในขณะที่ชื่อแอปควรเป็นชื่อที่มนุษย์อ่านเข้าใจง่าย แต่ใน iOS และ tvOS นั้น SDK ไม่อาจเข้าถึงรหัส App Store ที่เป็นตัวเลข 9 หลัก ในกรณีเหล่านี้ SDK จะส่ง App Bundle ผ่านพารามิเตอร์ |
|
|
ltd |
ระบุว่าจะแสดงโฆษณาอย่างจำกัดในกรณีที่ไม่ได้รับความยินยอมให้ใช้คุกกี้หรือตัวระบุอื่นๆ ในเครื่องหรือไม่ ดูข้อมูลเพิ่มเติม | ltd=1 |
|
rdid |
สำหรับแอปพลิเคชันแบบเนทีฟ (ไม่ใช่ในเว็บหรือเว็บบนอุปกรณ์เคลื่อนที่) SDK จะส่งตัวระบุอุปกรณ์ที่รีเซ็ตได้สำหรับผู้ใช้ที่กำหนดเป้าหมายในคำขอสตรีมของคุณด้วยพารามิเตอร์สำหรับ rdid , idtype และ is_lat ในสตรีม SSB คุณต้องส่งพารามิเตอร์เหล่านี้มาให้ชัดเจนเหมือนที่ส่งสำหรับคำขอโฆษณาโซลูชันวิดีโอในฝั่งไคลเอ็นต์
|
ดูตัวอย่างโดยละเอียดของตัวระบุอุปกรณ์ที่รีเซ็ตได้ | |
trt |
ระบุว่าเป็นการเข้าชมที่ซื้อมาหรืออื่นๆ |
ประเภทการเข้าชมที่ไม่ได้กำหนดค่า: การเข้าชมที่ซื้อมา: การเข้าชมจากการค้นหาทั่วไป: |
|
vconp |
แนะนำตามหลักเกณฑ์การวัดผลวิดีโอของ MRC Video Measurement Guidelines
ระบุว่าวิดีโอเพลเยอร์ประสงค์จะเล่นวิดีโอเนื้อหาทีละรายการอย่างต่อเนื่องซึ่งคล้ายกับการออกอากาศทางทีวีหรือไม่ หากเปิดการเล่นต่อเนื่อง ให้ตั้งค่าเป็น หากไม่ทราบ ให้ปล่อยพารามิเตอร์นี้ไว้โดยไม่ต้องตั้งค่า |
เปิดการเล่นต่อเนื่อง:vconp=2 ปิดการเล่นต่อเนื่อง: |
|
vpa |
แนะนำตามหลักเกณฑ์การวัดผลวิดีโอของ MRC Video Measurement Guidelines
ระบุว่าโฆษณาจะเริ่มเล่นด้วยการเล่นอัตโนมัติหรือการคลิก หากต้องการให้หน้าเว็บรอการดำเนินการจากผู้ใช้ ให้ตั้งเป็น หากไม่ทราบ ให้ปล่อยพารามิเตอร์นี้ไว้โดยไม่ต้องตั้งค่า |
เล่นอัตโนมัติ:vpa=auto คลิก: |
|
vpmute |
แนะนำตามหลักเกณฑ์การวัดผลวิดีโอของ MRC Video Measurement Guidelines
ระบุว่าโฆษณาจะเริ่มเล่นขณะที่วิดีโอเพลเยอร์ปิดเสียงอยู่หรือไม่ หากต้องการให้เล่นเมื่อปิดเสียง ให้ตั้งค่าเป็น หากไม่ทราบ ให้ปล่อยพารามิเตอร์นี้ไว้โดยไม่ต้องตั้งค่า |
ปิดเสียง:vpmute=1 เปิดเสียง: |
|
npa |
การตั้งค่าการปรับตามโปรไฟล์ของผู้ใช้สำหรับคำขอโฆษณา คุณควรระบุพารามิเตอร์นี้ในช่วงต้นๆ ของแท็กเพื่อหลีกเลี่ยงความเสี่ยงที่จะถูกตัดออก
ระบุ |
npa=1 |
|
gdpr gdpr_consent |
ช่องเหล่านี้ใช้เพื่อส่งข้อมูลความยินยอมของ TCF เวอร์ชัน 2.0 สำหรับคำขอซิงค์คุกกี้ทั้งแบบขาเข้าและขาออก |
ดูข้อกำหนด GDPR |
|
addtl_consent |
รายชื่อผู้ให้บริการเทคโนโลยีโฆษณาของ Google ซึ่งได้รับความยินยอมแล้วแต่ไม่ได้ลงทะเบียนกับ IAB |
ดูข้อกำหนดความยินยอมเพิ่มเติม |
|
rdp |
คุณต้องตั้งค่า |
|
|
sid |
ประเภทของรหัสโฆษณาที่รักษาความเป็นส่วนตัวที่ใช้ได้เฉพาะเพื่อจุดประสงค์ในการกำหนดความถี่สูงสุดเท่านั้น ตามหลักเกณฑ์ IFA ของ IAB พารามิเตอร์นี้ต้องระบุในรูปแบบ UUID ดูข้อมูลเพิ่มเติม คุณเลือกไม่ใช้การส่งรหัสเซสชันได้โดยการตั้งค่า |
|
|
wta |
ระบุว่าวิดีโอเพลเยอร์รองรับการแสดงข้อความ "ทําไมจึงแสดงโฆษณานี้" หรือไม่ โดยจะมีการรองรับโดยอัตโนมัติเมื่อใช้ IMA SDK หากไม่ได้ใช้ IMA SDK วิดีโอเพลเยอร์ต้องใช้การรองรับ SSB ไม่รองรับ WTA ต้องมีข้อมูลในช่องนี้หากคุณใช้ Ad Exchange ดูข้อมูลเพิ่มเติม * ไม่จำเป็นต้องรองรับ |
รองรับ: ไม่รองรับ: |
ลบล้างแท็กโฆษณาเริ่มต้นโดยใช้ IMA SDK
เมื่อวิดีโอเพลเยอร์ขอสตรีม DAI โดยใช้ IMA SDK สตรีมจะส่งไปในช่องที่ชื่อ "adTagParameters
" ได้ โครงสร้างที่มีลักษณะเหมือนพจนานุกรมนี้จะตั้งค่าด้วยคู่คีย์-ค่าได้ โดยคีย์อาจเป็นพารามิเตอร์แท็กโฆษณา Ad Manager ที่แสดงอยู่ในตารางด้านบน
คุณปรับแต่งสตรีมและส่งพารามิเตอร์ที่ไม่เกี่ยวข้องกับคำขอโฆษณา Ad Manager รวมเข้าไปโดยใช้โครงสร้างเดิมนี้ได้ ดูวิธีขอตัวแปรสตรีมเฉพาะที่ต้องการและวิธีตั้งค่าการพักโฆษณา
การนำข้อมูลช่อง adTagParameters
ไปใช้งานอาจแตกต่างกันไป ขึ้นอยู่กับภาษาหรือแพลตฟอร์มในการเขียนโปรแกรมที่ใช้ โปรดดูเอกสารประกอบการพัฒนาซอฟต์แวร์ของ iOS, Android, tvOS, Chromecast, HTML5 หรือเอกสารเพิ่มเติมในคู่มือเพื่อการพัฒนาวิดีโอเพลเยอร์และแอป DAI
ตั้งค่า adTagParameters ผ่าน SDK
เมื่อคุณตั้งค่า cust_params
หรือ description_url
ผ่าน SDK ในแอป iOS, tvOS และ Android คุณไม่ควรเข้ารหัส URL ให้สตริง แต่ส่งผ่าน cust_params
เป็นสตริงเดี่ยวที่เชื่อมต่อคู่คีย์-ค่าด้วย "&
" ได้
เช่น หากต้องการตั้งค่า cust_params
ให้เป็นค่า sport=football&city=newyork
ให้ทำดังนี้
โครงสร้าง adTagParams
ที่ใช้ค่าที่ไม่เข้ารหัสจะมีลักษณะดังนี้
{
"tfcd": 1,
"iu": "/987654321/path/to/adunit",
"cust_params": "sport=football&city=newyork",
"description_url": "http://www.sample.com/golf.html",
"ppid": "12JD92JD8078S8J29SDOAKC0EF230337"
}
โครงสร้าง adTagPar พารามิเตอร์
ที่ใช้ค่าที่เข้ารหัสสำหรับคำขอสตรีม HTML5 จะมีลักษณะดังนี้
{
"tfcd": 1,
"iu": "/987654321/path/to/adunit",
"cust_params": "sport%3Dfootball%26city%3Dnewyork",
"description_url": "http%3A%2F%2Fwww.sample.com%2Fgolf.html",
"ppid": "12JD92JD8078S8J29SDOAKC0EF230337"
}
โครงสร้าง adTagParams
ที่ใช้ค่าที่เข้ารหัสสำหรับคำขอสตรีม Roku จะมีลักษณะดังนี้
request.adTagParams="tfcd=1&iu=/987654321/path/to/adunit&cust_params=sport%3Dfootball%26city%3Dnewyork&description_url=http%3A%2F%2Fwww.sample.com%2Fgolf.html&ppid=12JD92JD8078S8J29SDOAKC0EF230337"
ลบล้างแท็กโฆษณาเริ่มต้นโดยใช้ DAI API (เบต้า)
เมื่อวิดีโอเพลเยอร์ขอสตรีม DAI ด้วยการใช้ DAI API โปรแกรมจะเลือกส่งคู่คีย์-ค่าได้ โดยคีย์อาจเป็นพารามิเตอร์แท็กโฆษณา Ad Manager ที่แสดงในตารางด้านบน
ควรส่งพารามิเตอร์เหล่านี้โดยเป็นส่วนหนึ่งของเนื้อหาคำขอ POST ของ HTTP ของฟอร์มประเภท application/x‑www‑form‑urlencoded
สำหรับทั้งสตรีมเชิงเส้น/แบบสดและ VOD
คุณปรับแต่งสตรีมและส่งพารามิเตอร์ที่ไม่เกี่ยวข้องกับคำขอโฆษณา Ad Manager รวมเข้าไปโดยใช้โครงสร้างเดิมนี้ได้ ดูวิธีขอพารามิเตอร์ตัวแปรสตรีมที่เฉพาะเจาะจงและการตรวจสอบสิทธิ์ HMAC
ลบล้างแท็กโฆษณาเริ่มต้นโดยใช้ SSB
ต่อไปนี้คือตัวอย่างของการแก้ไขแท็กโฆษณา VOD เริ่มต้นของ SSB พารามิเตอร์ที่ถูกเขียนทับที่วิดีโอเพลเยอร์หรือแอปส่งจะมีการไฮไลต์ไว้
ตัวอย่างวิดีโอตามคำขอ |
ตัวอย่าง | |
---|---|
URL สตรีม VOD พื้นฐาน | http://dai.google.com/ondemand/hls/content/ |
(ที่มีการระบุหน่วยโฆษณา) | http://dai.google.com/ondemand/hls/content/ |
(ที่มีคีย์-ค่า ที่ถูกลบล้าง) |
http://dai.google.com/ondemand/hls/content/ |
(ที่มีการประกาศเนื้อหา ที่มีเด็กเป็นกลุ่มเป้าหมาย) |
http://dai.google.com/ondemand/hls/content/ |
(ที่มีหน่วยโฆษณาและคีย์-ค่าที่ถูกลบล้าง และ description_url ที่กำหนดเองและการประกาศเนื้อหาที่มีเด็กเป็นกลุ่มเป้าหมาย) |
http://dai.google.com/ondemand/hls/content/ |
ตัวอย่างสตรีมแบบสด |
ตัวอย่าง | |
---|---|
URL สตรีมเชิงเส้นแบบสดพื้นฐาน | https://dai.google.com/linear/hls/event/<asset_key> |
(ที่มีการระบุหน่วยโฆษณา) | https://dai.google.com/linear/hls/event/<asset_key> |
(ที่มีคีย์-ค่าที่ถูกลบล้าง) | https://dai.google.com/linear/hls/event/<asset_key> |
(ที่มีการประกาศเนื้อหา ที่มีเด็กเป็นกลุ่มเป้าหมาย) |
https://dai.google.com/linear/hls/event/<asset_key> /master.m3u8?tfcd=1 |
(ที่มีหน่วยโฆษณาและคีย์-ค่าที่ถูกลบล้าง และ description_url ที่กำหนดเองและการประกาศเนื้อหาที่มีเด็กเป็นกลุ่มเป้าหมาย) |
https://dai.google.com/linear/hls/event/<asset_key> |
อัปเดตพารามิเตอร์การกำหนดเป้าหมายแบบไดนามิกในระหว่างที่มีการสตรีมแบบสด
คุณอัปเดตข้อมูลการกำหนดเป้าหมายแบบไดนามิกให้กับผู้ใช้ที่กำลังดูสตรีมอยู่เป็นรายบุคคลได้โดยใช้เมธอด replaceAdTagParametersreplaceAdTagParametersreplaceAdTagParameters ใน IMA DAI SDK