บทความนี้แสดงรายการพารามิเตอร์ที่จําเป็นและแนะนําสําหรับแท็กโฆษณา VAST ที่ใช้แสดงโฆษณาในการติดตั้งใช้งานสื่อดิจิทัลนอกบ้าน
ในหน้านี้
- พารามิเตอร์ที่จำเป็นสำหรับการแสดงโฆษณา
- พารามิเตอร์ที่จำเป็นสำหรับรายการแบบเป็นโปรแกรม
- พารามิเตอร์ที่แนะนำสำหรับรายการแบบเป็นโปรแกรม
พารามิเตอร์ที่จำเป็นและแนะนำสำหรับสื่อดิจิทัลนอกบ้าน
พารามิเตอร์ที่จำเป็นสำหรับการแสดงโฆษณา
correlator (สหสัมพันธ์)
คำอธิบาย
พารามิเตอร์สหสัมพันธ์ (correlator) จะยอมรับค่าตัวแปรซึ่งใช้ร่วมกันระหว่างคำขอหลายรายการที่มาจากการดูหน้าเว็บครั้งเดียวกัน พารามิเตอร์นี้ใช้เพื่อยกเว้นโฆษณาของคู่แข่ง ซึ่งรวมถึงในสภาพแวดล้อมที่ไม่มีคุกกี้
ตัวอย่างการใช้
correlator=4345645667
ข้อกำหนดและคำแนะนำ
พารามิเตอร์นี้จำเป็นสำหรับการใช้การแสดงโฆษณาในเว็บ แอปบนอุปกรณ์เคลื่อนที่ ทีวีที่เชื่อมต่ออินเทอร์เน็ต เสียง และสื่อดิจิทัลนอกบ้าน
การใช้งาน SDK
- ถ้ามีการใช้ IMA SDK ก็จะมีการตั้งค่าสหสัมพันธ์โดยอัตโนมัติ หากโปรแกรมเล่นพยายามตั้งค่านี้ SDK จะเขียนทับค่านี้ด้วยค่าของตัวเอง
- หากไม่ได้ใช้ IMA SDK ให้ตรวจสอบว่าคุณตั้งค่านี้เป็นจำนวนบวกแบบสุ่มที่แท้จริง ซึ่งไม่ถูกใช้ซ้ำโดยการดูหน้าเว็บหลายๆ ครั้ง
env (สภาพแวดล้อม)
คำอธิบาย
พารามิเตอร์สภาพแวดล้อม (env) จะยอมรับค่าคงที่ที่ระบุคำขอในสตรีม หรือระบุว่าคำขอมาจากวิดีโอเพลเยอร์โดยเฉพาะ
ค่าที่เป็นไปได้คือ instream ซึ่งใช้สำหรับโฆษณาวิดีโอและโฆษณาเสียง หรือ vp ซึ่งใช้ได้กับโฆษณาวิดีโอเท่านั้น
ตัวอย่างการใช้
วิดีโอและ/หรือเสียง:
env=instream
วิดีโอเท่านั้น:
env=vp
ข้อกำหนดและคำแนะนำ
พารามิเตอร์นี้จำเป็นสำหรับการใช้การแสดงโฆษณาในเว็บ แอปบนอุปกรณ์เคลื่อนที่ ทีวีที่เชื่อมต่ออินเทอร์เน็ต เสียง และสื่อดิจิทัลนอกบ้าน
พารามิเตอร์นี้จำเป็นสำหรับการรายงานประเภทคำขออย่างถูกต้องโดยแยกตาม "แท็กวิดีโอ"
gdfp_req (ตัวบ่งชี้สคีมา)
คำอธิบาย
พารามิเตอร์ตัวระบุสคีมา Google Ad Manager (gdfp_req) จะยอมรับค่าคงที่ซึ่งระบุว่าคำขอโฆษณามีไว้สำหรับพื้นที่โฆษณา Google Ad Manager
ตัวอย่างการใช้
gdfp_req=1
ข้อกำหนดและคำแนะนำ
พารามิเตอร์นี้จำเป็นสำหรับการใช้การแสดงโฆษณาในเว็บ แอปบนอุปกรณ์เคลื่อนที่ ทีวีที่เชื่อมต่ออินเทอร์เน็ต เสียง และสื่อดิจิทัลนอกบ้าน
iu (หน่วยโฆษณา)
คำอธิบาย
พารามิเตอร์หน่วยโฆษณา (iu) จะยอมรับค่าตัวแปรซึ่งควรตั้งค่าเป็นหน่วยโฆษณาปัจจุบันในรูปแบบ /network_code/.../ad_unit
ตัวอย่างการใช้
iu=/6062/videodemo
ข้อกำหนดและคำแนะนำ
พารามิเตอร์นี้จำเป็นสำหรับการใช้การแสดงโฆษณาในเว็บ แอปบนอุปกรณ์เคลื่อนที่ ทีวีที่เชื่อมต่ออินเทอร์เน็ต เสียง และสื่อดิจิทัลนอกบ้าน
output (เอาต์พุต)
คำอธิบาย
พารามิเตอร์รูปแบบเอาต์พุต (output) จะยอมรับค่าคงที่ซึ่งควรตั้งค่าเป็นรูปแบบเอาต์พุตของโฆษณา
ตัวอย่างการใช้
ใช้เวอร์ชัน VAST เริ่มต้นของเครือข่าย
output=vast
ใช้ VAST 4 (คุณตั้งค่าเวอร์ชันที่เจาะจงสำหรับแท็กที่เฉพาะเจาะจงได้)
output=xml_vast4
ใช้การตั้งค่า VMAP เริ่มต้นของเครือข่าย
output=vmap
ใช้ VMAP 1
output=xml_vmap1
ใช้ VMAP 1 ที่แสดง VAST 4 (หากคุณแสดง VAST ใน VMAP)
output=xml_vmap1_vast4
ข้อกำหนดและคำแนะนำ
พารามิเตอร์นี้จำเป็นสำหรับการใช้การแสดงโฆษณาในเว็บ แอปบนอุปกรณ์เคลื่อนที่ ทีวีที่เชื่อมต่ออินเทอร์เน็ต เสียง และสื่อดิจิทัลนอกบ้าน คุณต้องแสดงผลรูปแบบการตอบสนองการแสดงโฆษณาที่ถูกต้อง
การใช้งาน SDK
สำหรับ VAST หากวิดีโอเพลเยอร์ใช้ IMA SDK พารามิเตอร์เอาต์พุตสำหรับคำขอโฆษณาวิดีโอจะตั้งค่าเป็น output=xml_vast4 เสมอ ซึ่งไม่ก่อให้เกิดความเสี่ยงด้านความน่าเชื่อถือ เนื่องจาก SDK ดังกล่าวใช้งานย้อนหลังได้กับ VAST ทุกเวอร์ชันที่เซิร์ฟเวอร์โฆษณาบุคคลที่สามอาจจะแสดง
sz (ขนาด)
คำอธิบาย
พารามิเตอร์ขนาด (sz) ยอมรับค่าตัวแปร ซึ่งควรตั้งค่าเป็นขนาดของช่องโฆษณาวิดีโอหลัก
หากมีหลายขนาด ควรคั่นด้วยเครื่องหมายไปป์ (|)
อย่าใส่ "v" หลังขนาด
ตัวอย่างการใช้
ขนาดเดียว:sz=400x300
หลายขนาด:sz=300x250|400x300
ข้อกำหนดและคำแนะนำ
พารามิเตอร์นี้จำเป็นสำหรับการใช้การแสดงโฆษณาในเว็บ แอปบนอุปกรณ์เคลื่อนที่ ทีวีที่เชื่อมต่ออินเทอร์เน็ต และสื่อดิจิทัลนอกบ้าน
ไม่บังคับให้ใช้พารามิเตอร์นี้ถ้าขอเพียง ad_type=audio
url (URL)
คำอธิบาย
พารามิเตอร์ของ URL (url) ยอมรับค่าตัวแปรซึ่งควรตั้งค่าเป็น URL แบบเต็มที่มีการส่งคำขอ โดยค่านี้จะช่วยให้ผู้ซื้อระบุและเข้าใจรายละเอียดแหล่งที่มาของคำขอ ระบบควรป้อนค่านี้ในคำขอโฆษณาเท่าที่ทำได้โดยอัตโนมัติ
- สำหรับเว็บ นี่คือ URL ของหน้าที่แสดงวิดีโอเพลเยอร์
- ในสภาพแวดล้อมที่ไม่ใช่เว็บ ค่านี้ควรตั้งเป็น URL ที่นำเสนอได้อย่างถูกต้องที่สุดถึงพื้นที่โฆษณาวิดีโอหรือเสียงที่ใช้สร้างรายได้ เช่น หากผู้ใช้ดูวิดีโอในแอปบนอุปกรณ์เคลื่อนที่ ซึ่งก็สามารถดูบนคอมพิวเตอร์เดสก์ท็อปได้ด้วยโดยใช้ URL ที่เทียบเท่า*
หมายเหตุ: url แตกต่างจาก description_url ตรงที่ url หมายถึงตำแหน่งที่ส่งคำขอโฆษณา ส่วน description_url คือหน้าเว็บที่ทำการ Crawl ได้ซึ่งอธิบายเนื้อหาวิดีโอ
ค่าของพารามิเตอร์นี้ควรเข้ารหัสไว้
ตัวอย่างการใช้
url=https%3A%2F%2Fexample.com%2Fvideo.html
* สำหรับแอป หากไม่สามารถตั้งพารามิเตอร์นี้เป็นค่า URL ตัวแปร ขอแนะนำให้ใช้รูปแบบต่อไปนี้ url=https%3A%2F%2F<app/bundleid>.example.com
ข้อกำหนดและคำแนะนำ
พารามิเตอร์นี้จำเป็นเฉพาะสำหรับการสร้างรายได้แบบเป็นโปรแกรมในเว็บ แอปบนอุปกรณ์เคลื่อนที่ ทีวีที่เชื่อมต่ออินเทอร์เน็ต เสียง และสื่อดิจิทัลนอกบ้าน
การใช้งาน SDK
หากคุณใช้ IMA SDK ระบบจะตั้งค่าของ URL โดยอัตโนมัติ หากเพลเยอร์ตั้งค่านี้ไว้ IMA SDK จะยึดตามค่าดังกล่าว
vpmute (การเล่นวิดีโอแบบปิดเสียง)
คำอธิบาย
พารามิเตอร์ปิดเสียงการเล่นวิดีโอ (vpmute) จะยอมรับค่าคงที่ซึ่งระบุว่าการเล่นโฆษณาจะเริ่มระหว่างที่วิดีโอเพลเยอร์ปิดเสียงอยู่หรือไม่ พารามิเตอร์นี้จะไม่เปลี่ยนสถานะของวิดีโอเพลเยอร์ โดยวิดีโอเพลเยอร์ต้องจัดการลักษณะการเล่นโดยตรง
ตัวอย่างการใช้
เริ่มเล่นโดยปิดเสียง:
vpmute=1
เริ่มเล่นโดยเปิดเสียง
vpmute=0
ข้อกำหนดและคำแนะนำ
พารามิเตอร์นี้จำเป็นสำหรับการสร้างรายได้แบบเป็นโปรแกรมในเว็บ แอปบนอุปกรณ์เคลื่อนที่ ทีวีที่เชื่อมต่ออินเทอร์เน็ต เสียง และสื่อนอกบ้านดิจิทัล
นอกจากนี้ เรายังแนะนำให้ใช้พารามิเตอร์นี้ตามหลักเกณฑ์การวัดผลวิดีโอของ Media Rating Council (MRC) ด้วย
พารามิเตอร์ที่จำเป็นสำหรับรายการแบบเป็นโปรแกรม
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
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
plcmt (ตำแหน่งโฆษณา)
คำอธิบาย
พารามิเตอร์ตำแหน่งโฆษณา (plcmt) จะยอมรับค่าคงที่ที่ใช้เพื่อระบุว่ามีการประกาศพื้นที่โฆษณาในสตรีมเป็น "ในสตรีม" หรือ "ประกอบ" ตามคำแนะนำที่ระบุในข้อกำหนดของ IAB
สำหรับคำขอนอกสตรีม ระบบจะป้อนข้อมูลในช่องนี้ให้กับผู้ซื้อโดยอัตโนมัติตามรูปแบบพื้นที่โฆษณาที่ประกาศ ซึ่งจะลบล้างการประกาศในสตรีมหรือประกาศประกอบ
ตัวอย่างการใช้
คำขอในสตรีม:
plcmt=1
คำขอเนื้อหาประกอบ:
plcmt=2
ข้อกำหนดและคำแนะนำ
พารามิเตอร์นี้จำเป็นสำหรับการสร้างรายได้แบบเป็นโปรแกรมในเว็บ แอปบนอุปกรณ์เคลื่อนที่ ทีวีที่เชื่อมต่ออินเทอร์เน็ต เสียง และสื่อดิจิทัลนอกบ้าน
rdid (ตัวระบุอุปกรณ์ที่รีเซ็ตได้)
คำอธิบาย
พารามิเตอร์ตัวระบุอุปกรณ์ที่รีเซ็ตได้ (rdid, idtype, is_lat) ยอมรับค่าตัวแปร ค่านี้เรียกอีกอย่างว่าตัวระบุสำหรับการโฆษณา (IFA)
สำหรับแอปพลิเคชันบนอุปกรณ์เคลื่อนที่ที่ใช้ IMA SDK สำหรับ Android หรือ iOS นั้น IMA SDK จะส่งตัวระบุอุปกรณ์ที่รีเซ็ตได้สำหรับการกําหนดเป้าหมายผู้ใช้ไปยังคําขอสตรีมของคุณด้วยพารามิเตอร์สำหรับ rdid, idtype และ is_lat
เมื่อไม่ได้ใช้ IMA SDK หรือเมื่อใช้บีคอนฝั่งเซิร์ฟเวอร์ (SSB) คุณต้องส่งพารามิเตอร์เหล่านี้เป็นพารามิเตอร์ที่ชัดแจ้ง ดูข้อมูลเพิ่มเติมเกี่ยวกับตัวระบุอุปกรณ์
สำหรับโฆษณาวิดีโอแบบเป็นโปรแกรมเกือบทั้งหมด จำเป็นต้องมีค่าเหล่านี้
|
Apple เลิกใช้งานสัญญาณ |
ตัวอย่างการใช้
ดูตัวอย่างโดยละเอียดของตัวระบุอุปกรณ์ที่รีเซ็ตได้
ข้อกำหนดและคำแนะนำ
แม้ว่าจะไม่จำเป็นต้องใช้พารามิเตอร์เหล่านี้เพื่อแสดงโฆษณาสำหรับการติดตั้งใช้งานใดโดยเฉพาะ แต่ต้องใช้ในการสร้างรายได้แบบเป็นโปรแกรมในแอปบนอุปกรณ์เคลื่อนที่ ทีวีที่เชื่อมต่ออินเทอร์เน็ต เสียง และสื่อนอกบ้านดิจิทัล
สำหรับการติดตั้งใช้งานบนเว็บ ระบบจะไม่ใช้ตัวระบุอุปกรณ์ที่รีเซ็ตได้
การใช้งาน SDK
ขณะที่ IMA SDK ส่งฟิลด์นี้โดยอัตโนมัติ ผู้เผยแพร่โฆษณาจะส่งพารามิเตอร์เหล่านี้ด้วยตนเองโดยใช้ PAL SDK
sid (รหัสเซสชัน)
คำอธิบาย
พารามิเตอร์รหัสเซสซัน (sid) ยอมรับค่าตัวแปรซึ่งเป็นตัวระบุโฆษณาที่รักษาความเป็นส่วนตัว โดยจะใช้ได้เพื่อจุดประสงค์ในการกำหนดความถี่สูงสุดเท่านั้น
รหัสเซสชันใช้ได้กับคําขอโฆษณาวิดีโอในสตรีมจากทีวีที่เชื่อมต่ออินเทอร์เน็ตและพื้นที่โฆษณาวิดีโอในสตรีมจากแอปบนอุปกรณ์เคลื่อนที่ ปัจจุบันยังไม่รองรับการใช้งานบนเว็บ
คุณเลือกไม่ใช้การส่งรหัสเซสชันได้โดยการตั้งค่า sid=0
ตัวอย่างการใช้
sid=123e4567-e89b-12d3-a456-426614174000
ตามหลักเกณฑ์ IFA ของ IAB พารามิเตอร์นี้ต้องระบุในรูปแบบ UUID ดูข้อมูลเพิ่มเติมเกี่ยวกับตัวระบุอุปกรณ์ที่รีเซ็ตได้เพื่อการกำหนดเป้าหมายผู้ใช้
ข้อกำหนดและคำแนะนำ
แม้ว่าจะไม่จำเป็นต้องใช้พารามิเตอร์นี้เพื่อแสดงโฆษณาสำหรับการติดตั้งใช้งานใดโดยเฉพาะ แต่ต้องใช้สำหรับการสร้างรายได้แบบเป็นโปรแกรมในสื่อดิจิทัลนอกบ้าน
เราขอแนะนำให้ใช้พารามิเตอร์นี้สำหรับการสร้างรายได้แบบเป็นโปรแกรมในแอปบนอุปกรณ์เคลื่อนที่ ทีวีที่เชื่อมต่ออินเทอร์เน็ต และเสียง
การใช้งาน SDK
IMA SDK จะส่งพารามิเตอร์นี้โดยอัตโนมัติ
venuetype (ประเภทสถานที่)
คำอธิบาย
พารามิเตอร์ประเภทสถานที่ (venuetype) ใช้เพื่อระบุประเภทสถานที่ตั้งนอกบ้าน ค่าที่มีสิทธิ์คือรหัสเลขจำนวนเต็มสำหรับการแจกแจงซึ่งการจัดหมวดหมู่เวอร์ชัน 1.1 สำหรับประเภทสถานที่ตั้ง OpenOOH ของ IAB รองรับ
ตัวอย่างการใช้
ห้องพักโรงแรม:
venuetype=80703
แท็บเล็ตในเบาะหลังของแท็กซี่:
venuetype=103
พารามิเตอร์ที่แนะนำสำหรับรายการแบบเป็นโปรแกรม
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 เพราะตั้งค่าไว้โดยอัตโนมัติ
