พารามิเตอร์แท็กโฆษณา VAST สําหรับเว็บ

การใช้งานโซลูชันวิดีโอแบบอิงตามแท็กกับความต้องการใน Ad Exchange โดยไม่ใช้ IMA SDK นั้นเป็นการให้บริการแบบเบต้าและอาจใช้ไม่ได้กับเครือข่ายของคุณ ติดต่อขอข้อมูลเพิ่มเติมได้จากผู้จัดการฝ่ายดูแลลูกค้า

บทความนี้แสดงรายการพารามิเตอร์ที่จำเป็นและแนะนำสำหรับแท็กโฆษณา VAST ที่ใช้แสดงโฆษณาในการใช้งานบนเว็บ

ในหน้านี้

• พารามิเตอร์ที่จำเป็นสำหรับการแสดงโฆษณา
• พารามิเตอร์ที่จำเป็นสำหรับรายการแบบเป็นโปรแกรม
• พารามิเตอร์ที่แนะนำสำหรับรายการแบบเป็นโปรแกรม

หมายเหตุ: พารามิเตอร์ในหน้านี้เป็นชุดย่อยของรายการพารามิเตอร์แท็กโฆษณา VAST ที่สมบูรณ์ ซึ่งบางรายการอาจจำเป็นสำหรับฟีเจอร์บางอย่างด้วย

คุณสามารถดูรายการสำหรับประเภทการติดตั้งใช้งานอื่นๆ หรือข้อกำหนด URL สำหรับแท็กโฆษณา VAST

พารามิเตอร์ที่จำเป็นและแนะนำสำหรับเว็บ

ขยายทั้งหมด ยุบทั้งหมด

พารามิเตอร์ที่จำเป็นสำหรับการแสดงโฆษณา

correlator (สหสัมพันธ์)

คำอธิบาย

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

ตัวอย่างการใช้

correlator=4345645667

ข้อกำหนดและคำแนะนำ

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

การใช้งาน SDK

• ถ้ามีการใช้ IMA SDK ก็จะมีการตั้งค่าสหสัมพันธ์โดยอัตโนมัติ หากโปรแกรมเล่นพยายามตั้งค่านี้ SDK จะเขียนทับค่านี้ด้วยค่าของตัวเอง
• หากไม่ได้ใช้ IMA SDK ให้ตรวจสอบว่าคุณตั้งค่านี้เป็นจำนวนบวกแบบสุ่มที่แท้จริง ซึ่งไม่ถูกใช้ซ้ำโดยการดูหน้าเว็บหลายๆ ครั้ง

กลับไปที่มุมมองรายการ

description_url (URL คำอธิบาย)

คำอธิบาย

พารามิเตอร์ URL คำอธิบาย (description_url) จะยอมรับค่าตัวแปร ซึ่งควรอธิบายวิดีโอที่กำลังเล่นอยู่ในหน้าเว็บ

URL คำอธิบายควรเกี่ยวข้องกับวิดีโอที่เล่นอยู่ในหน้าใดหน้าหนึ่งของเว็บแอป แอปบนอุปกรณ์เคลื่อนที่ หรือแอปทีวี และไม่ควรเป็นโดเมนระดับบนสุดสำหรับวิดีโอทั้งหมดหรือคำขอโฆษณาทั้งหมด ตัวอย่างเช่น หากคุณมีหน้า https://www.sample.com/golf.html สำหรับแสดงวิดีโอเกี่ยวกับกอล์ฟ ให้ตั้งค่าเป็นค่าของ description_url

ตัวอย่างการใช้

ค่า description_url ต้องเป็น URL ที่เข้ารหัสสำหรับหน้าเว็บที่มีวิดีโอและอุปกรณ์ CTV/OTT อย่างไรก็ตาม ค่า description_url ต้องไม่เข้ารหัสสำหรับแอปบนอุปกรณ์เคลื่อนที่

URL ที่เข้ารหัส:
description_url=
https%3A%2F%2Fwww.sample.com%2Fgolf.html

URL ที่ไม่เข้ารหัส:
description_url=
https://www.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 ทุกเวอร์ชันที่เซิร์ฟเวอร์โฆษณาบุคคลที่สามอาจจะแสดง

เวอร์ชัน VAST สำหรับ Authorized Buyers และการเสนอราคาแบบเปิด

หากต้องการกรองตามเวอร์ชัน VAST อย่างเข้มงวดสำหรับ Authorized Buyers และการเสนอราคาแบบเปิด คุณสามารถเปิดการตั้งค่า "กรองเวอร์ชัน 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%2Fwww.example.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) จะยอมรับค่าคงที่ซึ่งระบุคำขอตำแหน่งโฆษณาประเภทใดประเภทหนึ่ง

คำจำกัดความของตำแหน่งโฆษณาสำหรับตัวอย่างด้านล่าง

• หยุดชั่วคราว: รูปแบบนอกสตรีมที่ปรากฏผ่านการวางซ้อนบนเนื้อหาวิดีโอเมื่อผู้ใช้หยุดเล่นเนื้อหาชั่วคราว
• หน้าจอหลัก: โฆษณาที่ปรากฏบนหน้าจอหลักของอุปกรณ์ 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

ข้อกำหนดและคำแนะนำ

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

กลับไปที่มุมมองรายการ

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

กลับไปที่มุมมองรายการ