บทความนี้แสดงรายการพารามิเตอร์ทั้งหมดที่ใช้ได้ในแท็กโฆษณา VAST ซึ่งอาจมีประโยชน์หากคุณต้องการทราบข้อมูลเพิ่มเติมเกี่ยวกับพารามิเตอร์ที่เฉพาะเจาะจง
ดูดัชนีตามลําดับตัวอักษรที่คลิกได้ของพารามิเตอร์ทั้งหมดในหน้านี้
- พารามิเตอร์ที่จำเป็นสำหรับการแสดงโฆษณา
- พารามิเตอร์ที่จำเป็นสำหรับรายการแบบเป็นโปรแกรม
- พารามิเตอร์ที่แนะนำสำหรับรายการแบบเป็นโปรแกรม
- พารามิเตอร์อื่นๆ
false/true แต่ขอแนะนำให้ใช้ 0/1 สำหรับพารามิเตอร์บูลีน (เช่น vpmute, wta, ad_rule, gdpr และอื่นๆ)รายการพารามิเตอร์ตามประเภทการใช้งาน
หากใช้การติดตั้งใช้งานที่เฉพาะเจาะจง คุณสามารถใช้รายการพารามิเตอร์ที่กำหนดเองซึ่งระบุการใช้งานและข้อกำหนดสำหรับการติดตั้งใช้งานนั้น ใช้รายการพารามิเตอร์ที่กำหนดเองสำหรับ
เว็บ แอปบนอุปกรณ์เคลื่อนที่ ทีวีที่เชื่อมต่ออินเทอร์เน็ต เสียง สื่อโฆษณาดิจิทัลกลางแจ้ง
พารามิเตอร์ทั้งหมด
พารามิเตอร์ที่จำเป็นสำหรับการแสดงโฆษณา
โดยทั่วไปแล้ว พารามิเตอร์เหล่านี้จำเป็นสำหรับการแสดงโฆษณาสำหรับการใช้งานส่วนใหญ่ อย่างไรก็ตาม อาจมีบางกรณีที่ไม่จำเป็นต้องใช้ ใช้รายการพารามิเตอร์สำหรับประเภทการติดตั้งใช้งานที่เฉพาะเจาะจงเพื่อให้ได้ข้อมูลที่ถูกต้องที่สุด
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
ข้อกำหนดและคำแนะนำ
พารามิเตอร์นี้จำเป็นสำหรับการใช้การแสดงโฆษณาในเว็บและแอปบนอุปกรณ์เคลื่อนที่เมื่อมีโอกาสในการแสดงผลที่ล่าช้า
พารามิเตอร์ที่จำเป็นสำหรับรายการแบบเป็นโปรแกรม
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
ข้อกำหนดและคำแนะนำ
พารามิเตอร์นี้จำเป็นสำหรับการสร้างรายได้แบบเป็นโปรแกรมในเว็บ แอปบนอุปกรณ์เคลื่อนที่ ทีวีที่เชื่อมต่ออินเทอร์เน็ต เสียง และสื่อดิจิทัลนอกบ้าน
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 จะยึดตามค่าดังกล่าว
venuetype (ประเภทสถานที่)
คำอธิบาย
พารามิเตอร์ประเภทสถานที่ (venuetype) ใช้เพื่อระบุประเภทสถานที่ตั้งนอกบ้าน ค่าที่มีสิทธิ์คือรหัสเลขจำนวนเต็มสำหรับการแจกแจงซึ่งการจัดหมวดหมู่เวอร์ชัน 1.1 สำหรับประเภทสถานที่ตั้ง OpenOOH ของ IAB รองรับ
ตัวอย่างการใช้
ห้องพักโรงแรม:
venuetype=80703
แท็บเล็ตในเบาะหลังของแท็กซี่:
venuetype=103
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) จะยอมรับค่าตัวแปรซึ่งควรใช้กับคำขอที่ส่งจากแอปบนอุปกรณ์เคลื่อนที่และอุปกรณ์ทีวีที่เชื่อมต่ออินเทอร์เน็ต เนื่องจากโฆษณาวิดีโอแบบเป็นโปรแกรมส่วนใหญ่จำเป็นต้องใช้พารามิเตอร์ดังกล่าว
ในขณะที่ชื่อแอปควรเป็นชื่อที่มนุษย์อ่านได้ แต่ใน iOS และ tvOS นั้น SDK ไม่อาจเข้าถึงรหัสแอป ในกรณีเช่นนี้ จะไม่มีการส่งพารามิเตอร์ msid และ SDK จะส่ง App Bundle ผ่านพารามิเตอร์ an
ตัวอย่างการใช้
msid=com.package.publisher&an=sample%20app
ระบบจะตั้งชื่อและจัดรูปแบบรหัสแอป แตกต่างกันไปตาม App Store ต่างๆ ดูหลักเกณฑ์ของ IAB เกี่ยวกับการระบุแอป หรือตัวอย่างของตัวระบุที่ไม่ซ้ำกันทั่วไป
สำหรับแพลตฟอร์มที่ไม่มี App Store อยู่ IAB แนะนําให้ผู้เผยแพร่โฆษณาใช้รูปแบบต่อไปนี้สำหรับรหัสร้านค้า com.publisher.deviceplatform
ข้อกำหนดและคำแนะนำ
แม้ว่าจะไม่จำเป็นต้องใช้พารามิเตอร์นี้เพื่อแสดงโฆษณาสำหรับการใช้งานที่เจาะจง แต่เราขอแนะนําให้ใช้สำหรับการสร้างรายได้แบบเป็นโปรแกรมในแอปบนอุปกรณ์เคลื่อนที่ ทีวีที่เชื่อมต่ออินเทอร์เน็ต เสียง และสื่อดิจิทัลนอกบ้าน
เราขอแนะนำให้ระบุข้อมูลแอปด้วยเพื่อความปลอดภัยของแบรนด์และเพิ่มความโปร่งใสให้แก่ผู้ซื้อ
การใช้งาน SDK
IMA SDK จะป้อนค่าพารามิเตอร์ทั้งคู่นี้ให้โดยอัตโนมัติ แต่คุณจะต้องระบุด้วยตนเองในสภาพแวดล้อมที่ไม่ใช่ SDK ซึ่งรวมถึงการเรียกใช้ VAST โดยตรง หรือเมื่อใช้ Programmatic Access Library (PAL) หรือ Publisher Authenticated Inventory (PAI)
หมายเหตุ: หากใช้ HTML5 IMA SDK ระบบจะไม่ใช้ข้อมูลแอป
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
ข้อกำหนดและคำแนะนำ
แม้ว่าจะไม่จำเป็นต้องใช้พารามิเตอร์นี้เพื่อแสดงโฆษณาสำหรับการใช้งานที่เจาะจง แต่เราขอแนะนําให้ใช้สำหรับการสร้างรายได้แบบเป็นโปรแกรมในเว็บ แอปบนอุปกรณ์เคลื่อนที่ ทีวีที่เชื่อมต่ออินเทอร์เน็ต เสียง และสื่อดิจิทัลนอกบ้าน
msid (รหัสแอป)
คำอธิบาย
พารามิเตอร์รหัสแอป (msid) และพารามิเตอร์ชื่อแอป (an) จะยอมรับค่าตัวแปรซึ่งควรใช้กับคำขอที่ส่งจากแอปบนอุปกรณ์เคลื่อนที่และอุปกรณ์ทีวีที่เชื่อมต่ออินเทอร์เน็ต เนื่องจากโฆษณาวิดีโอแบบเป็นโปรแกรมส่วนใหญ่จำเป็นต้องใช้พารามิเตอร์ดังกล่าว
ในขณะที่ชื่อแอปควรเป็นชื่อที่มนุษย์อ่านได้ แต่ใน iOS และ tvOS นั้น SDK ไม่อาจเข้าถึงรหัสแอป ในกรณีเช่นนี้ จะไม่มีการส่งพารามิเตอร์ msid และ SDK จะส่ง App Bundle ผ่านพารามิเตอร์ an
ตัวอย่างการใช้
msid=com.package.publisher&an=sample%20app
ระบบจะตั้งชื่อและจัดรูปแบบรหัสแอป แตกต่างกันไปตาม App Store ต่างๆ ดูหลักเกณฑ์ของ IAB เกี่ยวกับการระบุแอป หรือตัวอย่างของตัวระบุที่ไม่ซ้ำกันทั่วไป
สำหรับแพลตฟอร์มที่ไม่มี App Store อยู่ IAB แนะนําให้ผู้เผยแพร่โฆษณาใช้รูปแบบต่อไปนี้สำหรับรหัสร้านค้า com.publisher.deviceplatform
ข้อกำหนดและคำแนะนำ
แม้ว่าจะไม่จำเป็นต้องใช้พารามิเตอร์นี้เพื่อแสดงโฆษณาสำหรับการใช้งานที่เจาะจง แต่เราขอแนะนําให้ใช้สำหรับการสร้างรายได้แบบเป็นโปรแกรมในแอปบนอุปกรณ์เคลื่อนที่ ทีวีที่เชื่อมต่ออินเทอร์เน็ต เสียง และสื่อดิจิทัลนอกบ้าน
เราขอแนะนำให้ระบุข้อมูลแอปด้วยเพื่อความปลอดภัยของแบรนด์และเพิ่มความโปร่งใสให้แก่ผู้ซื้อ
การใช้งาน SDK
IMA SDK จะป้อนค่าพารามิเตอร์ทั้งคู่นี้ให้โดยอัตโนมัติ แต่คุณจะต้องระบุด้วยตนเองในสภาพแวดล้อมที่ไม่ใช่ SDK ซึ่งรวมถึงการเรียกใช้ VAST โดยตรง หรือเมื่อใช้ Programmatic Access Library (PAL) หรือ Publisher Authenticated Inventory (PAI)
หมายเหตุ: หากใช้ 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 เพราะตั้งค่าไว้โดยอัตโนมัติ
rdid (ตัวระบุอุปกรณ์ที่รีเซ็ตได้)
คำอธิบาย
พารามิเตอร์ตัวระบุอุปกรณ์ที่รีเซ็ตได้ (rdid, idtype, is_lat) ยอมรับค่าตัวแปร ค่านี้เรียกอีกอย่างว่าตัวระบุสำหรับการโฆษณา (IFA)
สำหรับแอปพลิเคชันบนอุปกรณ์เคลื่อนที่ที่ใช้ IMA SDK สำหรับ Android หรือ iOS นั้น IMA SDK จะส่งตัวระบุอุปกรณ์ที่รีเซ็ตได้สำหรับการกําหนดเป้าหมายผู้ใช้ไปยังคําขอสตรีมของคุณด้วยพารามิเตอร์สำหรับ rdid, idtype และ is_lat
เมื่อไม่ได้ใช้ IMA SDK หรือเมื่อใช้บีคอนฝั่งเซิร์ฟเวอร์ (SSB) คุณต้องส่งพารามิเตอร์เหล่านี้เป็นพารามิเตอร์ที่ชัดแจ้ง ดูข้อมูลเพิ่มเติมเกี่ยวกับตัวระบุอุปกรณ์
สำหรับโฆษณาวิดีโอแบบเป็นโปรแกรมเกือบทั้งหมด จำเป็นต้องมีค่าเหล่านี้
|
Apple เลิกใช้งานสัญญาณ |
ตัวอย่างการใช้
ดูตัวอย่างโดยละเอียดของตัวระบุอุปกรณ์ที่รีเซ็ตได้
ข้อกำหนดและคำแนะนำ
แม้ว่าจะไม่จำเป็นต้องใช้พารามิเตอร์เหล่านี้เพื่อแสดงโฆษณาสำหรับการติดตั้งใช้งานใดโดยเฉพาะ แต่ต้องใช้ในการสร้างรายได้แบบเป็นโปรแกรมในแอปบนอุปกรณ์เคลื่อนที่ ทีวีที่เชื่อมต่ออินเทอร์เน็ต เสียง และสื่อนอกบ้านดิจิทัล
สำหรับการติดตั้งใช้งานบนเว็บ ระบบจะไม่ใช้ตัวระบุอุปกรณ์ที่รีเซ็ตได้
การใช้งาน SDK
ขณะที่ IMA SDK ส่งฟิลด์นี้โดยอัตโนมัติ ผู้เผยแพร่โฆษณาจะส่งพารามิเตอร์เหล่านี้ด้วยตนเองโดยใช้ PAL SDK
sid (รหัสเซสชัน)
คำอธิบาย
พารามิเตอร์รหัสเซสซัน (sid) ยอมรับค่าตัวแปรซึ่งเป็นตัวระบุโฆษณาที่รักษาความเป็นส่วนตัว โดยจะใช้ได้เพื่อจุดประสงค์ในการกำหนดความถี่สูงสุดเท่านั้น
รหัสเซสชันใช้ได้กับคําขอโฆษณาวิดีโอในสตรีมจากทีวีที่เชื่อมต่ออินเทอร์เน็ตและพื้นที่โฆษณาวิดีโอในสตรีมจากแอปบนอุปกรณ์เคลื่อนที่ ปัจจุบันยังไม่รองรับการใช้งานบนเว็บ
คุณเลือกไม่ใช้การส่งรหัสเซสชันได้โดยการตั้งค่า sid=0
ตัวอย่างการใช้
sid=123e4567-e89b-12d3-a456-426614174000
ตามหลักเกณฑ์ IFA ของ IAB พารามิเตอร์นี้ต้องระบุในรูปแบบ 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พารามิเตอร์อื่นๆ
โดยทั่วไปแล้ว คุณไม่จำเป็นต้องระบุพารามิเตอร์เหล่านี้อย่างชัดเจนเพื่อแสดงโฆษณา แต่อาจจำเป็นต้องระบุเพื่อใช้ฟีเจอร์บางอย่าง หรืออาจจำเป็นต้องระบุสำหรับประเภทการติดตั้งใช้งานบางอย่าง
ad_rule (กฎโฆษณา)
คำอธิบาย
พารามิเตอร์กฎโฆษณา (ad_rule) จะยอมรับค่าคงที่ซึ่งระบุว่าจะตอบกลับคำขอด้วยครีเอทีฟโฆษณา VAST หรือกฎโฆษณา
การตั้งค่าเริ่มต้นสำหรับกฎโฆษณาจะขึ้นอยู่กับการตั้งค่าเครือข่าย Ad Manager ของ Google ซึ่งเปิดใช้คำขอทั้งหมดให้เป็นคำขอกฎโฆษณา หากใช้การตั้งค่าเครือข่าย ก็ไม่จำเป็นต้องตั้งค่า ad_rule ในแท็กโฆษณา หากต้องการปิดใช้ตามคำขอโฆษณา ให้ส่ง ad_rule=0 เพื่อลบล้างการตั้งค่าเครือข่าย นอกจากนี้ หากไม่ได้เปิดกฎโฆษณาไว้โดยค่าเริ่มต้น คุณสามารถเปิด/ปิดได้โดยส่ง ad_rule=1 และ ad_rule=0 ตามลำดับ
ตัวอย่างการใช้
หากปิดใช้การตั้งค่ากฎโฆษณา
- คำขอครีเอทีฟโฆษณา VAST:
ad_rule=0หรือไม่ต้องตั้งค่า
หากเปิดใช้การตั้งค่ากฎโฆษณา
- คำขอครีเอทีฟโฆษณา VAST:
ad_rule=0 - คำขอกฎโฆษณา (VMAP):
ad_rule=1หรือไม่ต้องตั้งค่า
หากเลือกไม่ใช้กฎโฆษณา คุณสามารถใช้พารามิเตอร์แท็กโฆษณาเพื่อระบุช่วงพักโฆษณาและระยะเวลาของพ็อดสำหรับแท็ก VAST โดยใช้ pmnd, pmxd และ pmad
ข้อกำหนดและคำแนะนำ
แม้ว่าพารามิเตอร์นี้จะไม่จำเป็นต่อการแสดงโฆษณาสำหรับการใช้งานประเภทใดก็ตาม แต่ต้องใช้พารามิเตอร์นี้เพื่อใช้กฎโฆษณาวิดีโออย่างถูกต้อง
addtl_consent (ความยินยอมเพิ่มเติม)
คำอธิบาย
พารามิเตอร์ความยินยอมเพิ่มเติม (addtl_consent) จะยอมรับค่าตัวแปรและใช้โดยผู้เผยแพร่โฆษณาที่ต้องการผสานรวมกับ TCF เวอร์ชัน 2.0 ของ IAB และใช้ผู้ให้บริการที่ยังไม่ได้ลงทะเบียนในรายชื่อผู้ให้บริการทั่วโลกของ IAB Europe แต่อยู่ในรายชื่อผู้ให้บริการเทคโนโลยีโฆษณา (ATP) ของ Google
อ่านข้อมูลเพิ่มเติมเกี่ยวกับค่าที่ส่งต่อไปยังพารามิเตอร์นี้ได้ในข้อกำหนดทางเทคนิคของโหมดความยินยอมเพิ่มเติม
ตัวอย่างการใช้งาน
addtl_consent=1~1.35.41.101
adtest (การทดสอบโฆษณา)
คำอธิบาย
คุณควรใช้พารามิเตอร์การทดสอบโฆษณา (adtest) เพื่อให้แน่ใจว่าคำค้นหาที่ใช้ทดสอบพื้นที่โฆษณาทดแทน (ไม่รับประกันการแสดงผล) จะไม่ถูกระบุว่าเป็นการเข้าชมที่ไม่ถูกต้อง และจะไม่ส่งผลต่อรายได้
เมื่อทดสอบการทดแทน ให้ตั้งค่าพารามิเตอร์นี้เป็น on เพื่อให้แน่ใจว่าจะไม่มีโฆษณาที่บันทึกการแสดงผลหรือการคลิกสำหรับใช้ในช่วงทดสอบ ในสภาพแวดล้อมที่ไม่ใช่การทดสอบเพื่อเรียกเก็บเงินตามปกติ ให้ตั้งค่าเป็น off หากไม่ได้ตั้งค่าไว้ ระบบจะใช้ค่าเริ่มต้นเป็น off
หมายเหตุ: เมื่อทดสอบรายการโฆษณาที่ขายโดยตรง คุณควรใช้รายการโฆษณาทดสอบที่ไม่มีผลต่อรายได้แทน
ตัวอย่างการใช้
เปิด:
adtest=on
ปิด:
adtest=off
ad_type (ประเภทโฆษณา)
คำอธิบาย
พารามิเตอร์ประเภทโฆษณา (ad_type) จะยอมรับค่าคงที่ซึ่งระบุประเภทโฆษณาที่ควรแสดงสำหรับคำขอ
เมื่อพารามิเตอร์ ad_type ตั้งค่าเป็น audio หรือ audio_video พารามิเตอร์ vpmute จะต้องตั้งค่าเป็น 0
ตัวอย่างการใช้
อนุญาตเฉพาะโฆษณาเสียง:
ad_type=audio
อนุญาตโฆษณาวิดีโอทั้งที่ข้ามได้และข้ามไม่ได้:
ad_type=video
อนุญาตทั้งโฆษณาเสียงและโฆษณาวิดีโอ:
ad_type=audio_video
ค่า
audio_videoนี้ช่วยให้ทั้ง 2 รูปแบบแข่งขันกันได้ แต่จะมีรูปแบบเดียวที่ได้แสดง มีวัตถุประสงค์เพื่อใช้สำหรับการแสดงครีเอทีฟโฆษณาวิดีโอในเนื้อหาเสียงที่รองรับการเล่นโฆษณาวิดีโอหรือแสดงครีเอทีฟโฆษณาเสียงในวิดีโอเพลเยอร์โฆษณาวิดีโอในสตรีมสำหรับเนื้อหาที่ "สามารถฟังได้" เช่น สตรีมกีฬา วิดีโอแคสต์ ข่าว ฯลฯ อ่านเกี่ยวกับเสียงในเนื้อหาวิดีโอ
อนุญาตเฉพาะโฆษณาวิดีโอที่ข้ามได้:
ad_type=skippablevideo
อนุญาตเฉพาะโฆษณาวิดีโอที่ข้ามไม่ได้:
ad_type=standardvideo
ข้อกำหนดและคำแนะนำ
- หากแอปมีเนื้อหาวิดีโอ ให้ตั้งค่าพารามิเตอร์นี้เป็น
video,audio_videoหรือไม่ต้องตั้งค่า - หากแอปมีเนื้อหาเสียงเท่านั้น (เช่น แอปวิทยุหรือแอปเสียงพูด) คุณต้องตั้งค่าพารามิเตอร์นี้เป็น
audioการไม่ตั้งค่าจะทำให้ระบบไม่แสดงโฆษณาเสียง
afvsz (ขนาดโฆษณาที่ไม่ใช่แบบเชิงเส้น)
คำอธิบาย
พารามิเตอร์ขนาดโฆษณาที่ไม่ใช่แบบเชิงเส้น (afvsz) จะยอมรับค่าคงที่ซึ่งควรเป็นรายการขนาดโฆษณาที่ไม่ใช่แบบเชิงเส้นและแสดงในช่องโฆษณาวิดีโอได้ โดยเป็นรายการที่คั่นด้วยคอมมา
ขนาดดังกล่าวต้องเป็นขนาดที่รองรับ ดังนี้
200x200250x250300x250336x280450x50468x60480x90729x90
เมื่อใช้ IMA SDK ระบบจะเขียนทับช่องนี้ด้วยขนาดที่รองรับทั้งหมดตาม nonLinearAdSlotWidth และ nonLinearAdSlotHeight
คุณสามารถปล่อยพารามิเตอร์นี้เว้นว่างไว้ได้เมื่อไม่รองรับขนาดที่ไม่ใช่แบบเชิงเส้น
ตัวอย่างการใช้
รองรับทุกขนาด:
afvsz=200x200,250x250,300x250,336x280,
450x50,468x60,480x90,728x90
ความกว้างสูงสุดคือ 250:
afvsz=200x200,250x250
ความสูงสูงสุดคือ 60:
afvsz=450x50,468x60
ความกว้างสูงสุดคือ 100:
//ว่างเปล่า หมายถึงไม่รองรับค่าใดเลย
ข้อกำหนดและคำแนะนำ
แม้ว่าพารามิเตอร์นี้จะไม่จำเป็นในการแสดงโฆษณาต่อการติดตั้งใช้งานหรือธุรกรรมประเภทใดก็ตาม แต่จำเป็นต้องใช้เพื่อแสดงโฆษณาวิดีโอที่ไม่ใช่เชิงเส้นเมื่อไม่ได้ใช้ IMA SDK
allcues (จุดเริ่มโฆษณาทั้งหมด)
คำอธิบาย
พารามิเตอร์จุดเริ่มโฆษณาทั้งหมด (allcues) ยอมรับค่าตัวแปรซึ่งเป็นรายการที่คั่นด้วยคอมมาของจุดเริ่มโฆษณา มีหน่วยเป็นมิลลิวินาที สำหรับแต่ละค่า Google Ad Manager จะแสดงช่วงพักโฆษณา
- พารามิเตอร์
vid_dและallcuesใช้เพื่อแสดงโฆษณาตอนกลางโดยไม่ต้องนำเข้าเนื้อหา - คุณต้องใช้กฎโฆษณาด้วยจึงจะแสดงโฆษณาตอนกลางได้ หากมีการใช้จุดเวลาในกฎโฆษณา (เช่น "ทุก N วินาที" หรือ "ตามเวลาที่กำหนด") ระบบจะใช้จุดเวลาที่ตั้งค่าไว้ในกฎโฆษณาและละเว้นจุดเวลาที่ส่งเข้าไปใน
allcuesโฆษณาตอนกลางยังคงต้องมีระยะเวลา จึงต้องมีการส่งvid_dอยู่
ตัวอย่างการใช้
จุดเริ่มโฆษณาวินาทีที่ 10 และ 20
allcues=10000,20000
ciu_szs (ขนาดโฆษณาที่แสดงร่วม)
คำอธิบาย
พารามิเตอร์ขนาดโฆษณาที่แสดงร่วม (ciu_szs) จะยอมรับค่าตัวแปรซึ่งเป็นรายการที่คั่นด้วยคอมมาของขนาดโฆษณาที่แสดงร่วม
ค่าที่คั่นด้วยอักขระไปป์ (|) แสดงถึงช่องโฆษณาหลายขนาด
ตัวอย่างการใช้
ciu_szs=728x90,300x250
ขนาดที่มีช่องโฆษณาหลายขนาด:
ciu_szs=728x90,300x200|300x250
cmsid (รหัสแหล่งที่มาของเนื้อหา)
คำอธิบาย
พารามิเตอร์รหัสแหล่งที่มาของเนื้อหา (cmsid) และพารามิเตอร์รหัสวิดีโอ (vid) จะยอมรับค่าตัวแปร
ในการกำหนดเป้าหมายโฆษณาไปยังเนื้อหาวิดีโอ แท็กวิดีโอหลักต้องมีพารามิเตอร์ทั้งสองรายการ
cmsidเป็นหมายเลขที่ไม่ซ้ำสำหรับแหล่งที่มาของเนื้อหาแต่ละแหล่ง หากต้องการดูหมายเลขนี้ใน Google Ad Manager ให้คลิกวิดีโอ แล้วคลิกแหล่งที่มาของเนื้อหา แล้วคลิกชื่อของแหล่งที่มาvidเป็นสตริงหรือหมายเลขที่ระบุวิดีโอที่เจาะจง รหัสนี้กำหนดโดย CMS ที่โฮสต์เนื้อหาของคุณ หากต้องการดูรหัสนี้ใน Google Ad Manager ให้คลิกวิดีโอ จากนั้นคลิกเนื้อหา แล้วคลิกเนื้อหาวิดีโอที่เจาะจง
ตัวอย่างการใช้
cmsid=[value]&vid=[value]
หากคุณกำลังสร้างแท็กสำหรับวิดีโอออนดีมานด์ที่มีการแทรกโฆษณาแบบไดนามิก คุณควรใช้มาโครที่จะแทรกแหล่งที่มาของเนื้อหาและรหัสวิดีโอที่ถูกต้องในแบบไดนามิก
ตัวอย่างเช่น: cmsid=%%CMS_ID%%&vid=%%VIDEO_ID%%
ข้อกำหนดและคำแนะนำ
แม้ว่าพารามิเตอร์เหล่านี้ไม่จำเป็นต่อการแสดงโฆษณาสำหรับการติดตั้งใช้งานหรือธุรกรรมประเภทใดประเภทหนึ่ง แต่ต้องใช้การกำหนดเป้าหมายตามเนื้อหาวิดีโอ
cust_params (พารามิเตอร์ที่กำหนดเอง)
คำอธิบาย
พารามิเตอร์ที่กำหนดเอง (cust_params) จะยอมรับค่าตัวแปรซึ่งก็คือคู่คีย์-ค่าที่ช่วยให้คุณตั้งค่าการกำหนดเป้าหมายที่เฉพาะเจาะจงได้ เช่น ข้อมูลประชากร บางตำแหน่งในหน้าเว็บ หรือหน้าเว็บบางหน้าหรือหลายหน้า
ตัวอย่างการใช้
ดูตัวอย่างวิธีเพิ่มคู่คีย์-ค่า
excl_cat (หมวดหมู่การยกเว้น)
คำอธิบาย
พารามิเตอร์หมวดหมู่การยกเว้น (excl_cat) จะยอมรับค่าตัวแปร และใช้เพื่อบล็อกรายการโฆษณาทุกรายการที่มีป้ายกำกับการยกเว้นในคำขอโฆษณา ใช้พารามิเตอร์ cust_params เพื่อตั้งค่าหมวดหมู่การยกเว้นและป้ายกำกับการยกเว้น
ตัวอย่างการใช้
หากต้องการตั้งค่าหมวดหมู่การยกเว้นสำหรับป้ายกำกับการยกเว้น 2 รายการ (airline_excl_label และ train_excl_label) ให้ใช้อักขระเครื่องหมายทับ (|) เพื่อคั่นป้ายกำกับ
excl_cat=airline_excl_label%7Ctrain_excl_label
จากนั้นใช้การเข้ารหัส URL และใช้สตริงที่เข้ารหัสใน cust_params
&cust_params=excl_cat%3Dairline_excl_label%7Ctrain_excl_label
gdpr (GDPR)
คำอธิบาย
พารามิเตอร์ GDPR (gdpr) จะยอมรับค่าคงที่และใช้โดยผู้เผยแพร่โฆษณาที่ต้องการผสานรวมกับ TCF เวอร์ชัน 2.0 ของ IAB คำขอ VAST โดยตรงจะไม่อ่านค่าดังกล่าวโดยอัตโนมัติ แต่ค่าจะได้รับการยอมรับเมื่อเพิ่มลงในแท็กโฆษณา
มีเพียง 0 และ 1 เท่านั้นที่เป็นค่าที่ถูกต้องสำหรับพารามิเตอร์นี้ โดยที่ 0 หมายความว่า GDPR ไม่มีผล และ 1 หมายถึง GDPR มีผล หาก GDPR มีผล คุณต้องระบุสตริง TC ที่ถูกต้องโดยใช้พารามิเตอร์ gdpr_consent ด้วย
อ่านข้อมูลเพิ่มเติมเกี่ยวกับค่าที่ส่งต่อไปยังพารามิเตอร์นี้ได้ในคำแนะนำทั่วไปในการใช้เฟรมเวิร์กนี้หรือในส่วนสตริง TC ของข้อกำหนด TCF เวอร์ชัน 2.0 ของ IAB
ตัวอย่างการใช้
GDPR มีผล:
gdpr=1
GDPR ไม่มีผล:
gdpr=0
gdpr_consent (ความยินยอมตาม GDPR)
คำอธิบาย
พารามิเตอร์คำยินยอมตาม GDPR (gdpr_consent) จะยอมรับค่าตัวแปรและใช้โดยผู้เผยแพร่โฆษณาที่ต้องการผสานรวมกับ TCF เวอร์ชัน 2.0 ของ IAB คำขอ VAST โดยตรงจะไม่อ่านค่าดังกล่าวโดยอัตโนมัติ แต่ค่าจะได้รับการยอมรับเมื่อเพิ่มลงในแท็กโฆษณา
อ่านข้อมูลเพิ่มเติมเกี่ยวกับค่าที่ส่งต่อไปยังพารามิเตอร์นี้ได้ในคำแนะนำทั่วไปในการใช้เฟรมเวิร์กนี้หรือในส่วนสตริง TC ของข้อกำหนด TCF เวอร์ชัน 2.0 ของ IAB
ตัวอย่างการใช้
gdpr_consent=GDPR_CONSENT_123
iabexcl (URL การยกเว้น IAB)
คำอธิบาย
พารามิเตอร์ URL การยกเว้นของ IAB (iabexcl) ยอมรับค่าตัวแปรซึ่งเป็นรายการหมวดหมู่ที่คั่นด้วยคอมมา
ตัวอย่างการใช้
iabexcl=3,14,527 ยกเว้น "รถบรรทุกเพื่อการพาณิชย์", "รถออฟโรด" และ "รักบี้"
คุณสามารถดาวน์โหลดรายการหมวดหมู่การจัดหมวดหมู่เนื้อหาของ IAB และรหัสของหมวดหมู่ได้
idtype (ประเภทอุปกรณ์)
คำอธิบาย
พารามิเตอร์ตัวระบุอุปกรณ์ที่รีเซ็ตได้ (rdid, idtype, is_lat) ยอมรับค่าตัวแปร ค่านี้เรียกอีกอย่างว่าตัวระบุสำหรับการโฆษณา (IFA)
สำหรับแอปพลิเคชันบนอุปกรณ์เคลื่อนที่ที่ใช้ IMA SDK สำหรับ Android หรือ iOS นั้น IMA SDK จะส่งตัวระบุอุปกรณ์ที่รีเซ็ตได้สำหรับการกําหนดเป้าหมายผู้ใช้ไปยังคําขอสตรีมของคุณด้วยพารามิเตอร์สำหรับ rdid, idtype และ is_lat
เมื่อไม่ได้ใช้ IMA SDK หรือเมื่อใช้บีคอนฝั่งเซิร์ฟเวอร์ (SSB) คุณต้องส่งพารามิเตอร์เหล่านี้เป็นพารามิเตอร์ที่ชัดแจ้ง ดูข้อมูลเพิ่มเติมเกี่ยวกับตัวระบุอุปกรณ์
สำหรับโฆษณาวิดีโอแบบเป็นโปรแกรมเกือบทั้งหมด จำเป็นต้องมีค่าเหล่านี้
|
Apple เลิกใช้งานสัญญาณ |
ตัวอย่างการใช้
ดูตัวอย่างโดยละเอียดของตัวระบุอุปกรณ์ที่รีเซ็ตได้
ข้อกำหนดและคำแนะนำ
แม้ว่าจะไม่จำเป็นต้องใช้พารามิเตอร์เหล่านี้เพื่อแสดงโฆษณาสำหรับการติดตั้งใช้งานใดโดยเฉพาะ แต่ต้องใช้ในการสร้างรายได้แบบเป็นโปรแกรมในแอปบนอุปกรณ์เคลื่อนที่ ทีวีที่เชื่อมต่ออินเทอร์เน็ต เสียง และสื่อนอกบ้านดิจิทัล
สำหรับการติดตั้งใช้งานบนเว็บ ระบบจะไม่ใช้ตัวระบุอุปกรณ์ที่รีเซ็ตได้
การใช้งาน SDK
ขณะที่ IMA SDK ส่งฟิลด์นี้โดยอัตโนมัติ ผู้เผยแพร่โฆษณาจะส่งพารามิเตอร์เหล่านี้ด้วยตนเองโดยใช้ PAL SDK
ipd (โดเมนพาร์ทเนอร์พื้นที่โฆษณา)
คำอธิบาย
พารามิเตอร์โดเมนพาร์ทเนอร์พื้นที่โฆษณา (ipd) จะยอมรับค่าตัวแปรซึ่งควรจะตั้งค่าเป็นการประกาศ inventorypartnerdomain ในไฟล์ app-ads.txt (หรือ ads.txt) ของผู้เผยแพร่โฆษณา
พารามิเตอร์ inventorypartnerdomain เป็นข้อกำหนดจำเพาะของ IAB ที่ช่วยผู้เผยแพร่โฆษณาในการกำหนดโดเมนของพาร์ทเนอร์การแชร์พื้นที่โฆษณาเพื่อวัตถุประสงค์ในการตรวจสอบความถูกต้องของ ads.txt/app-ads.txt
การประกาศ IPD มีความสําคัญอย่างยิ่งใน Use Case ของการแชร์พื้นที่โฆษณาที่พื้นที่โฆษณาซึ่งมีการส่งคําขอนั้นอาจเป็นของพาร์ทเนอร์รายอื่น (ซึ่งก็คือพาร์ทเนอร์การแชร์พื้นที่โฆษณา)
ดูข้อมูลเพิ่มเติมเกี่ยวกับ ads.txt/app-ads.txt และพาร์ทเนอร์การแชร์พื้นที่โฆษณา
ตัวอย่างการใช้
inventorypartnerdomain อยู่ในไฟล์ app-ads.txt ที่ชี้ไปยังไฟล์ .txt ของพาร์ทเนอร์ที่สามารถสร้างรายได้จากพื้นที่โฆษณา ค่าในพารามิเตอร์ ipd ควรตรงกับค่าในไฟล์ app-ads.txt ในส่วนรายการ inventorypartnerdomain รายการใดรายการหนึ่งข้อกำหนดและคำแนะนำ
พารามิเตอร์นี้จำเป็นสำหรับผู้เผยแพร่โฆษณาที่สร้างรายได้จากพื้นที่โฆษณาที่ไม่ได้เป็นเจ้าของ
ipe (เอนทิตีที่ใช้คำสั่ง ping เมื่อมีการแสดงผล)
คำอธิบาย
พารามิเตอร์ Impression Pinging Entity (ipe) จะยอมรับค่าคงที่ที่ใช้เพื่อระบุคำสั่ง ping และ Conversion ของการแสดงผลที่มาจากเซิร์ฟเวอร์ ไม่ใช่จากไคลเอ็นต์
Impression Ping Entity จะใช้เมื่อเซิร์ฟเวอร์ส่งคำสั่ง ping/บีคอนการแสดงผลจากเซิร์ฟเวอร์
ตัวอย่างการใช้
การใช้บีคอนฝั่งเซิร์ฟเวอร์ (SSB):
ipe=ssb
is_lat (จํากัดการติดตามโฆษณา)
คำอธิบาย
พารามิเตอร์ตัวระบุอุปกรณ์ที่รีเซ็ตได้ (rdid, idtype, is_lat) ยอมรับค่าตัวแปร ค่านี้เรียกอีกอย่างว่าตัวระบุสำหรับการโฆษณา (IFA)
สำหรับแอปพลิเคชันบนอุปกรณ์เคลื่อนที่ที่ใช้ IMA SDK สำหรับ Android หรือ iOS นั้น IMA SDK จะส่งตัวระบุอุปกรณ์ที่รีเซ็ตได้สำหรับการกําหนดเป้าหมายผู้ใช้ไปยังคําขอสตรีมของคุณด้วยพารามิเตอร์สำหรับ rdid, idtype และ is_lat
เมื่อไม่ได้ใช้ IMA SDK หรือเมื่อใช้บีคอนฝั่งเซิร์ฟเวอร์ (SSB) คุณต้องส่งพารามิเตอร์เหล่านี้เป็นพารามิเตอร์ที่ชัดแจ้ง ดูข้อมูลเพิ่มเติมเกี่ยวกับตัวระบุอุปกรณ์
สำหรับโฆษณาวิดีโอแบบเป็นโปรแกรมเกือบทั้งหมด จำเป็นต้องมีค่าเหล่านี้
|
Apple เลิกใช้งานสัญญาณ |
ตัวอย่างการใช้
ดูตัวอย่างโดยละเอียดของตัวระบุอุปกรณ์ที่รีเซ็ตได้
ข้อกำหนดและคำแนะนำ
แม้ว่าจะไม่จำเป็นต้องใช้พารามิเตอร์เหล่านี้เพื่อแสดงโฆษณาสำหรับการติดตั้งใช้งานใดโดยเฉพาะ แต่ต้องใช้ในการสร้างรายได้แบบเป็นโปรแกรมในแอปบนอุปกรณ์เคลื่อนที่ ทีวีที่เชื่อมต่ออินเทอร์เน็ต เสียง และสื่อนอกบ้านดิจิทัล
สำหรับการติดตั้งใช้งานบนเว็บ ระบบจะไม่ใช้ตัวระบุอุปกรณ์ที่รีเซ็ตได้
การใช้งาน SDK
ขณะที่ IMA SDK ส่งฟิลด์นี้โดยอัตโนมัติ ผู้เผยแพร่โฆษณาจะส่งพารามิเตอร์เหล่านี้ด้วยตนเองโดยใช้ PAL SDK
lip (ตำแหน่งสุดท้ายในพ็อด)
คำอธิบาย
พารามิเตอร์ตำแหน่งสุดท้ายในพ็อด (lip) จะยอมรับค่าคงที่ซึ่งระบุคำขอจากตำแหน่งสุดท้ายในพ็อดสำหรับการกําหนดเป้าหมายหรือการรายงาน
หมายเหตุ: พารามิเตอร์นี้ใช้กับพ็อดที่เพิ่มประสิทธิภาพไม่ได้ และระบบจะไม่สนใจหากมีการใช้
ตัวอย่างการใช้
lip=1
ltd (โฆษณาแบบจำกัด)
คำอธิบาย
พารามิเตอร์โฆษณาแบบจำกัด (ltd) จะยอมรับค่าคงที่ซึ่งใช้ระบุว่าจะแสดงโฆษณาในแบบจำกัดหรือไม่ ในกรณีที่ไม่ได้รับคำยินยอมให้ใช้คุกกี้หรือตัวระบุอื่นๆ ในเครื่อง ผู้เผยแพร่โฆษณาสามารถเพิ่มพารามิเตอร์นี้ด้วยตนเองได้ และในทำนองเดียวกัน Google จะพยายามแสดงโฆษณาแบบจำกัดที่มีสิทธิ์โดยไม่คำนึงถึงสถานที่ตั้งของผู้ใช้
พารามิเตอร์นี้ใช้เพื่อระบุคำขอโฆษณาแบบจำกัด และแตกต่างจากพารามิเตอร์ is_lat ซึ่งจะปิดใช้การปรับตามโปรไฟล์ของผู้ใช้และการใช้ตัวระบุเพื่อวัตถุประสงค์ดังกล่าว
ltd=1 ต่างจากพารามิเตอร์ของ URL อื่นๆ ตรงที่จะเปลี่ยนลักษณะการทํางานของ IMA SDK ให้ถือว่าคำขอไม่มีรหัสและไม่อนุญาตให้ใช้พื้นที่เก็บข้อมูลเมื่อคำขอโฆษณามี
ltd=1 (คือคำขอโฆษณาแบบจำกัด) โดเมนจะเปลี่ยนเป็น pagead2.googlesyndication.com เมื่อใช้ SDK สำหรับการผสานรวมแบบไม่ต้องใช้ SDK ผู้เผยแพร่โฆษณาจะต้องเปลี่ยนเป็นโดเมน pagead2.googlesyndication.com ด้วยตนเองตัวอย่างการใช้
ltd=1
max_ad_duration (ระยะเวลาโฆษณาสูงสุด)
คำอธิบาย
พารามิเตอร์ระยะเวลาโฆษณาขั้นต่ำ (min_ad_duration) และพารามิเตอร์ระยะเวลาโฆษณาสูงสุด (max_ad_duration) จะยอมรับค่าตัวแปรซึ่งเมื่อใช้ร่วมกันจะระบุช่วงระยะเวลาที่ต้องตรงกับโฆษณา โดยมีหน่วยเป็นมิลลิวินาที
พารามิเตอร์นี้อาจใช้เพื่อจำกัดครีเอทีฟโฆษณาให้มีระยะเวลาตามที่ต้องการในแท็กโฆษณาสำหรับโฆษณาเดี่ยวหรือในคำขอพ็อดที่เพิ่มประสิทธิภาพ
ตัวอย่างการใช้
min_ad_duration=15000&max_ad_duration=30000
min_ad_duration (ระยะเวลาของโฆษณาขั้นต่ำ)
คำอธิบาย
พารามิเตอร์ระยะเวลาโฆษณาขั้นต่ำ (min_ad_duration) และพารามิเตอร์ระยะเวลาโฆษณาสูงสุด (max_ad_duration) จะยอมรับค่าตัวแปรซึ่งเมื่อใช้ร่วมกันจะระบุช่วงระยะเวลาที่ต้องตรงกับโฆษณา โดยมีหน่วยเป็นมิลลิวินาที
พารามิเตอร์นี้อาจใช้เพื่อจำกัดครีเอทีฟโฆษณาให้มีระยะเวลาตามที่ต้องการในแท็กโฆษณาสำหรับโฆษณาเดี่ยวหรือในคำขอพ็อดที่เพิ่มประสิทธิภาพ
ตัวอย่างการใช้
min_ad_duration=15000&max_ad_duration=30000
mridx (หมายเลขโฆษณาตอนกลาง)
คำอธิบาย
พารามิเตอร์หมายเลขโฆษณาตอนกลาง (mridx) จะยอมรับค่าตัวแปรซึ่งระบุเลขลำดับของโฆษณาตอนกลาง (เช่น โฆษณาตอนกลาง 1 โฆษณาตอนกลาง 2 เป็นต้น)
ตัวอย่างการใช้
mridx=2
ข้อกำหนดและคำแนะนำ
แม้ว่าพารามิเตอร์นี้ไม่จำเป็นต่อการแสดงโฆษณาสำหรับการใช้งานหรือประเภทธุรกรรมที่เจาะจง แต่ต้องใช้เพื่อกําหนดเป้าหมายโฆษณาตอนกลางที่เฉพาะเจาะจง รายงานเกี่ยวกับโฆษณาตอนกลาง และคาดการณ์เกี่ยวกับโฆษณาตอนกลาง
nofb (ไม่มีโฆษณาสำรอง)
คำอธิบาย
พารามิเตอร์ไม่มีโฆษณาสำรอง (nofb) จะยอมรับค่าคงที่เพื่อระบุว่าคำขอโฆษณาไม่ควรแสดงเพลย์ลิสต์โฆษณาวิดีโอสำรอง
ตัวอย่างการใช้
ปิดใช้โฆษณาสำรอง:
nofb=1
คุณปิดใช้โฆษณาสำรองรายการเดียวและบุฟเฟต์โฆษณาของพ็อดที่เพิ่มประสิทธิภาพได้แบบต่อคำขอโฆษณาโดยส่ง nofb=1
npa (โฆษณาที่ไม่ได้ปรับตามโปรไฟล์ของผู้ใช้)
คำอธิบาย
พารามิเตอร์โฆษณาที่ไม่ได้ปรับตามโปรไฟล์ของผู้ใช้ (npa) จะยอมรับค่าคงที่เพื่อระบุว่าควรดำเนินการกับคำขอโฆษณาในฐานะโฆษณาที่ไม่ได้ปรับตามโปรไฟล์ของผู้ใช้หรือไม่
คุณต้องตั้งค่า npa=1 หรือมีแค่ npa (โดยไม่ตั้งค่าไว้) เพื่อติดแท็กคำขอให้เป็นแบบไม่ได้ปรับตามโปรไฟล์ของผู้ใช้ คำขอโฆษณาที่ไม่มีพารามิเตอร์นี้ หรือตั้งค่าเป็น npa=0 จะมีค่าเริ่มต้นเป็นโฆษณาที่ปรับตามโปรไฟล์ของผู้ใช้
ตัวอย่างการใช้
โฆษณาที่ไม่ได้ปรับตามโปรไฟล์ของผู้ใช้:
npa=1
ข้อกำหนดและคำแนะนำ
พารามิเตอร์นี้จำเป็นเฉพาะในกรณีที่ผู้ใช้ปิดใช้การปรับตามโปรไฟล์เท่านั้น ผู้เผยแพร่โฆษณาควรตรวจสอบว่าตนแสดงสถานะของผู้ใช้อย่างถูกต้องเมื่อควบคุมสถานะ
paln (Nonce ของไลบรารีการเข้าถึงแบบเป็นโปรแกรม – เดิม)
คำอธิบาย
สำหรับการผสานรวมที่ใช้ไลบรารีการเข้าถึงแบบเป็นโปรแกรม (PAL) พารามิเตอร์ video nonce จะยอมรับค่าสตริงแบบตัวแปร
หมายเลขที่ไม่ซ้ำกันนี้ปลอดภัยสำหรับ URL คุณจึงไม่ต้องเข้ารหัส URL
หมายเหตุ: หากก่อนหน้านี้คุณระบุ Nonce โดยใช้พารามิเตอร์ paln รุ่นเดิม เราขอแนะนําอย่างยิ่งให้เปลี่ยนไปใช้พารามิเตอร์ givn และหยุดส่ง paln อย่าใส่ทั้ง 2 พารามิเตอร์
ตัวอย่างการใช้
อ่านข้อมูลเพิ่มเติมเกี่ยวกับค่าที่ส่งต่อไปยังพารามิเตอร์นี้ได้ในคู่มือการเริ่มต้นใช้งานสำหรับ PAL
ข้อกำหนดและคำแนะนำ
แม้ว่าจะไม่จำเป็นต้องใช้พารามิเตอร์นี้เพื่อแสดงโฆษณาสำหรับการใช้งานที่เจาะจง แต่เราขอแนะนําให้ใช้สำหรับการสร้างรายได้แบบเป็นโปรแกรมในเว็บ แอปบนอุปกรณ์เคลื่อนที่ ทีวีที่เชื่อมต่ออินเทอร์เน็ต เสียง และสื่อดิจิทัลนอกบ้าน
pmad (จำนวนโฆษณาสูงสุดในพ็อด)
คำอธิบาย
พารามิเตอร์จำนวนโฆษณาสูงสุดในพ็อด (pmad) จะยอมรับค่าตัวแปรซึ่งระบุจำนวนโฆษณาสูงสุดในพ็อด
พารามิเตอร์นี้จะจำกัดจำนวนโฆษณาทั้งหมดในพ็อดที่เพิ่มประสิทธิภาพ ซึ่งเป็นฟีเจอร์ที่ผู้เผยแพร่โฆษณาที่มีแพ็กเกจวิดีโอขั้นสูงใช้ได้
พารามิเตอร์นี้ไม่ควรใช้กับ VMAP (เมื่อ ad_rule=1)
ตัวอย่างการใช้
pmad=4
pmnd (ระยะเวลาขั้นต่ำของพ็อด)
คำอธิบาย
พารามิเตอร์ระยะเวลาขั้นต่ำของพ็อด (pmnd) และพารามิเตอร์ระยะเวลาสูงสุดของพ็อด (pmxd) จะยอมรับค่าตัวแปรซึ่งเมื่อใช้ร่วมกันจะระบุช่วงระยะเวลาที่ต้องตรงกับพ็อด โดยมีหน่วยเป็นมิลลิวินาที
พารามิเตอร์เหล่านี้ใช้เพื่อขอโฆษณาหลายรายการในพ็อดที่เพิ่มประสิทธิภาพ ซึ่งเป็นฟีเจอร์ที่ผู้เผยแพร่โฆษณาที่มีแพ็กเกจวิดีโอขั้นสูงใช้ได้ เมื่อใช้กฎโฆษณา Google Ad Manager จะเพิ่มข้อมูลนี้โดยอัตโนมัติ
พารามิเตอร์นี้ไม่ควรใช้กับ VMAP (เมื่อ ad_rule=1)
ตัวอย่างการใช้
pmnd=0&pmxd=60000
pmxd (ระยะเวลาสูงสุดของพ็อด)
คำอธิบาย
พารามิเตอร์ระยะเวลาขั้นต่ำของพ็อด (pmnd) และพารามิเตอร์ระยะเวลาสูงสุดของพ็อด (pmxd) จะยอมรับค่าตัวแปรซึ่งเมื่อใช้ร่วมกันจะระบุช่วงระยะเวลาที่ต้องตรงกับพ็อด โดยมีหน่วยเป็นมิลลิวินาที
พารามิเตอร์เหล่านี้ใช้เพื่อขอโฆษณาหลายรายการในพ็อดที่เพิ่มประสิทธิภาพ ซึ่งเป็นฟีเจอร์ที่ผู้เผยแพร่โฆษณาที่มีแพ็กเกจวิดีโอขั้นสูงใช้ได้ เมื่อใช้กฎโฆษณา Google Ad Manager จะเพิ่มข้อมูลนี้โดยอัตโนมัติ
พารามิเตอร์นี้ไม่ควรใช้กับ VMAP (เมื่อ ad_rule=1)
ตัวอย่างการใช้
pmnd=0&pmxd=60000
pmxfwt (เวลาในการรับชมสูงสุดที่กำหนดในพ็อด)
คำอธิบาย
พารามิเตอร์เวลาในการรับชมสูงสุดแบบบังคับของพ็อด (pmxfwt) จะยอมรับค่าตัวแปรที่ระบุระยะเวลาสูงสุดของพ็อดที่ข้ามไม่ได้ในหน่วยมิลลิวินาที
หากคุณรองรับพ็อดที่มีทั้งโฆษณาวิดีโอแบบข้ามไม่ได้และแบบข้ามได้ และต้องการกำหนดระยะเวลาโฆษณาสูงสุดที่ผู้ใช้ต้องดู ให้ใช้พารามิเตอร์นี้เพื่อกำหนดระยะเวลาของโฆษณาแบบข้ามไม่ได้สูงสุดที่ผู้ใช้ต้องดู
หมายเหตุ: พารามิเตอร์ระยะเวลาสูงสุดของพ็อด (pmxd) จะใช้ในการกําหนดระยะเวลารวมสูงสุดของพ็อดแทนพารามิเตอร์นี้ (รวมถึงระยะเวลาทั้งหมดของโฆษณาที่ข้ามได้)
ตัวอย่างการใช้งาน
pmxfwt=30000
pod (หมายเลขพ็อด)
คำอธิบาย
พารามิเตอร์หมายเลขพ็อด (pod) จะยอมรับค่าตัวแปรซึ่งแสดงถึงเลขลำดับของพ็อดในวิดีโอ (เช่น พ็อด 1 พ็อด 2 เป็นต้น)
ตัวอย่างการใช้
pod=3
ข้อกำหนดและคำแนะนำ
แม้ว่าพารามิเตอร์นี้ไม่จำเป็นต่อการแสดงโฆษณาสำหรับการติดตั้งใช้งานหรือธุรกรรมประเภทใดประเภทหนึ่ง แต่ต้องใช้เพื่ออนุญาตให้โฆษณาเดียวกันแสดงในพ็อดต่างๆ และเพื่อใช้การยกเว้นโฆษณาของคู่แข่ง การกําหนดความถี่สูงสุด และฟีเจอร์ที่เกี่ยวข้องอย่างถูกต้อง
pp (โปรไฟล์ครีเอทีฟโฆษณา)
คำอธิบาย
พารามิเตอร์โปรไฟล์ครีเอทีฟโฆษณา (pp) จะยอมรับค่าตัวแปรที่ควบคุมว่าจะให้ครีเอทีฟโฆษณาใดมีสิทธิ์แสดงโดยอิงตามการกำหนดค่าในโปรไฟล์ครีเอทีฟโฆษณาวิดีโอและเสียง
ตัวอย่างการใช้
pp=creative_profile
ข้อกำหนดและคำแนะนำ
แม้ว่าพารามิเตอร์นี้ไม่จำเป็นต่อการแสดงโฆษณาสำหรับการใช้งานที่เฉพาะเจาะจง แต่จำเป็นต่อการจำกัดไฟล์สื่อสำหรับครีเอทีฟโฆษณาที่โฮสต์โดย Google Ad Manager ที่มีโปรไฟล์ครีเอทีฟโฆษณาวิดีโอและเสียง สำหรับการเปลี่ยนเส้นทางหรือโฆษณาแบบเป็นโปรแกรม ระบบจะใช้ตัวเลือกนี้เพื่อให้แน่ใจว่ามีไฟล์ที่ตรงตามข้อกําหนด แต่จะไม่จำกัดไฟล์สื่อไว้เฉพาะไฟล์ที่เลือกไว้ในโปรไฟล์ครีเอทีฟโฆษณา
ppt (การดูแลด้านความเป็นส่วนตัวสำหรับผู้เผยแพร่โฆษณา)
คำอธิบาย
พารามิเตอร์การดูแลด้านความเป็นส่วนตัวสำหรับผู้เผยแพร่โฆษณา (ppt) จะยอมรับค่าคงที่ซึ่งใช้เพื่อระบุว่าจะปิดการปรับโฆษณาตามโปรไฟล์ของผู้ใช้สำหรับคำขอโฆษณาหรือไม่
พารามิเตอร์นี้ระบุวิธีบังคับใช้โฆษณาที่ไม่ได้ปรับตามโปรไฟล์ของผู้ใช้ ซึ่งอาจแตกต่างจาก npa=1 และ rdp=1 ซึ่งจะส่งผลต่อทั้งการจองและดีมานด์แบบเป็นโปรแกรม
ดูข้อมูลเพิ่มเติมเกี่ยวกับการดูแลด้านความเป็นส่วนตัวสำหรับผู้เผยแพร่โฆษณา
ตัวอย่างการใช้
ปิดการปรับโฆษณาตามโปรไฟล์ของผู้ใช้:
ppt=1
ppid (ตัวระบุที่ผู้เผยแพร่โฆษณามีให้)
คำอธิบาย
พารามิเตอร์ตัวระบุที่ผู้เผยแพร่โฆษณามีให้ (PPID) จะยอมรับค่าตัวแปรของตัวระบุเพื่อใช้ในการกำหนดความถี่สูงสุด การแบ่งและกำหนดกลุ่มเป้าหมาย การหมุนเวียนโฆษณาตามลำดับ และการควบคุมการแสดงโฆษณาตามกลุ่มผู้ชมแบบอื่นๆ ในทุกอุปกรณ์
ดูข้อมูลเพิ่มเติมเกี่ยวกับตัวระบุที่ได้จากผู้เผยแพร่โฆษณา
ตัวอย่างการใช้
ppid=12JD92JD8078S8J29SDOAKC0EF230337
ข้อกำหนดและคำแนะนำ
แม้ว่าจะไม่จำเป็นต้องใช้พารามิเตอร์นี้เพื่อแสดงโฆษณาสำหรับการใช้งานหรือธุรกรรมประเภทใดประเภทหนึ่ง แต่ต้องใช้ตัวระบุที่ไม่ขึ้นอยู่กับแพลตฟอร์มที่สอดคล้องกัน ซึ่งอาจใช้ในกรณีที่ไม่มีตัวระบุอื่นๆ และสามารถระบุให้ผู้ซื้อทราบได้
ppos (ตำแหน่งในพ็อด)
คำอธิบาย
พารามิเตอร์ตำแหน่งในพ็อด (ppos) จะยอมรับค่าตัวแปรซึ่งแสดงถึงตำแหน่งในพ็อด (เช่น ตำแหน่ง 1, ตำแหน่ง 2 เป็นต้น)
พารามิเตอร์นี้ใช้สำหรับพ็อดมาตรฐานเท่านั้นและจำเป็นต้องใช้สำหรับการเติมโฆษณาแสดงร่วมอัตโนมัติ เมื่อใช้กฎโฆษณา Google Ad Manager จะเพิ่มข้อมูลนี้โดยอัตโนมัติ
ตัวอย่างการใช้
ppos=2
ข้อกำหนดและคำแนะนำ
แม้ว่าจะไม่จำเป็นต้องใช้พารามิเตอร์นี้เพื่อแสดงโฆษณาสำหรับการใช้งานหรือธุรกรรมประเภทใดประเภทหนึ่ง แต่พารามิเตอร์นี้จำเป็นสำหรับพ็อดมาตรฐานเมื่อจำเป็นต้องมีการกําหนดเป้าหมายตําแหน่ง และสำหรับการคาดการณ์และการรายงานเกี่ยวกับพ็อดมาตรฐาน นอกจากนี้ คุณยังต้องใช้การยกเว้นโฆษณาของคู่แข่ง การกำหนดความถี่สูงสุด และฟีเจอร์ที่เกี่ยวข้องอย่างถูกต้องด้วย
ppsj (JSON สัญญาณที่ได้จากผู้เผยแพร่โฆษณา)
คำอธิบาย
พารามิเตอร์ JSON ของสัญญาณที่ได้จากผู้เผยแพร่โฆษณา (ppsj) จะยอมรับค่าตัวแปรซึ่งเป็นออบเจ็กต์ JSON ที่เข้ารหัส Base64 โดยมีกลุ่มเป้าหมายและข้อมูลตามบริบทที่ผู้เผยแพร่โฆษณาระบุไว้เพื่อปรับปรุงการสร้างรายได้แบบเป็นโปรแกรม
พารามิเตอร์นี้สามารถใช้เพื่อส่งสัญญาณบางอย่างไปยังผู้ซื้อ/ผู้เสนอราคา
ดูข้อมูลเพิ่มเติมเกี่ยวกับสัญญาณที่ได้จากผู้เผยแพร่โฆษณาและการจัดหมวดหมู่ที่รองรับ
ตัวอย่างการใช้
ออบเจ็กต์ JSON:
{
"PublisherProvidedTaxonomySignals": [{
"taxonomy": "IAB_AUDIENCE_1_1",
"values": ["6", "284"]
}]
}
ใช้ค่าที่เข้ารหัส Base64:
eyJQdWJsaXNoZXJQcm92aWRlZFRheG9ub215U2l
nbmFscyI6W3sidGF4b25vbXkiOiJJQUJfQVVESUVOQ0V
fMV8xIiwidmFsdWVzIjpbIjEiLCIyODQiXX1dfQ
ดูรายละเอียดคู่คีย์-ค่า JSON ที่ถูกต้องใน
ตัวอย่าง HTML5 IMA SDK
ptpl (รหัสเทมเพลตช่วงพักโฆษณา)
คำอธิบาย
พารามิเตอร์รหัสเทมเพลตช่วงพักโฆษณา (ptpl) และพารามิเตอร์ชื่อ (ptpln) จะยอมรับค่าตัวแปรซึ่งใช้เพื่อระบุว่าควรใช้เทมเพลตช่วงพักโฆษณาใดกับคำขอพ็อดที่เพิ่มประสิทธิภาพ
เทมเพลตช่วงพักโฆษณาให้คุณกำหนดค่าสปอตโฆษณาหรือสปอตโฆษณาที่กำหนดเองซึ่งควรรวมไว้ในช่วงพักโฆษณา ตลอดจนลำดับที่ควรจะแสดง
ระบบต้องการเพียงพารามิเตอร์ตัวใดตัวหนึ่งจาก 2 ตัวนี้เพื่อขอเทมเพลตช่วงพักโฆษณา
ตัวอย่างการใช้
ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีตั้งค่าและขอเทมเพลตช่วงพักโฆษณา
ข้อกำหนดและคำแนะนำ
พารามิเตอร์เหล่านี้จำเป็นเฉพาะในกรณีที่คุณขอเทมเพลตช่วงพักโฆษณาโดยตรงเท่านั้น
ptpln (ชื่อเทมเพลตช่วงพักโฆษณา)
คำอธิบาย
พารามิเตอร์รหัสเทมเพลตช่วงพักโฆษณา (ptpl) และพารามิเตอร์ชื่อ (ptpln) จะยอมรับค่าตัวแปรซึ่งใช้เพื่อระบุว่าควรใช้เทมเพลตช่วงพักโฆษณาใดกับคำขอพ็อดที่เพิ่มประสิทธิภาพ
เทมเพลตช่วงพักโฆษณาให้คุณกำหนดค่าสปอตโฆษณาหรือสปอตโฆษณาที่กำหนดเองซึ่งควรรวมไว้ในช่วงพักโฆษณา ตลอดจนลำดับที่ควรจะแสดง
ระบบต้องการเพียงพารามิเตอร์ตัวใดตัวหนึ่งจาก 2 ตัวนี้เพื่อขอเทมเพลตช่วงพักโฆษณา
ตัวอย่างการใช้
ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีตั้งค่าและขอเทมเพลตช่วงพักโฆษณา
ข้อกำหนดและคำแนะนำ
พารามิเตอร์เหล่านี้จำเป็นเฉพาะในกรณีที่คุณขอเทมเพลตช่วงพักโฆษณาโดยตรงเท่านั้น
pubf (ราคาขั้นต่ำแบบสาธารณะในแท็ก Ad Exchange)
คำอธิบาย
ราคาขั้นต่ำสาธารณะสำหรับพารามิเตอร์ Ad Exchange (pubf) และราคาขั้นต่ำส่วนตัวสำหรับพารามิเตอร์ Ad Exchange (pvtf) ยอมรับค่าตัวแปรซึ่งใช้เพื่อเพิ่มราคาขั้นต่ำลงในแท็ก Ad Exchange
พารามิเตอร์เหล่านี้เทียบเท่ากับ google_ad_public_floor และ google_ad_private_floor
ตัวอย่างการใช้
ราคาขั้นต่ำสาธารณะ:
pubf=123
ราคาขั้นต่ำส่วนตัว:
pvtf=123
ข้อกำหนดและคำแนะนำ
พารามิเตอร์เหล่านี้ใช้ได้กับผู้เผยแพร่โฆษณาในเขตเศรษฐกิจยุโรป ("EEA") หรือสวิตเซอร์แลนด์ที่ได้รับอนุมัติให้ใช้ฟีเจอร์ "ราคาขั้นต่ำ" เท่านั้น
ดูวิธีส่งคำขอ
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 ของชุดแอปและส่งพารามิเตอร์เหล่านี้ไปยังคำขอโฆษณาด้วยตนเอง
pvtf (ราคาขั้นต่ำแบบส่วนตัวในแท็ก Ad Exchange)
คำอธิบาย
ราคาขั้นต่ำสาธารณะสำหรับพารามิเตอร์ Ad Exchange (pubf) และราคาขั้นต่ำส่วนตัวสำหรับพารามิเตอร์ Ad Exchange (pvtf) ยอมรับค่าตัวแปรซึ่งใช้เพื่อเพิ่มราคาขั้นต่ำลงในแท็ก Ad Exchange
พารามิเตอร์เหล่านี้เทียบเท่ากับ google_ad_public_floor และ google_ad_private_floor
ตัวอย่างการใช้
ราคาขั้นต่ำสาธารณะ:
pubf=123
ราคาขั้นต่ำส่วนตัว:
pvtf=123
ข้อกำหนดและคำแนะนำ
พารามิเตอร์เหล่านี้ใช้ได้กับผู้เผยแพร่โฆษณาในเขตเศรษฐกิจยุโรป ("EEA") หรือสวิตเซอร์แลนด์ที่ได้รับอนุมัติให้ใช้ฟีเจอร์ "ราคาขั้นต่ำ" เท่านั้น
ดูวิธีส่งคำขอ
rdp (การประมวลผลข้อมูลแบบจำกัด)
คำอธิบาย
พารามิเตอร์จำกัดการประมวลผลข้อมูล (rdp) ยอมรับค่าคงที่เพื่อระบุว่าคำขอโฆษณาควรจำกัดการประมวลผลข้อมูลหรือไม่
คุณสามารถจำกัดการประมวลผลข้อมูลได้ที่ระดับเครือข่ายโดยเปิดใช้การตั้งค่าเครือข่ายจำกัดการประมวลผลข้อมูล
ตัวอย่างการใช้
จำกัดการประมวลผลข้อมูล:
rdp=1 หรือ rdp (โดยไม่ตั้งค่าไว้)
ไม่จำกัดการประมวลผลข้อมูล:
rdp=0
scor (สหสัมพันธ์ของสตรีม)
คำอธิบาย
พารามิเตอร์สหสัมพันธ์ของสตรีม (scor) ยอมรับค่าตัวแปรซึ่งควรเป็นเลขจำนวนเต็มที่สร้างขึ้นสำหรับสตรีมวิดีโอแต่ละรายการ
พารามิเตอร์ scor และ correlator ไม่จำเป็นต้องมีค่าจำนวนเต็มค่าเดียวกัน อย่างไรก็ตาม พารามิเตอร์ควรเก็บค่าที่เกี่ยวข้องไว้ตลอดการเล่นสตรีมวิดีโอแต่ละรายการเพื่อระบุเซสชันการดูที่ไม่ซ้ำกัน
ตัวอย่างการใช้
scor=17
ข้อกำหนดและคำแนะนำ
แม้ว่าจะไม่จำเป็นต้องใช้พารามิเตอร์นี้เพื่อแสดงโฆษณาสำหรับการติดตั้งใช้งานหรือธุรกรรมประเภทใดโดยเฉพาะ แต่ขอแนะนำให้ใช้สำหรับการแสดงโฆษณาในเว็บ แอปบนอุปกรณ์เคลื่อนที่ ทีวีที่เชื่อมต่ออินเทอร์เน็ต เสียง และสื่อนอกบ้านดิจิทัล
พารามิเตอร์นี้ใช้สำหรับการยกเว้นโฆษณาของคู่แข่ง การกำหนดความถี่สูงสุด และฟีเจอร์ที่เกี่ยวข้องเมื่อผู้ใช้ดูวิดีโอหลายรายการในหน้าเดียวกัน
sdk_apis (เฟรมเวิร์ก SDK API)
คำอธิบาย
พารามิเตอร์เฟรมเวิร์กของ SDK API (sdk_apis) ยอมรับรายการที่คั่นด้วยคอมมาของค่าจำนวนเต็มคงที่ ซึ่งระบุเฟรมเวิร์กของ API ทั้งหมดที่เพลเยอร์รองรับ
ข้อกำหนดและคำแนะนำ
การใช้งาน SDK
พารามิเตอร์นี้ใช้โดยผู้เผยแพร่โฆษณาที่ใช้ไลบรารีการเข้าถึงแบบเป็นโปรแกรม (Programmatic Access Library หรือ PAL) หากคุณพยายามตั้งค่าพารามิเตอร์นี้ขณะใช้ IMA SDK ระบบจะลบล้างค่าด้วยค่าที่ IMA SDK รองรับ
sdmax (ระยะเวลาโฆษณาสูงสุดของโฆษณาที่ข้ามได้)
คำอธิบาย
พารามิเตอร์ระยะเวลาโฆษณาสูงสุดของโฆษณาแบบข้ามได้ (sdmax) ยอมรับค่าตัวแปรที่ช่วยให้ผู้เผยแพร่โฆษณาสามารถระบุระยะเวลาโฆษณาสูงสุดที่ต้องการสำหรับโฆษณาแบบข้ามได้
ระบบจะใช้เวลาเป็นมิลลิวินาทีที่แสดงขอบเขตสูงสุดที่ควรอนุญาตให้ใช้สำหรับระยะเวลาของครีเอทีฟโฆษณาวิดีโอ/เสียงแบบข้ามได้สำหรับคำขอโฆษณาดังกล่าว
ใช้ sdmax อย่างอิสระสำหรับโฆษณาแบบข้ามได้ หรือใช้ร่วมกับพารามิเตอร์ max_ad_duration ที่มีอยู่ เพื่อระบุระยะเวลาสูงสุดที่แตกต่างกันสำหรับโฆษณาแบบข้ามได้และแบบข้ามไม่ได้
ตัวอย่างการใช้
ใช้การตั้งค่าต่อไปนี้
max_ad_duration= 15000 (15 วินาที)sdmax= 45000 (45 วินาที)
สำหรับครีเอทีฟโฆษณาต่อไปนี้
- ครีเอทีฟโฆษณา A: ข้ามไม่ได้, 30 วิ
- ครีเอทีฟโฆษณา B: ข้ามได้, 30 วิ
จะให้ผลลัพธ์ดังนี้
- ระบบจะกรองครีเอทีฟโฆษณา A เนื่องจากเป็นโฆษณาแบบข้ามไม่ได้และมีระยะเวลาเกินค่าสูงสุด (แบบข้ามไม่ได้)
- ระบบจะไม่กรองครีเอทีฟโฆษณา B เนื่องจากแม้ว่าระยะเวลาของครีเอทีฟโฆษณาจะเกิน
max_ad_durationแต่ก็เป็นแบบข้ามได้ และระยะเวลาของครีเอทีฟโฆษณาไม่เกินค่าสูงสุดสำหรับโฆษณาแบบข้ามได้
ssss (แหล่งที่มาของการต่อวิดีโอฝั่งเซิร์ฟเวอร์)
คำอธิบาย
พารามิเตอร์แหล่งที่มาของการต่อวิดีโอฝั่งเซิร์ฟเวอร์ (ssss) ยอมรับค่าคงที่ซึ่งควรตั้งเป็นค่าที่ Google ระบุและได้รับการยอมรับสำหรับผู้ให้บริการเทคโนโลยีการต่อวิดีโอที่คุณใช้
ผู้ให้บริการเทคโนโลยีการต่อวิดีโอที่ใช้การผสานรวมแบบเซิร์ฟเวอร์ต่อเซิร์ฟเวอร์กับ Google ได้รับค่านี้จาก Google และให้ข้อมูลนี้กับคุณได้ โปรดติดต่อผู้จัดการฝ่ายดูแลลูกค้าของ Google หากมีข้อสงสัยเกี่ยวกับค่าที่ควรตั้งเป็นพารามิเตอร์นี้
ตัวอย่างการใช้
ssss=mystitcher
ข้อกำหนดและคำแนะนำ
แม้ว่าจะไม่จำเป็นต้องใช้พารามิเตอร์นี้เพื่อแสดงโฆษณาสำหรับการติดตั้งใช้งานหรือประเภทธุรกรรมโดโดยเฉพาะ แต่ต้องใช้กับการติดตั้งใช้งานฝั่งเซิร์ฟเวอร์
tfcd (แท็กสำหรับการมีเด็กเป็นกลุ่มเป้าหมาย)
คำอธิบาย
พารามิเตอร์การดูแลสำหรับเนื้อหาที่มีเด็กเป็นกลุ่มเป้าหมาย (tfcd) ยอมรับค่าคงที่ซึ่งระบุว่าควรดำเนินการกับคำขอเป็นแบบเนื้อหาที่มีเด็กเป็นกลุ่มเป้าหมาย
ตัวอย่างการใช้
tfcd=1
trt (ประเภทการเข้าชม)
คำอธิบาย
พารามิเตอร์ประเภทการเข้าชม (trt) ยอมรับค่าคงที่ซึ่งทำหน้าที่ขอการเข้าชมที่ซื้อมาหรือการเข้าชมจากการค้นหาทั่วไป
ตัวอย่างการใช้
คำขอสำหรับการเข้าชมที่ซื้อมา:
trt=1
คำขอสำหรับการเข้าชมจากการค้นหาทั่วไป:
trt=2
ข้อกำหนดและคำแนะนำ
การใช้งาน SDK
IMA SDK จะไม่ป้อนค่าเริ่มต้นหากไม่มีพารามิเตอร์ประเภทการเข้าชมจากคำขอ ในกรณีเหล่านี้ เซิร์ฟเวอร์จะให้ค่าเริ่มต้นเป็น 0 (การเข้าชมที่ไม่ได้กำหนดค่า)
us_privacy (ความเป็นส่วนตัวของ IAB ในสหรัฐอเมริกา)
คำอธิบาย
IAB ได้เลิกใช้งานสตริงus_national เพื่อสนับสนุน GPP อย่างไรก็ตาม Ad Manager จะยังคงอ่านและยึดตามสตริงดังกล่าวต่อไปหากผ่านการตรวจสอบความเข้ากันได้แบบย้อนหลัง เราขอแนะนําให้ผู้เผยแพร่โฆษณาอ่าน GPP หรือการควบคุมความเป็นส่วนตัวอื่นๆ และย้ายออกจาก us_national
vad_type (ประเภทโฆษณาวิดีโอ)
คำอธิบาย
พารามิเตอร์ประเภทโฆษณาวิดีโอ (vad_type) ยอมรับค่าคงที่ซึ่งจะระบุว่าควรแสดงโฆษณาแบบเชิงเส้นหรือโฆษณาที่ไม่ใช่แบบเชิงเส้น
ตัวอย่างการใช้
แสดงโฆษณาแบบเชิงเส้น:
vad_type=linear
แสดงโฆษณาแบบไม่ใช่เชิงเส้น:
vad_type=nonlinear
vid (รหัสวิดีโอ)
คำอธิบาย
พารามิเตอร์รหัสแหล่งที่มาของเนื้อหา (cmsid) และพารามิเตอร์รหัสวิดีโอ (vid) จะยอมรับค่าตัวแปร
ในการกำหนดเป้าหมายโฆษณาไปยังเนื้อหาวิดีโอ แท็กวิดีโอหลักต้องมีพารามิเตอร์ทั้งสองรายการ
cmsidเป็นหมายเลขที่ไม่ซ้ำสำหรับแหล่งที่มาของเนื้อหาแต่ละแหล่ง หากต้องการดูหมายเลขนี้ใน Google Ad Manager ให้คลิกวิดีโอ แล้วคลิกแหล่งที่มาของเนื้อหา แล้วคลิกชื่อของแหล่งที่มาvidเป็นสตริงหรือหมายเลขที่ระบุวิดีโอที่เจาะจง รหัสนี้กำหนดโดย CMS ที่โฮสต์เนื้อหาของคุณ หากต้องการดูรหัสนี้ใน Google Ad Manager ให้คลิกวิดีโอ จากนั้นคลิกเนื้อหา แล้วคลิกเนื้อหาวิดีโอที่เจาะจง
ตัวอย่างการใช้
cmsid=[value]&vid=[value]
หากคุณกำลังสร้างแท็กสำหรับวิดีโอออนดีมานด์ที่มีการแทรกโฆษณาแบบไดนามิก คุณควรใช้มาโครที่จะแทรกแหล่งที่มาของเนื้อหาและรหัสวิดีโอที่ถูกต้องในแบบไดนามิก
ตัวอย่างเช่น: cmsid=%%CMS_ID%%&vid=%%VIDEO_ID%%
ข้อกำหนดและคำแนะนำ
แม้ว่าพารามิเตอร์เหล่านี้ไม่จำเป็นต่อการแสดงโฆษณาสำหรับการติดตั้งใช้งานหรือธุรกรรมประเภทใดประเภทหนึ่ง แต่ต้องใช้การกำหนดเป้าหมายตามเนื้อหาวิดีโอ
vpi (เพลย์ลิสต์วิดีโอในบรรทัด)
คำอธิบาย
พารามิเตอร์เพลย์ลิสต์วิดีโอในหน้า vpi ยอมรับค่าคงที่ซึ่งระบุว่าจะแสดง VMAP ในหน้า (แสดง VAST ภายใน VMAP) หรือไม่
พารามิเตอร์นี้ใช้เพื่อลดเวลาในการตอบสนอง รวมถึงรับประกันความถี่สูงสุดและการยกเว้นโฆษณาของคู่แข่งในสตรีมวิดีโอได้
ตัวอย่างการใช้
แสดง VAST:
vpi=1
แสดงการเปลี่ยนเส้นทาง:
vpi=0