บทความนี้แสดงรายการพารามิเตอร์ทั้งหมดที่ใช้ได้ในแท็กโฆษณา 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
ข้อกำหนดและคำแนะนำ
พารามิเตอร์นี้จำเป็นสำหรับการใช้การแสดงโฆษณาในเว็บและแอปบนอุปกรณ์เคลื่อนที่เมื่อมีโอกาสในการแสดงผลที่ล่าช้า
vpmute (การเล่นวิดีโอแบบปิดเสียง)
คำอธิบาย
พารามิเตอร์ปิดเสียงการเล่นวิดีโอ (vpmute) จะยอมรับค่าคงที่ซึ่งระบุว่าการเล่นโฆษณาจะเริ่มระหว่างที่วิดีโอเพลเยอร์ปิดเสียงอยู่หรือไม่ พารามิเตอร์นี้จะไม่เปลี่ยนสถานะของวิดีโอเพลเยอร์ โดยวิดีโอเพลเยอร์ต้องจัดการลักษณะการเล่นโดยตรง
ตัวอย่างการใช้
เริ่มเล่นโดยปิดเสียง:
vpmute=1
เริ่มเล่นโดยเปิดเสียง
vpmute=0
ข้อกำหนดและคำแนะนำ
พารามิเตอร์นี้จำเป็นสำหรับการสร้างรายได้แบบเป็นโปรแกรมในเว็บ แอปบนอุปกรณ์เคลื่อนที่ ทีวีที่เชื่อมต่ออินเทอร์เน็ต เสียง และสื่อนอกบ้านดิจิทัล
นอกจากนี้ เรายังแนะนำให้ใช้พารามิเตอร์นี้ตามหลักเกณฑ์การวัดผลวิดีโอของ Media Rating Council (MRC) ด้วย
พารามิเตอร์ที่จำเป็นสำหรับรายการแบบเป็นโปรแกรม
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
ข้อกำหนดและคำแนะนำ
พารามิเตอร์นี้จำเป็นสำหรับการสร้างรายได้แบบเป็นโปรแกรมในเว็บ แอปบนอุปกรณ์เคลื่อนที่ ทีวีที่เชื่อมต่ออินเทอร์เน็ต เสียง และสื่อดิจิทัลนอกบ้าน
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 จะยึดตามค่าดังกล่าว
venuetype (ประเภทสถานที่)
คำอธิบาย
พารามิเตอร์ประเภทสถานที่ (venuetype) ใช้เพื่อระบุประเภทสถานที่ตั้งนอกบ้าน ค่าที่มีสิทธิ์คือรหัสเลขจำนวนเต็มสำหรับการแจกแจงซึ่งการจัดหมวดหมู่เวอร์ชัน 1.1 สำหรับประเภทสถานที่ตั้ง OpenOOH ของ IAB รองรับ
ตัวอย่างการใช้
ห้องพักโรงแรม:
venuetype=80703
แท็บเล็ตในเบาะหลังของแท็กซี่:
venuetype=103
vpa (การเล่นวิดีโออัตโนมัติ)
คำอธิบาย
พารามิเตอร์เล่นวิดีโออัตโนมัติ vpa ยอมรับค่าคงที่ซึ่งระบุว่าเนื้อหาวิดีโอในโฆษณาจะเริ่มต้นผ่านการเล่นอัตโนมัติหรือการคลิก
หากต้องการให้หน้าเว็บรอการดำเนินการจากผู้ใช้ ให้ตั้งเป็น click หรือหากต้องการให้เริ่มเล่นโดยอัตโนมัติ ให้ตั้งเป็น auto พารามิเตอร์นี้จะไม่เปลี่ยนสถานะของวิดีโอเพลเยอร์ โดยวิดีโอเพลเยอร์ต้องจัดการลักษณะการเล่นโดยตรง
ตัวอย่างการใช้
เล่นอัตโนมัติ:
vpa=auto
คลิกเพื่อเล่น:
vpa=click
หากไม่ทราบ ให้ปล่อยพารามิเตอร์นี้ไว้โดยไม่ต้องตั้งค่า
ข้อกำหนดและคำแนะนำ
พารามิเตอร์นี้จำเป็นสำหรับการสร้างรายได้แบบเป็นโปรแกรมในเว็บ แอปบนอุปกรณ์เคลื่อนที่ ทีวีที่เชื่อมต่ออินเทอร์เน็ต และเสียง
นอกจากนี้ เรายังแนะนำให้ใช้พารามิเตอร์นี้ตามหลักเกณฑ์การวัดผลวิดีโอของ 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) จะยอมรับค่าคงที่ซึ่งใช้ระบุว่าจะแสดงโฆษณาในแบบจำกัดหรือไม่ ในกรณีที่ไม่ได้รับคำยินยอมให้ใช้คุกกี้หรือตัวระบุอื่นๆ ในเครื่อง
พารามิเตอร์นี้ใช้เพื่อระบุคำขอโฆษณาแบบจำกัด และแตกต่างจากพารามิเตอร์ is_lat ซึ่งจะปิดใช้การปรับตามโปรไฟล์ของผู้ใช้และการใช้ตัวระบุเพื่อวัตถุประสงค์ดังกล่าว
ltd=1 ต่างจากพารามิเตอร์ของ URL อื่นๆ ตรงที่จะเปลี่ยนลักษณะการทํางานของ IMA SDK ให้ถือว่าคำขอไม่มีรหัสและไม่อนุญาตให้ใช้พื้นที่เก็บข้อมูลตัวอย่างการใช้
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
การใช้งาน 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
การใช้งาน 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
