คุณอาจใส่พารามิเตอร์การกำหนดเป้าหมายต่อไปนี้หรือไม่ก็ได้
เมื่อสร้างหรือกำหนดค่าแหล่งที่มาของเนื้อหาสำหรับวิดีโอออนดีมานด์ (VOD) หรือตั้งค่าสตรีมแบบสดสำหรับ DAI คุณจะต้องระบุแท็กโฆษณาวิดีโอเริ่มต้น โดยสตรีม DAI ทั้งหมดจะใช้แท็กโฆษณาดังกล่าวและพารามิเตอร์ของแท็กนั้นโดยค่าเริ่มต้น พารามิเตอร์แท็กโฆษณามีผลกับทั้งโฆษณาตอนกลางและโฆษณาตอนต้น หากต้องการให้โปรแกรมเล่นขอบางสิ่งอย่างเจาะจงสำหรับสตรีมใดก็ตาม คุณจะใช้ตัวเลือกเหล่านี้ได้
พารามิเตอร์แท็กโฆษณา Ad Manager ที่ลบล้างได้
ข้ามไปยังพารามิเตอร์ที่เฉพาะเจาะจง ดังนี้
|
rdp sdk_apis 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 |
|
omid_p |
พารามิเตอร์ชื่อพาร์ทเนอร์ OMID จะยอมรับค่าตัวแปรที่ระบุชื่อของพาร์ทเนอร์ที่รวมการวัด OMID และเวอร์ชันของพาร์ทเนอร์ พารามิเตอร์นี้ใช้ได้กับผู้เผยแพร่โฆษณาที่ต้องการการวัดมุมมองแอ็กทีฟเมื่อใช้ Open Measurement SDK (OM SDK) เท่านั้น ซึ่งไม่ควรใช้พารามิเตอร์นี้หากใช้ IMA SDK เพราะตั้งค่าไว้โดยอัตโนมัติ หากต้องการระบุการรองรับ OMID เมื่อใช้ไลบรารีการเข้าถึงแบบเป็นโปรแกรม (PAL) คุณต้องใช้ API ของ |
เมื่อใช้ PAL
|
|
gdpr gdpr_consent |
ช่องเหล่านี้ใช้เพื่อส่งข้อมูลความยินยอมของ TCF เวอร์ชัน 2.0 สำหรับคำขอซิงค์คุกกี้ทั้งแบบขาเข้าและขาออก |
ดูข้อกำหนด GDPR |
|
givn|paln |
สำหรับการผสานรวมที่ใช้ไลบรารีการเข้าถึงแบบเป็นโปรแกรม (PAL) พารามิเตอร์ video nonce จะยอมรับค่าสตริงแบบตัวแปร หมายเลขที่ไม่ซ้ำกันนี้ปลอดภัยสำหรับ URL คุณจึงไม่ต้องเข้ารหัส URL หมายเหตุ: หากก่อนหน้านี้คุณระบุ Nonce โดยใช้พารามิเตอร์ |
อ่านข้อมูลเพิ่มเติมเกี่ยวกับค่าที่ส่งต่อไปยังพารามิเตอร์นี้ได้ในคู่มือการเริ่มต้นใช้งานสำหรับ PAL | |
addtl_consent |
รายชื่อผู้ให้บริการเทคโนโลยีโฆษณาของ Google ซึ่งได้รับความยินยอมแล้วแต่ไม่ได้ลงทะเบียนกับ IAB |
ดูข้อกำหนดความยินยอมเพิ่มเติม |
|
rdp |
คุณต้องตั้งค่า |
|
|
sdk_apis |
พารามิเตอร์เฟรมเวิร์กของ SDK API ยอมรับรายการที่คั่นด้วยคอมมาของค่าจํานวนเต็มคงที่ ซึ่งระบุเฟรมเวิร์กของ API ทั้งหมดที่โปรแกรมเล่นรองรับ ดูรายการค่าเฟรมเวิร์ก API ที่เป็นไปได้ พารามิเตอร์นี้ใช้โดยผู้เผยแพร่โฆษณาที่ใช้ไลบรารีการเข้าถึงแบบเป็นโปรแกรม (PAL) หากคุณพยายามตั้งค่าพารามิเตอร์นี้ขณะใช้ IMA SDK ระบบจะลบล้างค่าด้วยค่าที่ IMA SDK รองรับ |
sdk_apis=2,7,9 |
|
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"
}
โครงสร้าง adTagParameters
ที่ใช้ค่าที่เข้ารหัสสำหรับคำขอสตรีม 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> |
(ที่มีการประกาศเนื้อหา ที่มีเด็กเป็นกลุ่มเป้าหมาย) |
|
(ที่มีหน่วยโฆษณาและคีย์-ค่าที่ถูกลบล้าง และ description_url ที่กำหนดเองและการประกาศเนื้อหาที่มีเด็กเป็นกลุ่มเป้าหมาย) |
https://dai.google.com/linear/hls/event/<asset_key> |
อัปเดตพารามิเตอร์การกำหนดเป้าหมายแบบไดนามิกในระหว่างที่มีการสตรีมไลฟ์สด
คุณอัปเดตข้อมูลการกำหนดเป้าหมายแบบไดนามิกให้กับผู้ใช้ที่กำลังดูสตรีมอยู่เป็นรายบุคคลได้โดยใช้เมธอด replaceAdTagParameters ใน IMA DAI SDK