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

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

ต่อไปนี้เป็นชุดย่อยของพารามิเตอร์ของ URL แท็กโฆษณา VAST พารามิเตอร์เหล่านี้ใช้สำหรับโซลูชันวิดีโอที่อิงแท็กสำหรับการทำงานแบบเป็นโปรแกรมเมื่อไม่ได้ผสานรวมกับ IMA SDK

ดูรายการพารามิเตอร์ที่จําเป็นและแนะนําสําหรับเว็บหรือพารามิเตอร์ที่จําเป็นสําหรับแอป

 ข้ามไปยังพารามิเตอร์ที่เฉพาะเจาะจงในรายการ

an description_url hl idtype is_lat

msid plcmt pp rdid sid url

vpa vpmute vpos wta

 

พารามิเตอร์	รายละเอียด
hl (ภาษา)	พารามิเตอร์ภาษาจะยอมรับค่าคงที่ซึ่งใช้สำหรับการขอโฆษณาในภาษานั้นหรือใช้สำหรับภาษาในการเลือกโฆษณาและการแสดงโฆษณาวิดีโอในการจัดสรรแบบไดนามิกให้กับวิดีโอ Ad Exchange หรือ AdSense ค่าพารามิเตอร์จะเป็นค่าใดก็ได้ที่ใช้รหัส ISO 639-1 (2 ตัวอักษร) หรือ ISO 639-2 (3 ตัวอักษร) ดูรายการรหัสที่ใช้ได้ หากไม่ใส่พารามิเตอร์นี้ ค่าเริ่มต้นจะเป็นภาษาใดก็ตามที่มีการกำหนดเป้าหมายโฆษณาตามภาษาใน Ad Exchange ตัวอย่างการใช้งาน hl=it ข้อกำหนด แนะนำสำหรับการสร้างรายได้แบบเป็นโปรแกรม
description_url (URL คำอธิบาย)	พารามิเตอร์ URL คำอธิบายจะยอมรับค่าตัวแปร ซึ่งควรอธิบายวิดีโอที่กำลังเล่นอยู่ในหน้าเว็บ โดยปกติแล้วจะเป็นหน้าเว็บที่มีวิดีโอเพลเยอร์ติดตั้งอยู่ แต่ก็อาจเป็นแค่หน้าเว็บที่มีข้อความอธิบายวิดีโอก็ได้ ค่า description_url ต้องเป็น URL ที่เข้ารหัสสำหรับวิดีโอเพลเยอร์บนหน้าเว็บและอุปกรณ์ CTV/OTT และที่ไม่เข้ารหัสสำหรับวิดีโอเพลเยอร์ในแอปบนอุปกรณ์เคลื่อนที่ IMA SDK ไม่ได้ตั้งค่าพารามิเตอร์นี้โดยอัตโนมัติ คุณจึงต้องตั้งค่าด้วยตนเอง ตัวอย่างการใช้งาน URL ที่เข้ารหัส: description_url= https%3A%2F%2Fwww.sample.com%2Fgolf.html URL ที่ไม่เข้ารหัส: description_url= https://www.sample.com/golf.html ความต้องการ ต้องใช้สำหรับเว็บ แอป และ Ad Exchange แนะนำสำหรับการสร้างรายได้แบบเป็นโปรแกรม
msid (รหัสแอป) an (ชื่อแอป)	พารามิเตอร์รหัสแอปและชื่อแอปจะยอมรับค่าตัวแปร ซึ่งควรใช้กับคำขอที่ส่งจากแอปบนอุปกรณ์เคลื่อนที่และอุปกรณ์ทีวีที่เชื่อมต่ออินเทอร์เน็ต เนื่องจากโฆษณาวิดีโอแบบเป็นโปรแกรมส่วนใหญ่จำเป็นต้องใช้พารามิเตอร์ดังกล่าว IMA SDK จะป้อนค่าพารามิเตอร์ทั้งคู่นี้ให้โดยอัตโนมัติ แต่คุณจะต้องระบุด้วยตนเองในสภาพแวดล้อมที่ไม่ใช่ SDK ซึ่งรวมถึงการเรียกใช้ VAST โดยตรง หรือเมื่อใช้ Programmatic Access Library (PAL) หรือ Publisher Authenticated Inventory (PAI) ในขณะที่ชื่อแอปควรเป็นชื่อที่มนุษย์อ่านได้ แต่ใน iOS และ tvOS นั้น SDK ไม่อาจเข้าถึงรหัสแอป ในกรณีเช่นนี้ จะไม่มีการส่งพารามิเตอร์ msid และ SDK จะส่ง App Bundle ผ่านพารามิเตอร์ an ตัวอย่างการใช้งาน msid=com.package.publisher&an=sample%20app ระบบจะตั้งชื่อและจัดรูปแบบรหัสแอป แตกต่างกันไปตาม App Store ต่างๆ ดูหลักเกณฑ์ของ IAB เกี่ยวกับการระบุแอป หรือตัวอย่างของตัวระบุที่ไม่ซ้ำกันทั่วไป สําหรับแพลตฟอร์มที่ไม่มี App Store อยู่ IAB แนะนําให้ผู้เผยแพร่โฆษณาใช้รูปแบบต่อไปนี้สําหรับรหัสร้านค้า com.publisher.deviceplatform ความต้องการ ต้องระบุพารามิเตอร์ทั้ง 2 ตัวสำหรับแอป แนะนำสำหรับการสร้างรายได้แบบเป็นโปรแกรม
plcmt (ตำแหน่งโฆษณา)	พารามิเตอร์ตำแหน่งโฆษณาจะยอมรับค่าคงที่ที่ใช้เพื่อระบุว่ามีการประกาศพื้นที่โฆษณาในสตรีมเป็นเนื้อหาในสตรีมหรือเนื้อหาประกอบตามคำแนะนำที่ระบุในข้อกำหนดของ IAB สำหรับคำขอนอกสตรีม ระบบจะป้อนข้อมูลในช่องนี้ให้กับผู้ซื้อโดยอัตโนมัติตามรูปแบบพื้นที่โฆษณาที่ประกาศ และจะลบล้างการประกาศเนื้อหาในสตรีมหรือเนื้อหาประกอบ ตัวอย่างการใช้งาน คำขอในสตรีม: plcmt=1 คำขอเนื้อหาประกอบ: plcmt=2 ความต้องการ   ต้องใช้สำหรับเว็บและการสร้างรายได้แบบเป็นโปรแกรม
pp (โปรไฟล์ครีเอทีฟโฆษณา)	พารามิเตอร์โปรไฟล์ครีเอทีฟโฆษณาจะยอมรับค่าตัวแปรที่ควบคุมว่าจะให้ครีเอทีฟโฆษณาใดมีสิทธิ์แสดงโดยอิงตามการกำหนดค่าในโปรไฟล์ครีเอทีฟโฆษณาวิดีโอและเสียง ตัวอย่างการใช้งาน pp=creative_profile ข้อกำหนด แนะนำสำหรับการสร้างรายได้แบบเป็นโปรแกรม
rdid idtype is_lat (ตัวระบุอุปกรณ์ที่รีเซ็ตได้)	ตัวระบุอุปกรณ์ที่รีเซ็ตได้จะยอมรับค่าตัวแปร สำหรับแอปพลิเคชันในตัว (ไม่ใช่ในเว็บหรือเว็บบนอุปกรณ์เคลื่อนที่) SDK จะส่งตัวระบุอุปกรณ์ที่รีเซ็ตได้สำหรับผู้ใช้ที่กำหนดเป้าหมายในคำขอสตรีมของคุณด้วยพารามิเตอร์สำหรับ rdid, idtype และ is_lat ในสตรีม SSB คุณต้องส่งพารามิเตอร์เหล่านี้มาให้ชัดเจนเหมือนที่ส่งสำหรับคำขอโฆษณาในฝั่งไคลเอ็นต์ ดูข้อมูลเพิ่มเติมเกี่ยวกับตัวระบุอุปกรณ์ สำหรับโฆษณาวิดีโอแบบเป็นโปรแกรมเกือบทั้งหมด จำเป็นต้องมีค่าเหล่านี้ Apple เลิกใช้งานสัญญาณ LAT แล้วใน iOS 14.5 เป็นต้นไป แต่ Google จะใช้ IDFA ที่มีอยู่ซึ่งไม่เป็นเลขศูนย์แทนเพื่อระบุว่าผู้ใช้ได้ยินยอมให้ติดตามในเวอร์ชัน iOS ที่รองรับความโปร่งใสในการติดตามแอป ดังนั้นต้องมี UserAgent ที่ระบุเวอร์ชันของระบบปฏิบัติการที่ถูกต้อง ตัวอย่างการใช้งาน ดูตัวอย่างโดยละเอียดของตัวระบุอุปกรณ์ที่รีเซ็ตได้ ข้อกำหนด ต้องใช้สำหรับแอป แนะนำสำหรับการสร้างรายได้แบบเป็นโปรแกรม
sid (รหัสเซสชัน)	พารามิเตอร์รหัสเซสซันจะยอมรับค่าตัวแปรซึ่งเป็นตัวระบุโฆษณาที่รักษาความเป็นส่วนตัว โดยจะใช้ได้เพื่อจุดประสงค์ในการกำหนดความถี่สูงสุดเท่านั้น รหัสเซสชันใช้ได้กับคําขอโฆษณาวิดีโอในสตรีมจากทีวีที่เชื่อมต่ออินเทอร์เน็ตและพื้นที่โฆษณาวิดีโอในสตรีมจากแอปบนอุปกรณ์เคลื่อนที่ ปัจจุบันยังไม่รองรับการใช้งานบนเว็บ ตามหลักเกณฑ์ IFA ของ IAB พารามิเตอร์นี้ต้องระบุในรูปแบบ UUID ดูข้อมูลเพิ่มเติมเกี่ยวกับตัวระบุอุปกรณ์ที่รีเซ็ตได้เพื่อการกำหนดเป้าหมายผู้ใช้ คุณเลือกไม่ใช้การส่งรหัสเซสชันได้โดยการตั้งค่า sid=0 ตัวอย่างการใช้งาน 123e4567-e89b-12d3-a456-426614174000 ข้อกำหนด แนะนำสำหรับการสร้างรายได้แบบเป็นโปรแกรม
url (URL)	พารามิเตอร์ของ URL จะยอมรับค่าตัวแปรซึ่งควรตั้งค่าเป็น URL แบบเต็มที่มีการส่งคำขอ โดยค่านี้จะช่วยให้ผู้ซื้อระบุและเข้าใจรายละเอียดแหล่งที่มาของคำขอ ระบบควรป้อนค่านี้ในคำขอโฆษณาเท่าที่ทำได้โดยอัตโนมัติ  สำหรับหน้าเว็บ นี่คือ URL ของหน้าที่แสดงโปรแกรมเล่นวิดีโอ หากคุณใช้ IMA SDK ระบบจะตั้งค่าของ URL โดยอัตโนมัติ หากโปรแกรมเล่นตั้งค่านี้ไว้ IMA SDK จะยึดตามค่าดังกล่าว ค่านี้ควรตั้งเป็น URL ที่แสดงได้อย่างถูกต้องที่สุดถึงพื้นที่โฆษณาวิดีโอหรือเสียงที่ใช้สร้างรายได้ในแอป (อุปกรณ์เคลื่อนที่หรือ CTV) เช่น หากผู้ใช้ดูวิดีโอในแอปบนอุปกรณ์เคลื่อนที่ ซึ่งก็สามารถดูบนคอมพิวเตอร์เดสก์ท็อปได้ด้วยโดยใช้ URL ที่เทียบเท่า* ค่าของพารามิเตอร์นี้ควรเข้ารหัสไว้ ตัวอย่างการใช้งาน url=https%3A%2F%2Fwww.videoad.com%2Fgolf.html * สําหรับแอป หากไม่สามารถตั้งพารามิเตอร์นี้เป็นค่า URL ตัวแปร ขอแนะนำให้ตั้งเป็นรูปแบบดังนี้ url=https%3A%2F%2F<app/bundleid>.adsenseformobileapps.com ความต้องการ ต้องใช้สำหรับเว็บและแอป แนะนำสำหรับการสร้างรายได้แบบเป็นโปรแกรม
vpa (การเล่นวิดีโออัตโนมัติ)	แนะนำตามหลักเกณฑ์การวัดผลวิดีโอของ MRC พารามิเตอร์เล่นวิดีโออัตโนมัติจะยอมรับค่าคงที่ ซึ่งระบุว่าเนื้อหาวิดีโอในโฆษณาจะเริ่มต้นผ่านการเล่นอัตโนมัติหรือการคลิก หากต้องการให้หน้าเว็บรอการดำเนินการจากผู้ใช้ ให้ตั้งเป็น click หรือหากต้องการให้เริ่มเล่นโดยอัตโนมัติ ให้ตั้งเป็น auto ควรปล่อยพารามิเตอร์นี้ไว้โดยไม่ตั้งค่าหากไม่ทราบ ตัวอย่างการใช้งาน เล่นอัตโนมัติ: vpa=auto คลิกเพื่อเล่น: vpa=click ข้อกำหนด แนะนำสำหรับการสร้างรายได้แบบเป็นโปรแกรม
vpmute (การเล่นวิดีโอแบบปิดเสียง)	แนะนำตามหลักเกณฑ์การวัดผลวิดีโอของ MRC พารามิเตอร์วิดีโอที่ปิดเสียงจะยอมรับค่าคงที่ซึ่งใช้ระบุว่าการเล่นโฆษณาจะเริ่มระหว่างที่โปรแกรมเล่นวิดีโอปิดเสียงอยู่หรือไม่ ตัวอย่างการใช้งาน ปิดเสียง vpmute=1 เปิดเสียง vpmute=0 ความต้องการ   ต้องใช้สำหรับเว็บและการสร้างรายได้แบบเป็นโปรแกรม
vpos (ตำแหน่งวิดีโอ)	พารามิเตอร์ตำแหน่งวิดีโอจะยอมรับค่าคงที่ซึ่งระบุว่าคำขอโฆษณานั้นส่งจากโฆษณาตอนต้น โฆษณาตอนกลาง หรือโฆษณาตอนท้าย ตัวอย่างการใช้งาน โฆษณาตอนต้น vpos=preroll โฆษณาตอนกลาง vpos=midroll โฆษณาตอนท้าย vpos=postroll ข้อกำหนด แนะนำสำหรับการสร้างรายได้แบบเป็นโปรแกรม
wta (ทำไมจึงแสดงโฆษณานี้)	พารามิเตอร์ "ทำไมจึงแสดงโฆษณานี้" จะยอมรับค่าคงที่ ซึ่งใช้ระบุว่าวิดีโอเพลเยอร์รองรับการแสดงข้อความ "ทำไมจึงแสดงโฆษณานี้" หรือไม่ ระบบจะรองรับฟังก์ชัน "ทำไมจึงแสดงโฆษณานี้" โดยอัตโนมัติเมื่อใช้ IMA SDK หากไม่ได้ใช้ IMA SDK วิดีโอเพลเยอร์ต้องใช้การรองรับ Icon และ IconClickFallbackImage ของ VAST ตามที่ระบุไว้ในมาตรฐาน VAST ของ IAB คำขอโฆษณาเสียงควรส่ง wta=1 หากไอคอนตัวเลือกโฆษณาอื่นๆ จะแสดงบนโฆษณาที่แสดงร่วมหรือแสดงต่อผู้ใช้ ตามที่ระบุไว้ในการตอบกลับด้วย VAST เพื่อให้มีสิทธิ์สำหรับดีมานด์จาก Google และการดูแลการแสดงโฆษณาที่มีการจองซึ่งโฮสต์โดย Google ใน EEA คำขอโฆษณาต้องส่ง wta=1 เพื่อระบุว่าไอคอนตัวเลือกโฆษณาอื่นๆ จะแสดงในโฆษณาวิดีโอ โฆษณาที่แสดงร่วม หรือแสดงต่อผู้ใช้สำหรับครีเอทีฟโฆษณาทั้งหมด ตามที่ระบุไว้ในการตอบกลับด้วย VAST ตัวอย่างการใช้งาน รองรับ wta=1 ไม่รองรับ wta=0 ข้อกำหนด ต้องใช้สำหรับ Ad Exchange ต้องใช้สำหรับการดูแลการแสดงโฆษณาใน EEA จากเว็บและแอป แนะนำสำหรับการสร้างรายได้แบบเป็นโปรแกรม