การใช้งานโซลูชันวิดีโอแบบอิงตามแท็กกับความต้องการใน Ad Exchange โดยไม่ใช้ IMA SDK นั้นเป็นการให้บริการแบบเบต้าและอาจใช้ไม่ได้กับเครือข่ายของคุณ ติดต่อขอข้อมูลเพิ่มเติมได้จากผู้จัดการฝ่ายดูแลลูกค้า
ต่อไปนี้เป็นชุดย่อยของพารามิเตอร์ของ URL แท็กโฆษณา VAST พารามิเตอร์เหล่านี้ใช้สำหรับโซลูชันวิดีโอที่อิงแท็กสำหรับการทำงานแบบเป็นโปรแกรมเมื่อไม่ได้ผสานรวมกับ IMA SDK
ดูรายการพารามิเตอร์ที่จําเป็นและแนะนําสําหรับเว็บหรือพารามิเตอร์ที่จําเป็นสําหรับแอป
ข้ามไปยังพารามิเตอร์ที่เฉพาะเจาะจงในรายการ
| พารามิเตอร์ | รายละเอียด | |
|---|---|---|
hl
(ภาษา) |
พารามิเตอร์ภาษาจะยอมรับค่าคงที่ซึ่งใช้สำหรับการขอโฆษณาในภาษานั้นหรือใช้สำหรับภาษาในการเลือกโฆษณาและการแสดงโฆษณาวิดีโอในการจัดสรรแบบไดนามิกให้กับวิดีโอ Ad Exchange หรือ AdSense ค่าพารามิเตอร์จะเป็นค่าใดก็ได้ที่ใช้รหัส ISO 639-1 (2 ตัวอักษร) หรือ ISO 639-2 (3 ตัวอักษร) ดูรายการรหัสที่ใช้ได้ หากไม่ใส่พารามิเตอร์นี้ ค่าเริ่มต้นจะเป็นภาษาใดก็ตามที่มีการกำหนดเป้าหมายโฆษณาตามภาษาใน Ad Exchange ตัวอย่างการใช้งาน
ข้อกำหนด
|
|
description_url
(URL คำอธิบาย) |
พารามิเตอร์ URL คำอธิบายจะยอมรับค่าตัวแปร ซึ่งควรอธิบายวิดีโอที่กำลังเล่นอยู่ในหน้าเว็บ เขียนโครงร่างหน้าเว็บ 1-3 ย่อหน้าเพื่ออธิบายเนื้อหา ตัวอย่างเช่น ต่อเนื้อหาของหน้า ค่า IMA SDK ไม่ได้ตั้งค่าพารามิเตอร์นี้โดยอัตโนมัติ คุณจึงต้องตั้งค่าด้วยตนเอง ตัวอย่างการใช้งานURL ที่เข้ารหัส: URL ที่ไม่เข้ารหัส: ความต้องการ
|
|
dth
(คำแนะนำประเภทอุปกรณ์) |
พารามิเตอร์คำแนะนำประเภทอุปกรณ์จะยอมรับค่าคงที่ซึ่งช่วยลดการแยกประเภทอุปกรณ์ที่ไม่ถูกต้อง โดยเฉพาะในสภาพแวดล้อมทีวีที่เชื่อมต่ออินเทอร์เน็ตและกล่องรับสัญญาณ การจัดประเภทอุปกรณ์ที่ไม่ถูกต้องอาจเกิดจากข้อผิดพลาดที่ไม่คาดคิดจากผู้เผยแพร่โฆษณาหรือ OEM ของทีวีที่เชื่อมต่ออินเทอร์เน็ต ระบบจะใช้พารามิเตอร์นี้ร่วมกับสัญญาณอื่นๆ เพื่อให้ Google แจ้งอินสแตนซ์โดยอัตโนมัติที่อาจมีการจัดประเภทพื้นที่โฆษณาทีวีที่เชื่อมต่ออินเทอร์เน็ตใหม่ ตัวอย่างการใช้คำขอจาก
ข้อกำหนด
เราขอแนะนำให้ใช้พารามิเตอร์นี้สำหรับการใช้งาน PAL และ PAI (ที่ไม่ใช่ SDK) แต่ไม่จำเป็นต้องใช้สำหรับ IMA SDK หรือ DAI SDK |
|
msid
(รหัสแอป) an
(ชื่อแอป) |
พารามิเตอร์รหัสแอปและชื่อแอปจะยอมรับค่าตัวแปร ซึ่งควรใช้กับคำขอที่ส่งจากแอปบนอุปกรณ์เคลื่อนที่และอุปกรณ์ทีวีที่เชื่อมต่ออินเทอร์เน็ต เนื่องจากโฆษณาวิดีโอแบบเป็นโปรแกรมส่วนใหญ่จำเป็นต้องใช้พารามิเตอร์ดังกล่าว IMA SDK จะป้อนค่าพารามิเตอร์ทั้งคู่นี้ให้โดยอัตโนมัติ แต่คุณจะต้องระบุด้วยตนเองในสภาพแวดล้อมที่ไม่ใช่ SDK ซึ่งรวมถึงการเรียกใช้ VAST โดยตรง หรือเมื่อใช้ Programmatic Access Library (PAL) หรือ Publisher Authenticated Inventory (PAI) ในขณะที่ชื่อแอปควรเป็นชื่อที่มนุษย์อ่านได้ แต่ใน iOS และ tvOS นั้น SDK ไม่อาจเข้าถึงรหัสแอป ในกรณีเช่นนี้ จะไม่มีการส่งพารามิเตอร์ ตัวอย่างการใช้งาน
ระบบจะตั้งชื่อและจัดรูปแบบรหัสแอป แตกต่างกันไปตาม App Store ต่างๆ ดูหลักเกณฑ์ของ IAB เกี่ยวกับการระบุแอป หรือตัวอย่างของตัวระบุที่ไม่ซ้ำกันทั่วไป สําหรับแพลตฟอร์มที่ไม่มี App Store อยู่ IAB แนะนําให้ผู้เผยแพร่โฆษณาใช้รูปแบบต่อไปนี้สําหรับรหัสร้านค้า ความต้องการ
|
|
plcmt
(ตำแหน่งโฆษณา) |
พารามิเตอร์ตำแหน่งโฆษณาจะยอมรับค่าคงที่ที่ใช้เพื่อระบุว่ามีการประกาศพื้นที่โฆษณาในสตรีมเป็นเนื้อหาในสตรีมหรือเนื้อหาประกอบตามคำแนะนำที่ระบุในข้อกำหนดของ IAB สำหรับคำขอนอกสตรีม ระบบจะป้อนข้อมูลในช่องนี้ให้กับผู้ซื้อโดยอัตโนมัติตามรูปแบบพื้นที่โฆษณาที่ประกาศ และจะลบล้างการประกาศเนื้อหาในสตรีมหรือเนื้อหาประกอบ ตัวอย่างการใช้งานคำขอในสตรีม: คำขอเนื้อหาประกอบ: ความต้องการ |
|
pp
(โปรไฟล์ครีเอทีฟโฆษณา) |
พารามิเตอร์โปรไฟล์ครีเอทีฟโฆษณาจะยอมรับค่าตัวแปรที่ควบคุมว่าจะให้ครีเอทีฟโฆษณาใดมีสิทธิ์แสดงโดยอิงตามการกำหนดค่าในโปรไฟล์ครีเอทีฟโฆษณาวิดีโอและเสียง ตัวอย่างการใช้งาน
ข้อกำหนด
|
|
rdid
(ตัวระบุอุปกรณ์ที่รีเซ็ตได้) |
ตัวระบุอุปกรณ์ที่รีเซ็ตได้จะยอมรับค่าตัวแปร สำหรับแอปพลิเคชันในตัว (ไม่ใช่ในเว็บหรือเว็บบนอุปกรณ์เคลื่อนที่) SDK จะส่งตัวระบุอุปกรณ์ที่รีเซ็ตได้สำหรับผู้ใช้ที่กำหนดเป้าหมายในคำขอสตรีมของคุณด้วยพารามิเตอร์สำหรับ สำหรับโฆษณาวิดีโอแบบเป็นโปรแกรมเกือบทั้งหมด จำเป็นต้องมีค่าเหล่านี้
ตัวอย่างการใช้งานดูตัวอย่างโดยละเอียดของตัวระบุอุปกรณ์ที่รีเซ็ตได้ ข้อกำหนด
|
|
sid
(รหัสเซสชัน) |
พารามิเตอร์รหัสเซสซันจะยอมรับค่าตัวแปรซึ่งเป็นตัวระบุโฆษณาที่รักษาความเป็นส่วนตัว โดยจะใช้ได้เพื่อจุดประสงค์ในการกำหนดความถี่สูงสุดเท่านั้น รหัสเซสชันใช้ได้กับคําขอโฆษณาวิดีโอในสตรีมจากทีวีที่เชื่อมต่ออินเทอร์เน็ตและพื้นที่โฆษณาวิดีโอในสตรีมจากแอปบนอุปกรณ์เคลื่อนที่ ปัจจุบันยังไม่รองรับการใช้งานบนเว็บ ตามหลักเกณฑ์ IFA ของ IAB พารามิเตอร์นี้ต้องระบุในรูปแบบ UUID ดูข้อมูลเพิ่มเติมเกี่ยวกับตัวระบุอุปกรณ์ที่รีเซ็ตได้เพื่อการกำหนดเป้าหมายผู้ใช้ คุณเลือกไม่ใช้การส่งรหัสเซสชันได้โดยการตั้งค่า ตัวอย่างการใช้งาน
ข้อกำหนด
|
|
url
(URL) |
พารามิเตอร์ของ URL จะยอมรับค่าตัวแปรซึ่งควรตั้งค่าเป็น URL แบบเต็มที่มีการส่งคำขอ โดยค่านี้จะช่วยให้ผู้ซื้อระบุและเข้าใจรายละเอียดแหล่งที่มาของคำขอ ระบบควรป้อนค่านี้ในคำขอโฆษณาเท่าที่ทำได้โดยอัตโนมัติ สำหรับหน้าเว็บ นี่คือ URL ของหน้าที่แสดงโปรแกรมเล่นวิดีโอ หากคุณใช้ IMA SDK ระบบจะตั้งค่าของ URL โดยอัตโนมัติ หากโปรแกรมเล่นตั้งค่านี้ไว้ IMA SDK จะยึดตามค่าดังกล่าว ค่านี้ควรตั้งเป็น URL ที่แสดงได้อย่างถูกต้องที่สุดถึงพื้นที่โฆษณาวิดีโอหรือเสียงที่ใช้สร้างรายได้ในแอป (อุปกรณ์เคลื่อนที่หรือ CTV) เช่น หากผู้ใช้ดูวิดีโอในแอปบนอุปกรณ์เคลื่อนที่ ซึ่งก็สามารถดูบนคอมพิวเตอร์เดสก์ท็อปได้ด้วยโดยใช้ URL ที่เทียบเท่า* ค่าของพารามิเตอร์นี้ควรเข้ารหัสไว้ ตัวอย่างการใช้งาน
* สําหรับแอป หากไม่สามารถตั้งพารามิเตอร์นี้เป็นค่า URL ตัวแปร ขอแนะนำให้ตั้งเป็นรูปแบบดังนี้ ความต้องการ
|
|
vpa
(การเล่นวิดีโออัตโนมัติ) |
แนะนำตามหลักเกณฑ์การวัดผลวิดีโอของ MRC พารามิเตอร์เล่นวิดีโออัตโนมัติจะยอมรับค่าคงที่ ซึ่งระบุว่าเนื้อหาวิดีโอในโฆษณาจะเริ่มต้นผ่านการเล่นอัตโนมัติหรือการคลิก หากต้องการให้หน้าเว็บรอการดำเนินการจากผู้ใช้ ให้ตั้งเป็น ควรปล่อยพารามิเตอร์นี้ไว้โดยไม่ตั้งค่าหากไม่ทราบ ตัวอย่างการใช้งานเล่นอัตโนมัติ: คลิกเพื่อเล่น: ข้อกำหนด
|
|
vpmute
(การเล่นวิดีโอแบบปิดเสียง) |
แนะนำตามหลักเกณฑ์การวัดผลวิดีโอของ MRC พารามิเตอร์วิดีโอที่ปิดเสียงจะยอมรับค่าคงที่ซึ่งใช้ระบุว่าการเล่นโฆษณาจะเริ่มระหว่างที่โปรแกรมเล่นวิดีโอปิดเสียงอยู่หรือไม่ ตัวอย่างการใช้งานปิดเสียง เปิดเสียง ความต้องการ |
|
vpos
(ตำแหน่งวิดีโอ) |
พารามิเตอร์ตำแหน่งวิดีโอจะยอมรับค่าคงที่ซึ่งระบุว่าคำขอโฆษณานั้นส่งจากโฆษณาตอนต้น โฆษณาตอนกลาง หรือโฆษณาตอนท้าย ตัวอย่างการใช้งานโฆษณาตอนต้น โฆษณาตอนกลาง โฆษณาตอนท้าย ข้อกำหนด
|
|
wta
(ทำไมจึงแสดงโฆษณานี้) |
การตั้งค่า "ทำไมจึงแสดงโฆษณานี้" จะยอมรับค่าคงที่ซึ่งบ่งชี้ถึงการรองรับของวิดีโอเพลเยอร์สำหรับการติดป้ายระบุว่าเป็นโฆษณา หากไม่ได้ส่งพารามิเตอร์ ระบบจะรองรับฟังก์ชันการติดป้ายระบุว่าเป็นโฆษณาโดยอัตโนมัติเมื่อใช้ IMA SDK หากไม่ได้ใช้ IMA SDK วิดีโอเพลเยอร์ต้องพัฒนาการรองรับ ผู้เผยแพร่โฆษณาต้องส่ง คำขอโฆษณาเสียงอาจส่ง สําหรับการเข้าชมจาก EEA คําขอที่มี โฆษณาของคุณจะต้องเป็นไปตามข้อบังคับที่เกี่ยวข้องสำหรับโฆษณาที่แสดงในเขตเศรษฐกิจยุโรป (EEA) ซึ่งรวมถึงกลไกสำหรับผู้ใช้ในการรายงานเนื้อหาผิดกฎหมาย ผู้เผยแพร่โฆษณาต้องแจ้งให้ Google ทราบเกี่ยวกับรายงานเนื้อหาผิดกฎหมายโดยใช้แบบฟอร์มที่เหมาะสม ตัวอย่างการใช้งานรองรับ
ไม่รองรับ ข้อกำหนด
|
