บทความนี้แสดงรายการพารามิเตอร์ที่จำเป็นและแนะนำสำหรับแท็กโฆษณา VAST ที่ใช้แสดงโฆษณาในการติดตั้งใช้งานทีวีที่เชื่อมต่ออินเทอร์เน็ต
ในหน้านี้
- พารามิเตอร์ที่จำเป็นสำหรับการแสดงโฆษณา
- พารามิเตอร์ที่จำเป็นสำหรับรายการแบบเป็นโปรแกรม
- พารามิเตอร์ที่แนะนำสำหรับรายการแบบเป็นโปรแกรม
คุณสามารถดูรายการสำหรับประเภทการติดตั้งใช้งานอื่นๆ หรือข้อกำหนด URL สำหรับแท็กโฆษณา VAST
พารามิเตอร์ที่จำเป็นและแนะนำสำหรับทีวีที่เชื่อมต่ออินเทอร์เน็ต
พารามิเตอร์ที่จำเป็นสำหรับการแสดงโฆษณา
correlator (สหสัมพันธ์)
คำอธิบาย
พารามิเตอร์สหสัมพันธ์ (correlator) จะยอมรับค่าตัวแปรซึ่งใช้ร่วมกันระหว่างคำขอหลายรายการที่มาจากการดูหน้าเว็บครั้งเดียวกัน พารามิเตอร์นี้ใช้เพื่อยกเว้นโฆษณาของคู่แข่ง ซึ่งรวมถึงในสภาพแวดล้อมที่ไม่มีคุกกี้
ตัวอย่างการใช้
correlator=4345645667
ข้อกำหนดและคำแนะนำ
พารามิเตอร์นี้จำเป็นสำหรับการใช้การแสดงโฆษณาในเว็บ แอปบนอุปกรณ์เคลื่อนที่ ทีวีที่เชื่อมต่ออินเทอร์เน็ต เสียง และสื่อดิจิทัลนอกบ้าน
การใช้งาน SDK
- ถ้ามีการใช้ IMA SDK ก็จะมีการตั้งค่าสหสัมพันธ์โดยอัตโนมัติ หากโปรแกรมเล่นพยายามตั้งค่านี้ SDK จะเขียนทับค่านี้ด้วยค่าของตัวเอง
- หากไม่ได้ใช้ IMA SDK ให้ตรวจสอบว่าคุณตั้งค่านี้เป็นจำนวนบวกแบบสุ่มที่แท้จริง ซึ่งไม่ถูกใช้ซ้ำโดยการดูหน้าเว็บหลายๆ ครั้ง
env (สภาพแวดล้อม)
คำอธิบาย
พารามิเตอร์สภาพแวดล้อม (env) จะยอมรับค่าคงที่ที่ระบุคำขอในสตรีม หรือระบุว่าคำขอมาจากวิดีโอเพลเยอร์โดยเฉพาะ
ค่าที่เป็นไปได้คือ instream ซึ่งใช้สำหรับโฆษณาวิดีโอและโฆษณาเสียง หรือ vp ซึ่งใช้ได้กับโฆษณาวิดีโอเท่านั้น
ตัวอย่างการใช้
วิดีโอและ/หรือเสียง:
env=instream
วิดีโอเท่านั้น:
env=vp
ข้อกำหนดและคำแนะนำ
พารามิเตอร์นี้จำเป็นสำหรับการใช้การแสดงโฆษณาในเว็บ แอปบนอุปกรณ์เคลื่อนที่ ทีวีที่เชื่อมต่ออินเทอร์เน็ต เสียง และสื่อดิจิทัลนอกบ้าน
พารามิเตอร์นี้จำเป็นสำหรับการรายงานประเภทคำขออย่างถูกต้องโดยแยกตาม "แท็กวิดีโอ"
gdfp_req (ตัวบ่งชี้สคีมา)
คำอธิบาย
พารามิเตอร์ตัวระบุสคีมา Google Ad Manager (gdfp_req) จะยอมรับค่าคงที่ซึ่งระบุว่าคำขอโฆษณามีไว้สำหรับพื้นที่โฆษณา Google Ad Manager
ตัวอย่างการใช้
gdfp_req=1
ข้อกำหนดและคำแนะนำ
พารามิเตอร์นี้จำเป็นสำหรับการใช้การแสดงโฆษณาในเว็บ แอปบนอุปกรณ์เคลื่อนที่ ทีวีที่เชื่อมต่ออินเทอร์เน็ต เสียง และสื่อดิจิทัลนอกบ้าน
iu (หน่วยโฆษณา)
คำอธิบาย
พารามิเตอร์หน่วยโฆษณา (iu) จะยอมรับค่าตัวแปรซึ่งควรตั้งค่าเป็นหน่วยโฆษณาปัจจุบันในรูปแบบ /network_code/.../ad_unit
ตัวอย่างการใช้
iu=/6062/videodemo
ข้อกำหนดและคำแนะนำ
พารามิเตอร์นี้จำเป็นสำหรับการใช้การแสดงโฆษณาในเว็บ แอปบนอุปกรณ์เคลื่อนที่ ทีวีที่เชื่อมต่ออินเทอร์เน็ต เสียง และสื่อดิจิทัลนอกบ้าน
output (เอาต์พุต)
คำอธิบาย
พารามิเตอร์รูปแบบเอาต์พุต (output) จะยอมรับค่าคงที่ซึ่งควรตั้งค่าเป็นรูปแบบเอาต์พุตของโฆษณา
ตัวอย่างการใช้
ใช้เวอร์ชัน VAST เริ่มต้นของเครือข่าย
output=vast
ใช้ VAST 4 (คุณตั้งค่าเวอร์ชันที่เจาะจงสำหรับแท็กที่เฉพาะเจาะจงได้)
output=xml_vast4
ใช้การตั้งค่า VMAP เริ่มต้นของเครือข่าย
output=vmap
ใช้ VMAP 1
output=xml_vmap1
ใช้ VMAP 1 ที่แสดง VAST 4 (หากคุณแสดง VAST ใน VMAP)
output=xml_vmap1_vast4
ข้อกำหนดและคำแนะนำ
พารามิเตอร์นี้จำเป็นสำหรับการใช้การแสดงโฆษณาในเว็บ แอปบนอุปกรณ์เคลื่อนที่ ทีวีที่เชื่อมต่ออินเทอร์เน็ต เสียง และสื่อดิจิทัลนอกบ้าน คุณต้องแสดงผลรูปแบบการตอบสนองการแสดงโฆษณาที่ถูกต้อง
การใช้งาน SDK
สำหรับ VAST หากวิดีโอเพลเยอร์ใช้ IMA SDK พารามิเตอร์เอาต์พุตสำหรับคำขอโฆษณาวิดีโอจะตั้งค่าเป็น output=xml_vast4 เสมอ ซึ่งไม่ก่อให้เกิดความเสี่ยงด้านความน่าเชื่อถือ เนื่องจาก SDK ดังกล่าวใช้งานย้อนหลังได้กับ VAST ทุกเวอร์ชันที่เซิร์ฟเวอร์โฆษณาบุคคลที่สามอาจจะแสดง
เวอร์ชัน VAST สำหรับ Authorized Buyers และการเสนอราคาแบบเปิด
หากต้องการกรองตามเวอร์ชัน VAST อย่างเข้มงวดสำหรับ Authorized Buyers และการเสนอราคาแบบเปิด คุณสามารถเปิดการตั้งค่า "กรองเวอร์ชัน VAST อย่างเข้มงวด" ในการตั้งค่าเครือข่าย
sz (ขนาด)
คำอธิบาย
พารามิเตอร์ขนาด (sz) ยอมรับค่าตัวแปร ซึ่งควรตั้งค่าเป็นขนาดของช่องโฆษณาวิดีโอหลัก
หากมีหลายขนาด ควรคั่นด้วยเครื่องหมายไปป์ (|)
อย่าใส่ "v" หลังขนาด
ตัวอย่างการใช้
ขนาดเดียว:sz=400x300
หลายขนาด:sz=300x250|400x300
ข้อกำหนดและคำแนะนำ
พารามิเตอร์นี้จำเป็นสำหรับการใช้การแสดงโฆษณาในเว็บ แอปบนอุปกรณ์เคลื่อนที่ ทีวีที่เชื่อมต่ออินเทอร์เน็ต และสื่อดิจิทัลนอกบ้าน
ไม่บังคับให้ใช้พารามิเตอร์นี้ถ้าขอเพียง ad_type=audio
url (URL)
คำอธิบาย
พารามิเตอร์ของ URL (url) ยอมรับค่าตัวแปรซึ่งควรตั้งค่าเป็น URL แบบเต็มที่มีการส่งคำขอ โดยค่านี้จะช่วยให้ผู้ซื้อระบุและเข้าใจรายละเอียดแหล่งที่มาของคำขอ ระบบควรป้อนค่านี้ในคำขอโฆษณาเท่าที่ทำได้โดยอัตโนมัติ
- สำหรับเว็บ นี่คือ URL ของหน้าที่แสดงวิดีโอเพลเยอร์
- ในสภาพแวดล้อมที่ไม่ใช่เว็บ ค่านี้ควรตั้งเป็น URL ที่นำเสนอได้อย่างถูกต้องที่สุดถึงพื้นที่โฆษณาวิดีโอหรือเสียงที่ใช้สร้างรายได้ เช่น หากผู้ใช้ดูวิดีโอในแอปบนอุปกรณ์เคลื่อนที่ ซึ่งก็สามารถดูบนคอมพิวเตอร์เดสก์ท็อปได้ด้วยโดยใช้ URL ที่เทียบเท่า*
หมายเหตุ: url แตกต่างจาก description_url ตรงที่ url หมายถึงตำแหน่งที่ส่งคำขอโฆษณา ส่วน description_url คือหน้าเว็บที่ทำการ Crawl ได้ซึ่งอธิบายเนื้อหาวิดีโอ
ค่าของพารามิเตอร์นี้ควรเข้ารหัสไว้
ตัวอย่างการใช้
url=https%3A%2F%2Fwww.example.com%2Fvideo.html
* สำหรับแอป หากไม่สามารถตั้งพารามิเตอร์นี้เป็นค่า URL ตัวแปร ขอแนะนำให้ใช้รูปแบบต่อไปนี้ url=https%3A%2F%2F<app/bundleid>.example.com
ข้อกำหนดและคำแนะนำ
พารามิเตอร์นี้จำเป็นเฉพาะสำหรับการสร้างรายได้แบบเป็นโปรแกรมในเว็บ แอปบนอุปกรณ์เคลื่อนที่ ทีวีที่เชื่อมต่ออินเทอร์เน็ต เสียง และสื่อดิจิทัลนอกบ้าน
การใช้งาน SDK
หากคุณใช้ IMA SDK ระบบจะตั้งค่าของ URL โดยอัตโนมัติ หากเพลเยอร์ตั้งค่านี้ไว้ IMA SDK จะยึดตามค่าดังกล่าว
พารามิเตอร์ที่จำเป็นสำหรับรายการแบบเป็นโปรแกรม
idtype (ประเภทอุปกรณ์)
คำอธิบาย
พารามิเตอร์ตัวระบุอุปกรณ์ที่รีเซ็ตได้ (rdid, idtype, is_lat) ยอมรับค่าตัวแปร ค่านี้เรียกอีกอย่างว่าตัวระบุสำหรับการโฆษณา (IFA)
สำหรับแอปพลิเคชันบนอุปกรณ์เคลื่อนที่ที่ใช้ IMA SDK สำหรับ Android หรือ iOS นั้น IMA SDK จะส่งตัวระบุอุปกรณ์ที่รีเซ็ตได้สำหรับการกําหนดเป้าหมายผู้ใช้ไปยังคําขอสตรีมของคุณด้วยพารามิเตอร์สำหรับ rdid, idtype และ is_lat
เมื่อไม่ได้ใช้ IMA SDK หรือเมื่อใช้บีคอนฝั่งเซิร์ฟเวอร์ (SSB) คุณต้องส่งพารามิเตอร์เหล่านี้เป็นพารามิเตอร์ที่ชัดแจ้ง ดูข้อมูลเพิ่มเติมเกี่ยวกับตัวระบุอุปกรณ์
สำหรับโฆษณาวิดีโอแบบเป็นโปรแกรมเกือบทั้งหมด จำเป็นต้องมีค่าเหล่านี้
|
Apple เลิกใช้งานสัญญาณ |
ตัวอย่างการใช้
ดูตัวอย่างโดยละเอียดของตัวระบุอุปกรณ์ที่รีเซ็ตได้
ข้อกำหนดและคำแนะนำ
แม้ว่าจะไม่จำเป็นต้องใช้พารามิเตอร์เหล่านี้เพื่อแสดงโฆษณาสำหรับการติดตั้งใช้งานใดโดยเฉพาะ แต่ต้องใช้ในการสร้างรายได้แบบเป็นโปรแกรมในแอปบนมือถือ ทีวีที่เชื่อมต่ออินเทอร์เน็ต เสียง และสื่อดิจิทัลนอกบ้าน
สำหรับการติดตั้งใช้งานบนเว็บ ระบบจะไม่ใช้ตัวระบุอุปกรณ์ที่รีเซ็ตได้
การใช้งาน SDK
IMA SDK จะส่งฟิลด์นี้โดยอัตโนมัติ เว้นแต่จะตั้งค่า idType เป็น dpid ในกรณีนี้ ผู้เผยแพร่โฆษณาจะต้องส่งพารามิเตอร์ rdid ด้วยตนเอง
ผู้เผยแพร่โฆษณาจะต้องส่งพารามิเตอร์เหล่านี้ด้วยตนเองเมื่อใช้ PAL SDK
is_lat (จํากัดการติดตามโฆษณา)
คำอธิบาย
พารามิเตอร์ตัวระบุอุปกรณ์ที่รีเซ็ตได้ (rdid, idtype, is_lat) ยอมรับค่าตัวแปร ค่านี้เรียกอีกอย่างว่าตัวระบุสำหรับการโฆษณา (IFA)
สำหรับแอปพลิเคชันบนอุปกรณ์เคลื่อนที่ที่ใช้ IMA SDK สำหรับ Android หรือ iOS นั้น IMA SDK จะส่งตัวระบุอุปกรณ์ที่รีเซ็ตได้สำหรับการกําหนดเป้าหมายผู้ใช้ไปยังคําขอสตรีมของคุณด้วยพารามิเตอร์สำหรับ rdid, idtype และ is_lat
เมื่อไม่ได้ใช้ IMA SDK หรือเมื่อใช้บีคอนฝั่งเซิร์ฟเวอร์ (SSB) คุณต้องส่งพารามิเตอร์เหล่านี้เป็นพารามิเตอร์ที่ชัดแจ้ง ดูข้อมูลเพิ่มเติมเกี่ยวกับตัวระบุอุปกรณ์
สำหรับโฆษณาวิดีโอแบบเป็นโปรแกรมเกือบทั้งหมด จำเป็นต้องมีค่าเหล่านี้
|
Apple เลิกใช้งานสัญญาณ |
ตัวอย่างการใช้
ดูตัวอย่างโดยละเอียดของตัวระบุอุปกรณ์ที่รีเซ็ตได้
ข้อกำหนดและคำแนะนำ
แม้ว่าจะไม่จำเป็นต้องใช้พารามิเตอร์เหล่านี้เพื่อแสดงโฆษณาสำหรับการติดตั้งใช้งานใดโดยเฉพาะ แต่ต้องใช้ในการสร้างรายได้แบบเป็นโปรแกรมในแอปบนมือถือ ทีวีที่เชื่อมต่ออินเทอร์เน็ต เสียง และสื่อดิจิทัลนอกบ้าน
สำหรับการติดตั้งใช้งานบนเว็บ ระบบจะไม่ใช้ตัวระบุอุปกรณ์ที่รีเซ็ตได้
การใช้งาน SDK
IMA SDK จะส่งฟิลด์นี้โดยอัตโนมัติ เว้นแต่จะตั้งค่า idType เป็น dpid ในกรณีนี้ ผู้เผยแพร่โฆษณาจะต้องส่งพารามิเตอร์ rdid ด้วยตนเอง
ผู้เผยแพร่โฆษณาจะต้องส่งพารามิเตอร์เหล่านี้ด้วยตนเองเมื่อใช้ PAL SDK
ott_placement (ตำแหน่งโฆษณา OTT)
คำอธิบาย
พารามิเตอร์ตำแหน่งโฆษณา OTT (ott_placement) จะยอมรับค่าคงที่ซึ่งระบุคำขอตำแหน่งโฆษณาประเภทใดประเภทหนึ่ง
คำจำกัดความของตำแหน่งโฆษณาสำหรับตัวอย่างด้านล่าง
- หยุดชั่วคราว: รูปแบบนอกสตรีมที่ปรากฏผ่านการวางซ้อนบนเนื้อหาวิดีโอเมื่อผู้ใช้หยุดเล่นเนื้อหาชั่วคราว
- หน้าจอหลัก: โฆษณาที่ปรากฏบนหน้าจอหลักของอุปกรณ์ CTV หรือแอป OTT ซึ่งรวมถึงการใช้งานโฆษณา Masthead, แบนเนอร์ และการ์ดในหน้าจอหลัก
- ภาพซ้อนภาพ: โฆษณาวิดีโอในสตรีมที่เล่นในวิดีโอเพลเยอร์โฆษณาแยกต่างหากข้างเนื้อหาวิดีโอ โดยปกติแล้วจะต้องบีบอัดเนื้อหาวิดีโอกลับและโหลดวิดีโอเพลเยอร์ที่ 2
- แบนเนอร์ L: โฆษณา Display ในสตรีมที่บีบเนื้อหาวิดีโอให้เล็กลงและสร้างโฆษณารอบๆ วิดีโอ โดยทั่วไปแล้ว หมายถึงกล่องเนื้อหาโฆษณารูปตัว L แต่ไม่ได้จำกัดเพียงรูปแบบนี้
- โฆษณาซ้อนทับ: โฆษณาในสตรีมรูปแบบใดก็ได้ที่ปรากฏบนเนื้อหาวิดีโอแต่ไม่กินพื้นที่เต็มหน้าจอ อาจเป็นโฆษณา Display หรือโฆษณาวิดีโอ
ตัวอย่างการใช้
รูปแบบที่รองรับและค่าที่เกี่ยวข้องมีดังนี้
หยุดชั่วคราว:
ott_placement=1
หน้าจอหลัก:
ott_placement=2
การแสดงภาพซ้อนภาพ:
ott_placement=3
แบนเนอร์รูปตัว L:
ott_placement=4
การวางซ้อน:
ott_placement=5
ที่กำหนดเอง/อื่นๆ:
ott_placement=99
ข้อกำหนดและคำแนะนำ
พารามิเตอร์นี้จำเป็นสำหรับการสร้างรายได้แบบเป็นโปรแกรมในเว็บ แอปบนอุปกรณ์เคลื่อนที่ และทีวีที่เชื่อมต่ออินเทอร์เน็ตเท่านั้นสำหรับผู้เผยแพร่โฆษณาที่สร้างรายได้จากตำแหน่งโฆษณาที่ไม่ใช่มาตรฐานในสภาพแวดล้อมสตรีมมิง OTT
plcmt (ตำแหน่งโฆษณา)
คำอธิบาย
พารามิเตอร์ตำแหน่งโฆษณา (plcmt) จะยอมรับค่าคงที่ที่ใช้เพื่อระบุว่ามีการประกาศพื้นที่โฆษณาในสตรีมเป็น "ในสตรีม" หรือ "ประกอบ" ตามคำแนะนำที่ระบุในข้อกำหนดของ IAB
สำหรับคำขอนอกสตรีม ระบบจะป้อนข้อมูลในช่องนี้ให้กับผู้ซื้อโดยอัตโนมัติตามรูปแบบพื้นที่โฆษณาที่ประกาศ ซึ่งจะลบล้างการประกาศในสตรีมหรือประกาศประกอบ
ตัวอย่างการใช้
คำขอในสตรีม:
plcmt=1
คำขอเนื้อหาประกอบ:
plcmt=2
ข้อกำหนดและคำแนะนำ
พารามิเตอร์นี้จำเป็นสำหรับการสร้างรายได้แบบเป็นโปรแกรมในเว็บ แอปบนอุปกรณ์เคลื่อนที่ ทีวีที่เชื่อมต่ออินเทอร์เน็ต เสียง และสื่อดิจิทัลนอกบ้าน
rdid (ตัวระบุอุปกรณ์ที่รีเซ็ตได้)
คำอธิบาย
พารามิเตอร์ตัวระบุอุปกรณ์ที่รีเซ็ตได้ (rdid, idtype, is_lat) ยอมรับค่าตัวแปร ค่านี้เรียกอีกอย่างว่าตัวระบุสำหรับการโฆษณา (IFA)
สำหรับแอปพลิเคชันบนอุปกรณ์เคลื่อนที่ที่ใช้ IMA SDK สำหรับ Android หรือ iOS นั้น IMA SDK จะส่งตัวระบุอุปกรณ์ที่รีเซ็ตได้สำหรับการกําหนดเป้าหมายผู้ใช้ไปยังคําขอสตรีมของคุณด้วยพารามิเตอร์สำหรับ rdid, idtype และ is_lat
เมื่อไม่ได้ใช้ IMA SDK หรือเมื่อใช้บีคอนฝั่งเซิร์ฟเวอร์ (SSB) คุณต้องส่งพารามิเตอร์เหล่านี้เป็นพารามิเตอร์ที่ชัดแจ้ง ดูข้อมูลเพิ่มเติมเกี่ยวกับตัวระบุอุปกรณ์
สำหรับโฆษณาวิดีโอแบบเป็นโปรแกรมเกือบทั้งหมด จำเป็นต้องมีค่าเหล่านี้
|
Apple เลิกใช้งานสัญญาณ |
ตัวอย่างการใช้
ดูตัวอย่างโดยละเอียดของตัวระบุอุปกรณ์ที่รีเซ็ตได้
ข้อกำหนดและคำแนะนำ
แม้ว่าจะไม่จำเป็นต้องใช้พารามิเตอร์เหล่านี้เพื่อแสดงโฆษณาสำหรับการติดตั้งใช้งานใดโดยเฉพาะ แต่ต้องใช้ในการสร้างรายได้แบบเป็นโปรแกรมในแอปบนมือถือ ทีวีที่เชื่อมต่ออินเทอร์เน็ต เสียง และสื่อดิจิทัลนอกบ้าน
สำหรับการติดตั้งใช้งานบนเว็บ ระบบจะไม่ใช้ตัวระบุอุปกรณ์ที่รีเซ็ตได้
การใช้งาน SDK
IMA SDK จะส่งฟิลด์นี้โดยอัตโนมัติ เว้นแต่จะตั้งค่า idType เป็น dpid ในกรณีนี้ ผู้เผยแพร่โฆษณาจะต้องส่งพารามิเตอร์ rdid ด้วยตนเอง
ผู้เผยแพร่โฆษณาจะต้องส่งพารามิเตอร์เหล่านี้ด้วยตนเองเมื่อใช้ PAL SDK
vpa (การเล่นวิดีโออัตโนมัติ)
คำอธิบาย
พารามิเตอร์เล่นวิดีโออัตโนมัติ vpa ยอมรับค่าคงที่ซึ่งระบุว่าเนื้อหาวิดีโอในโฆษณาจะเริ่มต้นผ่านการเล่นอัตโนมัติหรือการคลิก
หากต้องการให้หน้าเว็บรอการดำเนินการจากผู้ใช้ ให้ตั้งเป็น click หรือหากต้องการให้เริ่มเล่นโดยอัตโนมัติ ให้ตั้งเป็น auto พารามิเตอร์นี้จะไม่เปลี่ยนสถานะของวิดีโอเพลเยอร์ โดยวิดีโอเพลเยอร์ต้องจัดการลักษณะการเล่นโดยตรง
ตัวอย่างการใช้
เล่นอัตโนมัติ:
vpa=auto
คลิกเพื่อเล่น:
vpa=click
หากไม่ทราบ ให้ปล่อยพารามิเตอร์นี้ไว้โดยไม่ต้องตั้งค่า
ข้อกำหนดและคำแนะนำ
พารามิเตอร์นี้จำเป็นสำหรับการสร้างรายได้แบบเป็นโปรแกรมในเว็บ แอปบนอุปกรณ์เคลื่อนที่ ทีวีที่เชื่อมต่ออินเทอร์เน็ต และเสียง
นอกจากนี้ เรายังแนะนำให้ใช้พารามิเตอร์นี้ตามหลักเกณฑ์การวัดผลวิดีโอของ Media Rating Council (MRC) ด้วย
vpmute (การเล่นวิดีโอแบบปิดเสียง)
คำอธิบาย
พารามิเตอร์ปิดเสียงการเล่นวิดีโอ (vpmute) จะยอมรับค่าคงที่ซึ่งระบุว่าการเล่นโฆษณาจะเริ่มระหว่างที่วิดีโอเพลเยอร์ปิดเสียงอยู่หรือไม่ พารามิเตอร์นี้จะไม่เปลี่ยนสถานะของวิดีโอเพลเยอร์ โดยวิดีโอเพลเยอร์ต้องจัดการลักษณะการเล่นโดยตรง
ตัวอย่างการใช้
เริ่มเล่นโดยปิดเสียง:
vpmute=1
เริ่มเล่นโดยเปิดเสียง
vpmute=0
ข้อกำหนดและคำแนะนำ
พารามิเตอร์นี้จำเป็นสำหรับการสร้างรายได้แบบเป็นโปรแกรมในเว็บ แอปบนอุปกรณ์เคลื่อนที่ ทีวีที่เชื่อมต่ออินเทอร์เน็ต เสียง และสื่อนอกบ้านดิจิทัล
นอกจากนี้ เรายังแนะนำให้ใช้พารามิเตอร์นี้ตามหลักเกณฑ์การวัดผลวิดีโอของ Media Rating Council (MRC) ด้วย
พารามิเตอร์ที่แนะนำสำหรับรายการแบบเป็นโปรแกรม
aconp (การเล่นเสียงอย่างต่อเนื่อง)
คำอธิบาย
พารามิเตอร์เล่นเสียงต่อเนื่อง (aconp) จะยอมรับค่าคงที่ซึ่งระบุว่าวิดีโอเพลเยอร์จะเล่นเนื้อหาเสียงอย่างต่อเนื่องหรือไม่ ซึ่งจะช่วยให้ Google Ad Manager เลือกโฆษณาที่เหมาะสมที่สุดสำหรับประสบการณ์ของผู้ใช้
ตัวอย่างการใช้
ปิดการเล่นต่อเนื่อง:
aconp=2
ปิดการเล่นต่อเนื่อง:
aconp=1
หากไม่ทราบว่าเสียงเล่นอย่างต่อเนื่องหรือไม่ คุณควรปล่อยพารามิเตอร์นี้ไว้โดยไม่ตั้งค่าหรือตั้งค่าเป็น aconp=0
ข้อกำหนดและคำแนะนำ
แม้ว่าจะไม่จำเป็นต้องใช้พารามิเตอร์นี้เพื่อแสดงโฆษณาสำหรับการใช้งานที่เจาะจง แต่เราขอแนะนําให้ใช้สำหรับการสร้างรายได้แบบเป็นโปรแกรมในเว็บ แอปบนอุปกรณ์เคลื่อนที่ ทีวีที่เชื่อมต่ออินเทอร์เน็ต เสียง และสื่อดิจิทัลนอกบ้าน
เราขอแนะนําให้ใช้พารามิเตอร์นี้ตามหลักเกณฑ์การวัดผลเสียงของ Media Rating Council (MRC) ด้วย
an (ชื่อแอป)
คำอธิบาย
พารามิเตอร์รหัสแอป (msid) และพารามิเตอร์ชื่อแอป (an) จะยอมรับค่าตัวแปรซึ่งควรใช้กับคำขอที่ส่งจากแอปบนอุปกรณ์เคลื่อนที่และอุปกรณ์ทีวีที่เชื่อมต่ออินเทอร์เน็ต เนื่องจากโฆษณาวิดีโอแบบเป็นโปรแกรมส่วนใหญ่จำเป็นต้องใช้พารามิเตอร์ดังกล่าว
ชื่อแอปควรเป็นชื่อที่มนุษย์อ่านได้
ตัวอย่างการใช้
msid=com.package.publisher&an=sample%20app
ระบบจะตั้งชื่อและจัดรูปแบบรหัสแอป แตกต่างกันไปตาม App Store ต่างๆ ดูหลักเกณฑ์ของ IAB เกี่ยวกับการระบุแอป หรือตัวอย่างของตัวระบุที่ไม่ซ้ำกันทั่วไป
สำหรับแพลตฟอร์มที่ไม่มี App Store อยู่ IAB แนะนําให้ผู้เผยแพร่โฆษณาใช้รูปแบบต่อไปนี้สำหรับรหัสร้านค้า com.publisher.deviceplatform
ข้อกำหนดและคำแนะนำ
แม้ว่าจะไม่จำเป็นต้องใช้พารามิเตอร์นี้เพื่อแสดงโฆษณาสำหรับการใช้งานที่เจาะจง แต่เราขอแนะนําให้ใช้สำหรับการสร้างรายได้แบบเป็นโปรแกรมในแอปบนอุปกรณ์เคลื่อนที่ ทีวีที่เชื่อมต่ออินเทอร์เน็ต เสียง และสื่อดิจิทัลนอกบ้าน
เราขอแนะนำให้ระบุข้อมูลแอปด้วยเพื่อความปลอดภัยของแบรนด์และเพิ่มความโปร่งใสให้แก่ผู้ซื้อ
การใช้งาน SDK
ด้วยข้อยกเว้นของ iOS และ tvOS นั้น IMA SDK จะป้อนค่าพารามิเตอร์ทั้งคู่นี้ให้โดยอัตโนมัติ แต่คุณจะต้องระบุด้วยตนเองในสภาพแวดล้อมที่ไม่ใช่ SDK ซึ่งรวมถึงการเรียกใช้ VAST โดยตรง หรือเมื่อใช้ Programmatic Access Library (PAL) หรือ Publisher Authenticated Inventory (PAI)
ใน iOS และ tvOS นั้น IMA SDK หรือ PAL ไม่อาจเข้าถึงรหัสแอป ในกรณีเช่นนี้ จะไม่มีการส่งพารามิเตอร์ msid และ SDK จะส่ง App Bundle ผ่านพารามิเตอร์ an
หมายเหตุ: หากใช้ HTML5 IMA SDK ระบบจะไม่ใช้ข้อมูลแอป
ct_ch (ช่องเนื้อหา)
คำอธิบาย
พารามิเตอร์ช่องเนื้อหาจะยอมรับค่าตัวแปรที่เกี่ยวข้องกับช่องเนื้อหาที่จะแสดงโฆษณา ช่องหมายถึงเอนทิตีที่ดูแลจัดการคลังเนื้อหาหรือสตรีมภายในชื่อแบรนด์สำหรับผู้ชม
พารามิเตอร์นี้สามารถใช้เพื่อแสดงความโปร่งใสมากขึ้นแก่ผู้ซื้อซึ่งเป็นส่วนหนึ่งของสัญญาณการเขียนโปรแกรมวิดีโอภายในสัญญาณที่ได้จากผู้เผยแพร่โฆษณา
ดูคำจำกัดความของช่องเนื้อหาของ IAB
ct_ch=CNN International
ct_ch=ESPN2เราขอแนะนำให้ใช้พารามิเตอร์นี้สำหรับการสร้างรายได้แบบเป็นโปรแกรมในทีวีที่เชื่อมต่ออินเทอร์เน็ต
ct_ne (เครือข่ายเนื้อหา)
คำอธิบาย
พารามิเตอร์เครือข่ายเนื้อหาจะยอมรับค่าตัวแปรที่เกี่ยวข้องกับเครือข่ายของเนื้อหาที่จะแสดงโฆษณา เครือข่ายคือองค์กรกระจายเสียงที่เป็นเจ้าของหรือได้รับอนุญาตให้ใช้เนื้อหาจำนวนมาก และกระจายเนื้อหาดังกล่าวในพื้นที่กว้าง
พารามิเตอร์นี้สามารถใช้เพื่อแสดงความโปร่งใสมากขึ้นแก่ผู้ซื้อซึ่งเป็นส่วนหนึ่งของสัญญาณการเขียนโปรแกรมวิดีโอภายในสัญญาณที่ได้จากผู้เผยแพร่โฆษณา
ดูคำจำกัดความของเครือข่ายเนื้อหาของ IAB
ct_ne=WarnerMedia
ct_ne=ABCเราขอแนะนำให้ใช้พารามิเตอร์นี้สำหรับการสร้างรายได้แบบเป็นโปรแกรมในทีวีที่เชื่อมต่ออินเทอร์เน็ต
ct_se (ชุดเนื้อหา)
คำอธิบาย
พารามิเตอร์ซีรีส์เนื้อหาจะยอมรับค่าตัวแปรที่เกี่ยวข้องกับซีรีส์ของเนื้อหาที่จะแสดงโฆษณา
พารามิเตอร์นี้สามารถใช้เพื่อแสดงความโปร่งใสมากขึ้นแก่ผู้ซื้อซึ่งเป็นส่วนหนึ่งของสัญญาณการเขียนโปรแกรมวิดีโอภายในสัญญาณที่ได้จากผู้เผยแพร่โฆษณา
ct_se=game_of_thrones
ct_se=NBA_playoffsเราขอแนะนำให้ใช้พารามิเตอร์นี้สำหรับการสร้างรายได้แบบเป็นโปรแกรมในทีวีที่เชื่อมต่ออินเทอร์เน็ต
ct_ti (ชื่อเนื้อหา)
คำอธิบาย
พารามิเตอร์ชื่อเนื้อหาจะยอมรับค่าตัวแปรที่เกี่ยวข้องกับชื่อของเนื้อหาที่จะแสดงโฆษณา
พารามิเตอร์นี้สามารถใช้เพื่อแสดงความโปร่งใสมากขึ้นแก่ผู้ซื้อซึ่งเป็นส่วนหนึ่งของสัญญาณการเขียนโปรแกรมวิดีโอภายในสัญญาณที่ได้จากผู้เผยแพร่โฆษณา
ct_ti=game_of_thrones_s1e2
ct_ti=lakers_vs_celticsเราขอแนะนำให้ใช้พารามิเตอร์นี้สำหรับการสร้างรายได้แบบเป็นโปรแกรมในทีวีที่เชื่อมต่ออินเทอร์เน็ต
dth (คำแนะนำประเภทอุปกรณ์)
คำอธิบาย
พารามิเตอร์คำแนะนำประเภทอุปกรณ์ (dth) จะยอมรับค่าคงที่ซึ่งช่วยลดการแยกประเภทอุปกรณ์ที่ไม่ถูกต้อง โดยเฉพาะในสภาพแวดล้อมทีวีที่เชื่อมต่ออินเทอร์เน็ตและกล่องรับสัญญาณ
การจัดประเภทอุปกรณ์ที่ไม่ถูกต้องอาจเกิดจากข้อผิดพลาดที่ไม่คาดคิดจากผู้เผยแพร่โฆษณาหรือ OEM ของทีวีที่เชื่อมต่ออินเทอร์เน็ต ระบบจะใช้พารามิเตอร์นี้ร่วมกับสัญญาณอื่นๆ เพื่อให้ Google แจ้งอินสแตนซ์โดยอัตโนมัติที่อาจมีการจัดประเภทพื้นที่โฆษณาทีวีที่เชื่อมต่ออินเทอร์เน็ตใหม่
ตัวอย่างการใช้
คำขอจาก
- ฟีเจอร์โฟน:
dth=1 - สมาร์ทโฟน:
dth=2 - เดสก์ท็อป:
dth=3 - แท็บเล็ต:
dth=4 - ทีวีที่เชื่อมต่ออินเทอร์เน็ต:
dth=5 - คอนโซลเกม:
dth=6 - กล่องรับสัญญาณ:
dth=7
ข้อกำหนดและคำแนะนำ
แม้ว่าจะไม่จำเป็นต้องใช้พารามิเตอร์นี้เพื่อแสดงโฆษณาสำหรับการใช้งานที่เจาะจง แต่เราขอแนะนําให้ใช้สำหรับการสร้างรายได้แบบเป็นโปรแกรมในเว็บ แอปบนมือถือ สภาพแวดล้อมของทีวีที่เชื่อมต่ออินเทอร์เน็ตและกล่องรับสัญญาณ เสียง และสื่อดิจิทัลนอกบ้าน
givn (Nonce ของวิดีโอ)
คำอธิบาย
สำหรับการผสานรวมที่ใช้ไลบรารีการเข้าถึงแบบเป็นโปรแกรม (PAL) พารามิเตอร์ video nonce จะยอมรับค่าสตริงแบบตัวแปร
หมายเลขที่ไม่ซ้ำกันนี้ปลอดภัยสำหรับ URL คุณจึงไม่ต้องเข้ารหัส URL
หมายเหตุ: หากก่อนหน้านี้คุณระบุ Nonce โดยใช้พารามิเตอร์ paln รุ่นเดิม เราขอแนะนําอย่างยิ่งให้เปลี่ยนไปใช้พารามิเตอร์ givn และหยุดส่ง paln อย่าใส่ทั้ง 2 พารามิเตอร์
ตัวอย่างการใช้
อ่านข้อมูลเพิ่มเติมเกี่ยวกับค่าที่ส่งต่อไปยังพารามิเตอร์นี้ได้ในคู่มือการเริ่มต้นใช้งานสำหรับ PAL
ข้อกำหนดและคำแนะนำ
แม้ว่าจะไม่จำเป็นต้องใช้พารามิเตอร์นี้เพื่อแสดงโฆษณาสำหรับการใช้งานที่เจาะจง แต่เราขอแนะนําให้ใช้สำหรับการสร้างรายได้แบบเป็นโปรแกรมในเว็บ แอปบนอุปกรณ์เคลื่อนที่ ทีวีที่เชื่อมต่ออินเทอร์เน็ต เสียง และสื่อดิจิทัลนอกบ้าน
hl (ภาษา)
คำอธิบาย
พารามิเตอร์ภาษา (hl) จะยอมรับค่าคงที่ซึ่งใช้สำหรับการขอโฆษณาในภาษานั้นหรือใช้สำหรับภาษาในการเลือกโฆษณาและการแสดงโฆษณาวิดีโอในการจัดสรรแบบไดนามิกให้กับวิดีโอ Ad Exchange หรือ AdSense
ตัวอย่างการใช้
ส่งคำขอโฆษณาเป็นภาษาอิตาลี
hl=it
ค่าพารามิเตอร์จะเป็นค่าใดก็ได้ที่ใช้รหัส ISO 639-1 (2 ตัวอักษร) หรือ ISO 639-2 (3 ตัวอักษร) ดูรายการรหัสที่ใช้ได้
หากไม่ใส่พารามิเตอร์นี้ ค่าเริ่มต้นจะเป็นภาษาใดก็ตามที่มีการกำหนดเป้าหมายโฆษณาตามภาษาใน Ad Exchange
ข้อกำหนดและคำแนะนำ
แม้ว่าจะไม่จำเป็นต้องใช้พารามิเตอร์นี้เพื่อแสดงโฆษณาสำหรับการใช้งานที่เจาะจง แต่เราขอแนะนําให้ใช้สำหรับการสร้างรายได้แบบเป็นโปรแกรมในเว็บ แอปบนอุปกรณ์เคลื่อนที่ ทีวีที่เชื่อมต่ออินเทอร์เน็ต เสียง และสื่อดิจิทัลนอกบ้าน
msid (รหัสแอป)
คำอธิบาย
พารามิเตอร์รหัสแอป (msid) และพารามิเตอร์ชื่อแอป (an) จะยอมรับค่าตัวแปรซึ่งควรใช้กับคำขอที่ส่งจากแอปบนอุปกรณ์เคลื่อนที่และอุปกรณ์ทีวีที่เชื่อมต่ออินเทอร์เน็ต เนื่องจากโฆษณาวิดีโอแบบเป็นโปรแกรมส่วนใหญ่จำเป็นต้องใช้พารามิเตอร์ดังกล่าว
ชื่อแอปควรเป็นชื่อที่มนุษย์อ่านได้
ตัวอย่างการใช้
msid=com.package.publisher&an=sample%20app
ระบบจะตั้งชื่อและจัดรูปแบบรหัสแอป แตกต่างกันไปตาม App Store ต่างๆ ดูหลักเกณฑ์ของ IAB เกี่ยวกับการระบุแอป หรือตัวอย่างของตัวระบุที่ไม่ซ้ำกันทั่วไป
สำหรับแพลตฟอร์มที่ไม่มี App Store อยู่ IAB แนะนําให้ผู้เผยแพร่โฆษณาใช้รูปแบบต่อไปนี้สำหรับรหัสร้านค้า com.publisher.deviceplatform
ข้อกำหนดและคำแนะนำ
แม้ว่าจะไม่จำเป็นต้องใช้พารามิเตอร์นี้เพื่อแสดงโฆษณาสำหรับการใช้งานที่เจาะจง แต่เราขอแนะนําให้ใช้สำหรับการสร้างรายได้แบบเป็นโปรแกรมในแอปบนอุปกรณ์เคลื่อนที่ ทีวีที่เชื่อมต่ออินเทอร์เน็ต เสียง และสื่อดิจิทัลนอกบ้าน
เราขอแนะนำให้ระบุข้อมูลแอปด้วยเพื่อความปลอดภัยของแบรนด์และเพิ่มความโปร่งใสให้แก่ผู้ซื้อ
การใช้งาน SDK
ด้วยข้อยกเว้นของ iOS และ tvOS นั้น IMA SDK จะป้อนค่าพารามิเตอร์ทั้งคู่นี้ให้โดยอัตโนมัติ แต่คุณจะต้องระบุด้วยตนเองในสภาพแวดล้อมที่ไม่ใช่ SDK ซึ่งรวมถึงการเรียกใช้ VAST โดยตรง หรือเมื่อใช้ Programmatic Access Library (PAL) หรือ Publisher Authenticated Inventory (PAI)
ใน iOS และ tvOS นั้น IMA SDK หรือ PAL ไม่อาจเข้าถึงรหัสแอป ในกรณีเช่นนี้ จะไม่มีการส่งพารามิเตอร์ msid และ SDK จะส่ง App Bundle ผ่านพารามิเตอร์ an
หมายเหตุ: หากใช้ HTML5 IMA SDK ระบบจะไม่ใช้ข้อมูลแอป
omid_p (ชื่อพาร์ทเนอร์ OMID)
คำอธิบาย
พารามิเตอร์ชื่อพาร์ทเนอร์ OMID (omid_p) จะยอมรับค่าตัวแปรที่ระบุชื่อของพาร์ทเนอร์ที่รวมการวัด OMID และเวอร์ชันของพาร์ทเนอร์
พารามิเตอร์ SDK API ที่รองรับ (sdk_apis) จะยอมรับค่าตัวแปร ซึ่งอาจเป็น API ที่รองรับรายการเดียวหรือรายการที่คั่นด้วยคอมมาก็ได้
พารามิเตอร์เหล่านี้เป็นส่วนหนึ่งของชุดพารามิเตอร์ที่ใช้สำหรับการมองเห็นโฆษณาและการยืนยันโฆษณา
ตัวอย่างการใช้
เมื่อไม่ได้ใช้ PAL:
omid_p=examplepartnername/1.0.0.0&sdk_apis=7
ดูรายการค่าเฟรมเวิร์ก API ที่เป็นไปได้
เมื่อใช้ PAL:
request.omidPartnerName = 'examplepartnername'
request.omidPartnerVersion = '1.0.0.0'
ข้อกำหนดและคำแนะนำ
แม้ว่าจะไม่จำเป็นต้องใช้พารามิเตอร์นี้เพื่อแสดงโฆษณาสำหรับการใช้งานที่เจาะจง แต่เราขอแนะนําให้ใช้สำหรับการสร้างรายได้แบบเป็นโปรแกรมในเว็บ แอปบนอุปกรณ์เคลื่อนที่ ทีวีที่เชื่อมต่ออินเทอร์เน็ต เสียง และสื่อดิจิทัลนอกบ้าน
การใช้งาน SDK
- พารามิเตอร์นี้ใช้ได้กับผู้เผยแพร่โฆษณาที่ต้องการการวัดมุมมองแอ็กทีฟเมื่อใช้ Open Measurement SDK (OM SDK) เท่านั้น
- หากต้องการระบุการรองรับ OMID เมื่อใช้ไลบรารีการเข้าถึงแบบเป็นโปรแกรม (PAL) คุณต้องใช้
omidPartnerNameและomidPartnerVersionเพื่อตั้งค่าชื่อและเวอร์ชันของพาร์ทเนอร์ หากไม่ได้ใช้ PAL หรือ IMA SDK คุณต้องตั้งค่าพารามิเตอร์omid_pและsdk_apis - ซึ่งไม่ควรใช้พารามิเตอร์นี้หากใช้ IMA SDK เพราะตั้งค่าไว้โดยอัตโนมัติ
pvid (รหัสชุดแอป)
คำอธิบาย
พารามิเตอร์รหัสชุดแอป (pvid) จะยอมรับค่าตัวแปรซึ่งตั้งค่าเป็นรหัสชุดแอป Android และพารามิเตอร์ขอบเขตชุดแอป (pvid_s) จะยอมรับค่าคงที่ซึ่งแสดงถึงขอบเขตของรหัสชุดแอป (scope_app หรือ scope_developer)
ดูเอกสารประกอบของ Android เกี่ยวกับวิธีการเรียกรหัสชุดแอป
ตัวอย่างการใช้
pvid=[AppSetID_value]
pvid_s=scope_app
ข้อกำหนดและคำแนะนำ
แม้ว่าพารามิเตอร์นี้ไม่จำเป็นต่อการแสดงโฆษณาสำหรับการติดตั้งใช้งานที่เฉพาะเจาะจง แต่เราขอแนะนําสำหรับการสร้างรายได้แบบเป็นโปรแกรมในแอปบนอุปกรณ์เคลื่อนที่ในอุปกรณ์ Android ซึ่งรวมถึง CTV (Android TV) ที่อิงตามแอป
การใช้งาน SDK
ขณะที่ IMA/PAL SDK ส่งช่องนี้โดยอัตโนมัติ ผู้เผยแพร่โฆษณาที่ไม่ได้ใช้ SDK จะต้องเรียกใช้ SDK ของชุดแอปและส่งพารามิเตอร์เหล่านี้ไปยังคำขอโฆษณาด้วยตนเอง
pvid_s (ขอบเขตชุดแอป)
คำอธิบาย
พารามิเตอร์รหัสชุดแอป (pvid) จะยอมรับค่าตัวแปรซึ่งตั้งค่าเป็นรหัสชุดแอป Android และพารามิเตอร์ขอบเขตชุดแอป (pvid_s) จะยอมรับค่าคงที่ซึ่งแสดงถึงขอบเขตของรหัสชุดแอป (scope_app หรือ scope_developer)
ดูเอกสารประกอบของ Android เกี่ยวกับวิธีการเรียกรหัสชุดแอป
ตัวอย่างการใช้
pvid=[AppSetID_value]
pvid_s=scope_app
ข้อกำหนดและคำแนะนำ
แม้ว่าพารามิเตอร์นี้ไม่จำเป็นต่อการแสดงโฆษณาสำหรับการติดตั้งใช้งานที่เฉพาะเจาะจง แต่เราขอแนะนําสำหรับการสร้างรายได้แบบเป็นโปรแกรมในแอปบนอุปกรณ์เคลื่อนที่ในอุปกรณ์ Android ซึ่งรวมถึง CTV (Android TV) ที่อิงตามแอป
การใช้งาน SDK
ขณะที่ IMA/PAL SDK ส่งช่องนี้โดยอัตโนมัติ ผู้เผยแพร่โฆษณาที่ไม่ได้ใช้ SDK จะต้องเรียกใช้ SDK ของชุดแอปและส่งพารามิเตอร์เหล่านี้ไปยังคำขอโฆษณาด้วยตนเอง
sid (รหัสเซสชัน)
คำอธิบาย
พารามิเตอร์รหัสเซสซัน (sid) ยอมรับค่าตัวแปรซึ่งเป็นตัวระบุโฆษณาที่รักษาความเป็นส่วนตัว โดยจะใช้ได้เพื่อจุดประสงค์ในการกำหนดความถี่สูงสุดเท่านั้น
รหัสเซสชันใช้ได้กับคําขอโฆษณาวิดีโอในสตรีมจากทีวีที่เชื่อมต่ออินเทอร์เน็ตและพื้นที่โฆษณาวิดีโอในสตรีมจากแอปบนอุปกรณ์เคลื่อนที่ ปัจจุบันยังไม่รองรับการใช้งานบนเว็บ
คุณเลือกไม่ใช้การส่งรหัสเซสชันได้โดยการตั้งค่า sid=0
ตัวอย่างการใช้
sid=123e4567-e89b-12d3-a456-426614174000
พารามิเตอร์นี้ต้องระบุในรูปแบบ UUID ดูข้อมูลเพิ่มเติมเกี่ยวกับตัวระบุอุปกรณ์ที่รีเซ็ตได้เพื่อการกำหนดเป้าหมายผู้ใช้
ข้อกำหนดและคำแนะนำ
แม้ว่าจะไม่จำเป็นต้องใช้พารามิเตอร์นี้เพื่อแสดงโฆษณาสำหรับการติดตั้งใช้งานใดโดยเฉพาะ แต่ต้องใช้สำหรับการสร้างรายได้แบบเป็นโปรแกรมในสื่อดิจิทัลนอกบ้าน
เราขอแนะนำให้ใช้พารามิเตอร์นี้สำหรับการสร้างรายได้แบบเป็นโปรแกรมในแอปบนอุปกรณ์เคลื่อนที่ ทีวีที่เชื่อมต่ออินเทอร์เน็ต และเสียง
การใช้งาน SDK
IMA SDK จะส่งพารามิเตอร์นี้โดยอัตโนมัติ
vconp (การเล่นวิดีโอแบบต่อเนื่อง)
คำอธิบาย
พารามิเตอร์เล่นวิดีโอต่อเนื่อง (vconp) ยอมรับค่าคงที่ซึ่งระบุว่าวิดีโอเพลเยอร์จะเล่นเนื้อหาวิดีโออย่างต่อเนื่องคล้ายกับการออกอากาศทางทีวีหรือไม่
ตัวอย่างการใช้
เปิดการเล่นต่อเนื่อง:
vconp=2
ปิดการเล่นต่อเนื่อง:
vconp=1
หากไม่ทราบ ให้ปล่อยพารามิเตอร์นี้ไว้โดยไม่ต้องตั้งค่า
ข้อกำหนดและคำแนะนำ
แม้ว่าจะไม่จำเป็นต้องใช้พารามิเตอร์นี้เพื่อแสดงโฆษณาสำหรับการติดตั้งใช้งานใดโดยเฉพาะ แต่ขอแนะนำให้ใช้สำหรับการสร้างรายได้แบบเป็นโปรแกรมในเว็บ แอปบนอุปกรณ์เคลื่อนที่ ทีวีที่เชื่อมต่ออินเทอร์เน็ต และเสียง
นอกจากนี้ เรายังแนะนำให้ใช้พารามิเตอร์นี้ตามหลักเกณฑ์การวัดผลวิดีโอของ Media Rating Council (MRC) ด้วย
vid_d (ระยะเวลาของวิดีโอ)
คำอธิบาย
พารามิเตอร์ระยะเวลาของวิดีโอ (vid_d) ยอมรับค่าตัวแปรซึ่งระบุระยะเวลาของเนื้อหาในหน่วยวินาที
- พารามิเตอร์
vid_dและallcuesใช้เพื่อแสดงโฆษณาตอนกลางโดยไม่ต้องนำเข้าเนื้อหา - คุณต้องใช้กฎโฆษณาจึงจะแสดงโฆษณาตอนกลางได้ หากมีการใช้จุดเวลาในกฎโฆษณา (เช่น "ทุก N วินาที" หรือ "ตามเวลาที่กำหนด") ระบบจะใช้จุดเวลาที่ตั้งค่าไว้ในกฎโฆษณาและละเว้นจุดเวลาที่ส่งเข้าไปใน
allcuesโฆษณาตอนกลางยังคงต้องมีระยะเวลา จึงต้องมีการส่งvid_dอยู่
ตัวอย่างการใช้
เนื้อหาวิดีโอมีระยะเวลา 90,000 วินาที (25 ชั่วโมง):
vid_d=90000
ข้อกำหนดและคำแนะนำ
แม้ว่าจะไม่จำเป็นต้องใช้พารามิเตอร์นี้เพื่อแสดงโฆษณาสำหรับการติดตั้งใช้งานใดโดยเฉพาะ แต่เราขอแนะนำให้ใช้สำหรับการสร้างรายได้แบบเป็นโปรแกรมในเว็บ แอปบนอุปกรณ์เคลื่อนที่ และทีวีที่เชื่อมต่ออินเทอร์เน็ต
vpos (ตำแหน่งวิดีโอ)
คำอธิบาย
พารามิเตอร์ตำแหน่งวิดีโอ (vpos) ยอมรับค่าคงที่ซึ่งระบุว่าคำขอโฆษณานั้นส่งจากโฆษณาตอนต้น โฆษณาตอนกลาง หรือโฆษณาตอนท้าย
ตัวอย่างการใช้
โฆษณาตอนต้น:
vpos=preroll
โฆษณาตอนกลาง:
vpos=midroll
โฆษณาตอนท้าย:
vpos=postroll
ข้อกำหนดและคำแนะนำ
แม้ว่าจะไม่จำเป็นต้องใช้พารามิเตอร์นี้เพื่อแสดงโฆษณาสำหรับการติดตั้งใช้งานใดโดยเฉพาะ แต่ขอแนะนำให้ใช้สำหรับการสร้างรายได้แบบเป็นโปรแกรมในเว็บ แอปบนอุปกรณ์เคลื่อนที่ ทีวีที่เชื่อมต่ออินเทอร์เน็ต และเสียง
หากใช้กฎโฆษณา ก็ไม่จำเป็นต้องใช้พารามิเตอร์นี้ เนื่องจากเซิร์ฟเวอร์โฆษณาจะเพิ่มให้โดยอัตโนมัติ
wta (ทำไมจึงแสดงโฆษณานี้)
คำอธิบาย
พารามิเตอร์ "ทำไมจึงแสดงโฆษณานี้" (wta) ยอมรับค่าคงที่ซึ่งบอกถึงการรองรับของวิดีโอเพลเยอร์สำหรับการแสดงผลการติดป้ายระบุว่าเป็นโฆษณา
ตัวอย่างการใช้
หากต้องการให้เพลเยอร์แสดงผลไอคอนตัวเลือกโฆษณาอื่นๆ ที่ระบุไว้ในการตอบกลับด้วย VAST ให้ใช้
wta=1(หรือละเว้นพารามิเตอร์wtaหรือส่งwtaโดยไม่ได้ตั้งค่า)คำขอเสียงควรใช้
wta=1หากไอคอนตัวเลือกโฆษณาอื่นๆ ที่ระบุไว้ในการตอบกลับด้วย VAST จะแสดงบนโฆษณาที่แสดงร่วมหรือแสดงต่อผู้ใช้
หากเพลเยอร์ไม่ควรแสดงผลไอคอนตัวเลือกโฆษณาอื่นๆ ที่ระบุไว้ในการตอบกลับด้วย VAST ให้ใช้
wta=0
ข้อกำหนดและคำแนะนำ
แม้ว่าจะไม่จําเป็นต้องใช้พารามิเตอร์นี้เพื่อแสดงโฆษณาสำหรับการติดตั้งใช้งานประเภทใดโดยเฉพาะ ขอแนะนําให้ใช้กับการสร้างรายได้แบบเป็นโปรแกรมสำหรับเว็บ แอปบนอุปกรณ์เคลื่อนที่ ทีวีที่เชื่อมต่ออินเทอร์เน็ต และเสียง
กรณีที่ใช้พารามิเตอร์
- การเข้าชม
&wta=0ไม่มีสิทธิ์ใช้การปรับเปลี่ยนให้เหมาะสมกับผู้ใช้บางประเภทจากดีมานด์จาก Google - การเข้าชม
&wta=0จาก EEA ไม่มีสิทธิ์แสดงครีเอทีฟโฆษณาที่เปิดใช้การติดป้ายระบุว่าเป็นโฆษณาในรายการโฆษณาแบบจองและรายการโฆษณาที่รับประกันแบบเป็นโปรแกรมซึ่งผู้เผยแพร่โฆษณาจัดการ
โฆษณาของคุณจะต้องเป็นไปตามข้อบังคับที่เกี่ยวข้องสำหรับโฆษณาที่แสดงในเขตเศรษฐกิจยุโรป (EEA) ซึ่งรวมถึงกลไกสำหรับผู้ใช้ในการรายงานเนื้อหาผิดกฎหมาย ผู้เผยแพร่โฆษณาต้องแจ้งรายงานเนื้อหาผิดกฎหมายให้ Google ทราบโดยใช้แบบฟอร์มรายงานเนื้อหาใน Google
การใช้งาน SDK
ระบบจะรองรับฟังก์ชันการติดป้ายระบุว่าเป็นโฆษณาโดยอัตโนมัติเมื่อใช้ IMA SDK หากไม่ได้ใช้ IMA SDK วิดีโอเพลเยอร์ต้องพัฒนาการรองรับIcon และ IconClickFallbackImage ของ VAST ตามที่ระบุไว้ในมาตรฐาน VAST ของ IAB