การใช้งานโซลูชันวิดีโอแบบอิงตามแท็กกับความต้องการใน Ad Exchange โดยไม่ใช้ IMA SDK นั้นเป็นการให้บริการแบบเบต้าและอาจใช้ไม่ได้กับเครือข่ายของคุณ ติดต่อขอข้อมูลเพิ่มเติมได้จากผู้จัดการฝ่ายดูแลลูกค้า
บทความนี้แสดงรายการพารามิเตอร์ที่จำเป็นและแนะนำสำหรับแท็กโฆษณา VAST ที่ใช้แสดงโฆษณาในการใช้งานบนเว็บ
ในหน้านี้
- พารามิเตอร์ที่จำเป็นสำหรับการแสดงโฆษณา
- พารามิเตอร์ที่จำเป็นสำหรับรายการแบบเป็นโปรแกรม
- พารามิเตอร์ที่แนะนำสำหรับรายการแบบเป็นโปรแกรม
คุณสามารถดูรายการสำหรับประเภทการติดตั้งใช้งานอื่นๆ หรือข้อกำหนด URL สำหรับแท็กโฆษณา VAST
พารามิเตอร์ที่จำเป็นและแนะนำสำหรับเว็บ
พารามิเตอร์ที่จำเป็นสำหรับการแสดงโฆษณา
correlator (สหสัมพันธ์)
คำอธิบาย
พารามิเตอร์สหสัมพันธ์ (correlator) จะยอมรับค่าตัวแปรซึ่งใช้ร่วมกันระหว่างคำขอหลายรายการที่มาจากการดูหน้าเว็บครั้งเดียวกัน พารามิเตอร์นี้ใช้เพื่อยกเว้นโฆษณาของคู่แข่ง ซึ่งรวมถึงในสภาพแวดล้อมที่ไม่มีคุกกี้
ตัวอย่างการใช้
correlator=4345645667
ข้อกำหนดและคำแนะนำ
พารามิเตอร์นี้จำเป็นสำหรับการใช้การแสดงโฆษณาในเว็บ แอปบนอุปกรณ์เคลื่อนที่ ทีวีที่เชื่อมต่ออินเทอร์เน็ต เสียง และสื่อดิจิทัลนอกบ้าน
การใช้งาน SDK
- ถ้ามีการใช้ IMA SDK ก็จะมีการตั้งค่าสหสัมพันธ์โดยอัตโนมัติ หากโปรแกรมเล่นพยายามตั้งค่านี้ SDK จะเขียนทับค่านี้ด้วยค่าของตัวเอง
- หากไม่ได้ใช้ IMA SDK ให้ตรวจสอบว่าคุณตั้งค่านี้เป็นจำนวนบวกแบบสุ่มที่แท้จริง ซึ่งไม่ถูกใช้ซ้ำโดยการดูหน้าเว็บหลายๆ ครั้ง
description_url (URL คำอธิบาย)
คำอธิบาย
พารามิเตอร์ URL คำอธิบาย (description_url) จะยอมรับค่าตัวแปร ซึ่งควรอธิบายวิดีโอที่กำลังเล่นอยู่ในหน้าเว็บ
URL คำอธิบายควรเกี่ยวข้องกับวิดีโอที่เล่นอยู่ในหน้าใดหน้าหนึ่งของเว็บแอป แอปบนอุปกรณ์เคลื่อนที่ หรือแอปทีวี และไม่ควรเป็นโดเมนระดับบนสุดสำหรับวิดีโอทั้งหมดหรือคำขอโฆษณาทั้งหมด ตัวอย่างเช่น หากคุณมีหน้า https://sample.com/golf.html สำหรับแสดงวิดีโอเกี่ยวกับกอล์ฟ ให้ตั้งค่าเป็นค่าของ description_url
ตัวอย่างการใช้
ค่า description_url ต้องเป็น URL ที่เข้ารหัสสำหรับหน้าเว็บที่มีวิดีโอและอุปกรณ์ CTV/OTT อย่างไรก็ตาม ค่า description_url ต้องไม่เข้ารหัสสำหรับแอปบนอุปกรณ์เคลื่อนที่
URL ที่เข้ารหัส:
description_url=
https%3A%2F%2Fsample.com%2Fgolf.html
URL ที่ไม่เข้ารหัส:
description_url=
https://sample.com/golf.html
ข้อกำหนดและคำแนะนำ
พารามิเตอร์นี้จำเป็นสำหรับการใช้การแสดงโฆษณาในเว็บและแอปบนอุปกรณ์เคลื่อนที่ นอกจากนี้ คุณยังต้องใช้ไฟล์นี้หากใช้ Ad Exchange หรือ AdSense สำหรับการจัดสรรแบบไดนามิก
เราขอแนะนำให้ใช้พารามิเตอร์นี้สำหรับการสร้างรายได้แบบเป็นโปรแกรม
การใช้งาน SDK
IMA 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 ทุกเวอร์ชันที่เซิร์ฟเวอร์โฆษณาบุคคลที่สามอาจจะแสดง
sz (ขนาด)
คำอธิบาย
พารามิเตอร์ขนาด (sz) ยอมรับค่าตัวแปร ซึ่งควรตั้งค่าเป็นขนาดของช่องโฆษณาวิดีโอหลัก
หากมีหลายขนาด ควรคั่นด้วยเครื่องหมายไปป์ (|)
อย่าใส่ "v" หลังขนาด
ตัวอย่างการใช้
ขนาดเดียว:sz=400x300
หลายขนาด:sz=300x250|400x300
ข้อกำหนดและคำแนะนำ
พารามิเตอร์นี้จำเป็นสำหรับการใช้การแสดงโฆษณาในเว็บ แอปบนอุปกรณ์เคลื่อนที่ ทีวีที่เชื่อมต่ออินเทอร์เน็ต และสื่อดิจิทัลนอกบ้าน
ไม่บังคับให้ใช้พารามิเตอร์นี้ถ้าขอเพียง ad_type=audio
unviewed_position_start (การแสดงผลที่ล่าช้า)
คำอธิบาย
พารามิเตอร์การแสดงผลที่ล่าช้า (unviewed_position_start) ยอมรับค่าคงที่เพื่อระบุการแสดงผลที่ล่าช้าของวิดีโอ
ตัวอย่างการใช้
unviewed_position_start=1
ข้อกำหนดและคำแนะนำ
พารามิเตอร์นี้จำเป็นสำหรับการใช้การแสดงโฆษณาในเว็บและแอปบนอุปกรณ์เคลื่อนที่เมื่อมีโอกาสในการแสดงผลที่ล่าช้า
url (URL)
คำอธิบาย
พารามิเตอร์ของ URL (url) ยอมรับค่าตัวแปรซึ่งควรตั้งค่าเป็น URL แบบเต็มที่มีการส่งคำขอ โดยค่านี้จะช่วยให้ผู้ซื้อระบุและเข้าใจรายละเอียดแหล่งที่มาของคำขอ ระบบควรป้อนค่านี้ในคำขอโฆษณาเท่าที่ทำได้โดยอัตโนมัติ
- สำหรับเว็บ นี่คือ URL ของหน้าที่แสดงวิดีโอเพลเยอร์
- ในสภาพแวดล้อมที่ไม่ใช่เว็บ ค่านี้ควรตั้งเป็น URL ที่นำเสนอได้อย่างถูกต้องที่สุดถึงพื้นที่โฆษณาวิดีโอหรือเสียงที่ใช้สร้างรายได้ เช่น หากผู้ใช้ดูวิดีโอในแอปบนอุปกรณ์เคลื่อนที่ ซึ่งก็สามารถดูบนคอมพิวเตอร์เดสก์ท็อปได้ด้วยโดยใช้ URL ที่เทียบเท่า*
หมายเหตุ: url แตกต่างจาก description_url ตรงที่ url หมายถึงตำแหน่งที่ส่งคำขอโฆษณา ส่วน description_url คือหน้าเว็บที่ทำการ Crawl ได้ซึ่งอธิบายเนื้อหาวิดีโอ
ค่าของพารามิเตอร์นี้ควรเข้ารหัสไว้
ตัวอย่างการใช้
url=https%3A%2F%2Fexample.com%2Fvideo.html
* สำหรับแอป หากไม่สามารถตั้งพารามิเตอร์นี้เป็นค่า URL ตัวแปร ขอแนะนำให้ใช้รูปแบบต่อไปนี้ url=https%3A%2F%2F<app/bundleid>.example.com
ข้อกำหนดและคำแนะนำ
พารามิเตอร์นี้จำเป็นเฉพาะสำหรับการสร้างรายได้แบบเป็นโปรแกรมในเว็บ แอปบนอุปกรณ์เคลื่อนที่ ทีวีที่เชื่อมต่ออินเทอร์เน็ต เสียง และสื่อดิจิทัลนอกบ้าน
การใช้งาน SDK
หากคุณใช้ IMA SDK ระบบจะตั้งค่าของ URL โดยอัตโนมัติ หากเพลเยอร์ตั้งค่านี้ไว้ IMA SDK จะยึดตามค่าดังกล่าว
พารามิเตอร์ที่จำเป็นสำหรับรายการแบบเป็นโปรแกรม
ott_placement (ตำแหน่งโฆษณา OTT)
คำอธิบาย
พารามิเตอร์ตำแหน่งโฆษณา OTT (ott_placement) จะยอมรับค่าคงที่ซึ่งระบุคำขอตำแหน่งโฆษณา OTT นอกสตรีม
คำจำกัดความของตำแหน่งโฆษณาสำหรับตัวอย่างด้านล่าง
- หยุดชั่วคราว: รูปแบบนอกสตรีมที่ปรากฏผ่านการวางซ้อนบนเนื้อหาวิดีโอเมื่อผู้ใช้หยุดเล่นเนื้อหาชั่วคราว
- หน้าจอหลัก: โฆษณาที่ปรากฏบนหน้าจอหลักของอุปกรณ์ 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
ข้อกำหนดและคำแนะนำ
พารามิเตอร์นี้จำเป็นสำหรับการสร้างรายได้แบบเป็นโปรแกรมในเว็บ แอปบนอุปกรณ์เคลื่อนที่ ทีวีที่เชื่อมต่ออินเทอร์เน็ต เสียง และสื่อดิจิทัลนอกบ้าน
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) ด้วย
dth (คำแนะนำประเภทอุปกรณ์)
คำอธิบาย
พารามิเตอร์คำแนะนำประเภทอุปกรณ์ (dth) จะยอมรับค่าคงที่ซึ่งช่วยลดการแยกประเภทอุปกรณ์ที่ไม่ถูกต้อง โดยเฉพาะในสภาพแวดล้อมทีวีที่เชื่อมต่ออินเทอร์เน็ตและกล่องรับสัญญาณ
การจัดประเภทอุปกรณ์ที่ไม่ถูกต้องอาจเกิดจากข้อผิดพลาดที่ไม่คาดคิดจากผู้เผยแพร่โฆษณาหรือ OEM ของทีวีที่เชื่อมต่ออินเทอร์เน็ต ระบบจะใช้พารามิเตอร์นี้ร่วมกับสัญญาณอื่นๆ เพื่อให้ Google แจ้งอินสแตนซ์โดยอัตโนมัติที่อาจมีการจัดประเภทพื้นที่โฆษณาทีวีที่เชื่อมต่ออินเทอร์เน็ตใหม่
ตัวอย่างการใช้
คำขอจาก
- ฟีเจอร์โฟน:
dth=1 - สมาร์ทโฟน:
dth=2 - เดสก์ท็อป:
dth=3 - แท็บเล็ต:
dth=4 - ทีวีที่เชื่อมต่ออินเทอร์เน็ต:
dth=5 - คอนโซลเกม:
dth=6 - กล่องรับสัญญาณ:
dth=7
ข้อกำหนดและคำแนะนำ
แม้ว่าจะไม่จำเป็นต้องใช้พารามิเตอร์นี้เพื่อแสดงโฆษณาสำหรับการใช้งานที่เจาะจง แต่เราขอแนะนําให้ใช้สำหรับการสร้างรายได้แบบเป็นโปรแกรมในเว็บ แอปบนอุปกรณ์เคลื่อนที่ ทีวีที่เชื่อมต่ออินเทอร์เน็ต เสียง และสื่อดิจิทัลนอกบ้าน
การใช้งาน SDK
เราขอแนะนำให้ใช้พารามิเตอร์นี้สำหรับการใช้งาน PAL และ PAI (ที่ไม่ใช่ SDK) แต่ไม่จำเป็นต้องใช้สำหรับ IMA SDK หรือ DAI SDK
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
ข้อกำหนดและคำแนะนำ
แม้ว่าจะไม่จำเป็นต้องใช้พารามิเตอร์นี้เพื่อแสดงโฆษณาสำหรับการใช้งานที่เจาะจง แต่เราขอแนะนําให้ใช้สำหรับการสร้างรายได้แบบเป็นโปรแกรมในเว็บ แอปบนอุปกรณ์เคลื่อนที่ ทีวีที่เชื่อมต่ออินเทอร์เน็ต เสียง และสื่อดิจิทัลนอกบ้าน
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 เพราะตั้งค่าไว้โดยอัตโนมัติ
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