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

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

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

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

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

an description_url dth 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 คำอธิบายจะยอมรับค่าตัวแปร ซึ่งควรอธิบายวิดีโอที่กำลังเล่นอยู่ในหน้าเว็บ เขียนโครงร่างหน้าเว็บ 1-3 ย่อหน้าเพื่ออธิบายเนื้อหา ตัวอย่างเช่น ต่อเนื้อหาของหน้า description_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 แนะนำสำหรับการสร้างรายได้แบบเป็นโปรแกรม
dth (คำแนะนำประเภทอุปกรณ์)	พารามิเตอร์คำแนะนำประเภทอุปกรณ์จะยอมรับค่าคงที่ซึ่งช่วยลดการแยกประเภทอุปกรณ์ที่ไม่ถูกต้อง โดยเฉพาะในสภาพแวดล้อมทีวีที่เชื่อมต่ออินเทอร์เน็ตและกล่องรับสัญญาณ การจัดประเภทอุปกรณ์ที่ไม่ถูกต้องอาจเกิดจากข้อผิดพลาดที่ไม่คาดคิดจากผู้เผยแพร่โฆษณาหรือ OEM ของทีวีที่เชื่อมต่ออินเทอร์เน็ต ระบบจะใช้พารามิเตอร์นี้ร่วมกับสัญญาณอื่นๆ เพื่อให้ Google แจ้งอินสแตนซ์โดยอัตโนมัติที่อาจมีการจัดประเภทพื้นที่โฆษณาทีวีที่เชื่อมต่ออินเทอร์เน็ตใหม่ ตัวอย่างการใช้ คำขอจาก ฟีเจอร์โฟน: dth=1 สมาร์ทโฟน: dth=2 เดสก์ท็อป: dth=3 แท็บเล็ต: dth=4 ทีวีที่เชื่อมต่ออินเทอร์เน็ต: dth=5 คอนโซลเกม: dth=6 กล่องรับสัญญาณ: dth=7 ข้อกำหนด แนะนำสำหรับการสร้างรายได้แบบเป็นโปรแกรมบนทีวีที่เชื่อมต่ออินเทอร์เน็ต เราขอแนะนำให้ใช้พารามิเตอร์นี้สำหรับการใช้งาน PAL และ PAI (ที่ไม่ใช่ SDK) แต่ไม่จำเป็นต้องใช้สำหรับ IMA SDK หรือ DAI SDK
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 (ทำไมจึงแสดงโฆษณานี้)	การตั้งค่า "ทำไมจึงแสดงโฆษณานี้" จะยอมรับค่าคงที่ซึ่งบ่งชี้ถึงการรองรับของวิดีโอเพลเยอร์สำหรับการติดป้ายระบุว่าเป็นโฆษณา หากไม่ได้ส่งพารามิเตอร์ &wta ค่าเริ่มต้นจะเป็น &wta=1 ระบบจะรองรับฟังก์ชันการติดป้ายระบุว่าเป็นโฆษณาโดยอัตโนมัติเมื่อใช้ IMA SDK หากไม่ได้ใช้ IMA SDK วิดีโอเพลเยอร์ต้องพัฒนาการรองรับ Icon และ IconClickFallbackImage ของ VAST ตามที่ระบุไว้ในมาตรฐาน VAST ของ IAB ผู้เผยแพร่โฆษณาต้องส่ง &wta=0 หากผู้เผยแพร่โฆษณาจะไม่แสดงผลไอคอนตัวเลือกโฆษณาอื่นๆ ตามที่ระบุไว้ในการตอบกลับด้วย VAST คำขอโฆษณาที่มีพารามิเตอร์ &wta=1 หรือไม่มี &wta ได้รับการตีความว่าผู้เผยแพร่โฆษณาจะแสดงผลข้อมูลตัวเลือกโฆษณาอื่นๆ ที่ระบุ คำขอโฆษณาเสียงอาจส่ง wta=1 หากไอคอนตัวเลือกโฆษณาอื่นๆ จะแสดงบนโฆษณาที่แสดงร่วมหรือแสดงต่อผู้ใช้ ตามที่ระบุไว้ในการตอบกลับด้วย VAST สําหรับการเข้าชมจาก EEA คําขอที่มี &wta=0 จะไม่มีสิทธิ์แสดงครีเอทีฟโฆษณาแบบจองที่เปิดใช้การติดป้ายของ Google โฆษณาของคุณจะต้องเป็นไปตามข้อบังคับที่เกี่ยวข้องสำหรับโฆษณาที่แสดงในเขตเศรษฐกิจยุโรป (EEA) ซึ่งรวมถึงกลไกสำหรับผู้ใช้ในการรายงานเนื้อหาผิดกฎหมาย ผู้เผยแพร่โฆษณาต้องแจ้งให้ Google ทราบเกี่ยวกับรายงานเนื้อหาผิดกฎหมายโดยใช้แบบฟอร์มที่เหมาะสม ตัวอย่างการใช้งาน รองรับ wta=1 หรือไม่ใช้พารามิเตอร์ wta ไม่รองรับ wta=0 ข้อกำหนด ต้องใช้สำหรับ Ad Exchange ต้องใช้สำหรับการดูแลการแสดงโฆษณาใน EEA จากเว็บและแอป แนะนำสำหรับการสร้างรายได้แบบเป็นโปรแกรม