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

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

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

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

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

an correlator description_url env gdfp_req idtype

is_lat iu msid output pvid pvid_s

rdid sz unviewed_position_start url wta

 

พารามิเตอร์	รายละเอียด
correlator (สหสัมพันธ์)	พารามิเตอร์สหสัมพันธ์จะยอมรับค่าตัวแปรซึ่งใช้ร่วมกันระหว่างคำขอหลายรายการที่มาจากการดูหน้าเว็บครั้งเดียวกัน พารามิเตอร์นี้ใช้เพื่อยกเว้นโฆษณาของคู่แข่ง ซึ่งรวมถึงในสภาพแวดล้อมที่ไม่มีคุกกี้ ถ้ามีการใช้ IMA SDK ก็จะมีการตั้งค่าสหสัมพันธ์โดยอัตโนมัติ หากโปรแกรมเล่นพยายามตั้งค่านี้ SDK จะเขียนทับค่านี้ด้วยค่าของตัวเอง หากไม่ได้ใช้ IMA SDK ให้ตรวจสอบว่าคุณตั้งค่านี้เป็นจำนวนบวกแบบสุ่มที่แท้จริง ซึ่งไม่ถูกใช้ซ้ำโดยการดูหน้าเว็บหลายๆ ครั้ง ตัวอย่างการใช้งาน correlator=4345645667 ข้อกำหนด ต้องใช้สำหรับเว็บและแอป แนะนำสำหรับการสร้างรายได้แบบเป็นโปรแกรม
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 แนะนำสำหรับการสร้างรายได้แบบเป็นโปรแกรม
env (สภาพแวดล้อม)	พารามิเตอร์สภาพแวดล้อมจะยอมรับค่าคงที่ที่ระบุคำขอในสตรีม หรือระบุว่าคำขอมาจากวิดีโอเพลเยอร์โดยเฉพาะ ค่าที่เป็นไปได้คือ instream ซึ่งใช้สำหรับโฆษณาวิดีโอและโฆษณาเสียง หรือ vp ซึ่งใช้ได้กับโฆษณาวิดีโอเท่านั้น ตัวอย่างการใช้งาน วิดีโอและ/หรือเสียง: env=instream วิดีโอเท่านั้น: env=vp ข้อกำหนด ต้องใช้สำหรับเว็บและแอป
gdfp_req (ตัวระบุสคีมา Ad Manager)	พารามิเตอร์ตัวระบุสคีมา Ad Manager จะยอมรับค่าคงที่ซึ่งจะระบุว่าผู้ใช้อยู่ในสคีมา Ad Manager ตัวอย่างการใช้งาน gdfp_req=1 ข้อกำหนด ต้องใช้สำหรับเว็บและแอป
iu (หน่วยโฆษณา)	พารามิเตอร์หน่วยโฆษณาจะยอมรับค่าตัวแปรซึ่งควรตั้งค่าเป็นหน่วยโฆษณาปัจจุบันในรูปแบบต่อไปนี้ /network_id/.../ad_unit ตัวอย่างการใช้งาน iu=/6062/videodemo ข้อกำหนด ต้องใช้สำหรับเว็บและแอป
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 ตัวสำหรับแอป แนะนำสำหรับการสร้างรายได้แบบเป็นโปรแกรม
output (รูปแบบเอาต์พุตโฆษณา)	พารามิเตอร์รูปแบบเอาต์พุตโฆษณาจะยอมรับค่าคงที่ซึ่งควรตั้งค่าเป็นรูปแบบเอาต์พุตของโฆษณา ใช้ output=vast เพื่อใช้เวอร์ชัน VAST เริ่มต้นที่ตั้งค่าไว้สำหรับเครือข่ายของคุณ คุณสามารถขอเวอร์ชัน VAST หรือ VMAP ที่เจาะจงได้สำหรับแท็กโฆษณาหรือส่วนต่างๆ ของเว็บไซต์ที่ต้องการ สำหรับ VAST หากวิดีโอเพลเยอร์ใช้ IMA SDK พารามิเตอร์เอาต์พุตสำหรับคำขอโฆษณาวิดีโอจะตั้งค่าเป็น output=xml_vast4 เสมอ ซึ่งไม่ก่อให้เกิดความเสี่ยงด้านความน่าเชื่อถือ เนื่องจาก SDK ดังกล่าวใช้งานย้อนหลังได้กับ VAST ทุกเวอร์ชันที่เซิร์ฟเวอร์โฆษณาของบุคคลที่สามอาจจะแสดง ใช้ output=vmap เพื่อแสดงเวอร์ชัน VMAP เริ่มต้นที่คุณเปิดใช้งานสำหรับเครือข่าย (เช่น VMAP 1) หากคุณแสดง VAST ใน VMAP คุณจะใช้ xml_vmap1_vast3 หรือ xml_vmap1_vast4 เพื่อระบุเวอร์ชัน VAST ที่จะแสดงได้ ตัวอย่างการใช้งาน การตั้งค่า VAST เริ่มต้นของเครือข่าย: output=vast VAST 4: output=xml_vast4 การตั้งค่า VMAP เริ่มต้นของเครือข่าย: output=vmap VMAP 1: output=xml_vmap1 VMAP 1 ที่แสดง VAST 4: output=xml_vmap1_vast4 ข้อกำหนด ต้องใช้สำหรับเว็บและแอป
pvid (รหัสชุดแอป) pvid_s (ขอบเขตชุดแอป)	ค่ารหัสชุดแอปจำเป็นต้องมีสำหรับการสร้างรายได้ในกรณีที่ผู้ใช้เลือกไม่รับการปรับโฆษณาตามโปรไฟล์ในอุปกรณ์ Android พารามิเตอร์ pvid จะยอมรับค่าตัวแปร ซึ่งตั้งค่าเป็นรหัสชุดแอป Android และพารามิเตอร์ pvid_s จะยอมรับค่าคงที่ซึ่งแสดงถึงขอบเขตของรหัสชุดแอป (ไม่ว่าจะเป็น scope_app หรือ scope_developer) ขณะที่ IMA/PAL SDK ส่งช่องนี้โดยอัตโนมัติ ผู้เผยแพร่โฆษณาที่ไม่ได้ใช้ SDK จะต้องเรียกใช้ SDK ของชุดแอปและส่งพารามิเตอร์เหล่านี้ไปยังคําขอโฆษณาด้วยตนเอง ดูเอกสารประกอบของ Android เกี่ยวกับวิธีการเรียกรหัสชุดแอป ตัวอย่างการใช้งาน pvid=[AppSetID_value] pvid_s=scope_app ข้อกำหนด ต้องใช้สำหรับแอป แนะนำสำหรับการสร้างรายได้แบบเป็นโปรแกรม
rdid idtype is_lat (ตัวระบุอุปกรณ์ที่รีเซ็ตได้)	ตัวระบุอุปกรณ์ที่รีเซ็ตได้จะยอมรับค่าตัวแปร สำหรับแอปพลิเคชันในตัว (ไม่ใช่ในเว็บหรือเว็บบนอุปกรณ์เคลื่อนที่) SDK จะส่งตัวระบุอุปกรณ์ที่รีเซ็ตได้สำหรับผู้ใช้ที่กำหนดเป้าหมายในคำขอสตรีมของคุณด้วยพารามิเตอร์สำหรับ rdid, idtype และ is_lat ในสตรีม SSB คุณต้องส่งพารามิเตอร์เหล่านี้มาให้ชัดเจนเหมือนที่ส่งสำหรับคำขอโฆษณาในฝั่งไคลเอ็นต์ ดูข้อมูลเพิ่มเติมเกี่ยวกับตัวระบุอุปกรณ์ สำหรับโฆษณาวิดีโอแบบเป็นโปรแกรมเกือบทั้งหมด จำเป็นต้องมีค่าเหล่านี้ Apple เลิกใช้งานสัญญาณ LAT แล้วใน iOS 14.5 เป็นต้นไป แต่ Google จะใช้ IDFA ที่มีอยู่ซึ่งไม่เป็นเลขศูนย์แทนเพื่อระบุว่าผู้ใช้ได้ยินยอมให้ติดตามในเวอร์ชัน iOS ที่รองรับความโปร่งใสในการติดตามแอป ดังนั้นต้องมี UserAgent ที่ระบุเวอร์ชันของระบบปฏิบัติการที่ถูกต้อง ตัวอย่างการใช้งาน ดูตัวอย่างโดยละเอียดของตัวระบุอุปกรณ์ที่รีเซ็ตได้ ข้อกำหนด ต้องใช้สำหรับแอป แนะนำสำหรับการสร้างรายได้แบบเป็นโปรแกรม
sz (ขนาด)	พารามิเตอร์ขนาดจะยอมรับค่าตัวแปร ซึ่งควรตั้งค่าเป็นขนาดของช่องโฆษณาวิดีโอหลัก หากมีหลายขนาด ควรคั่นด้วยเครื่องหมายไปป์ (|) อย่าใส่ "v" หลังขนาด ตัวอย่างการใช้งาน sz=400x300 ข้อกำหนด ต้องใช้สำหรับเว็บและแอป ไม่บังคับให้ใช้พารามิเตอร์นี้ถ้าขอเพียง ad_type=audio
unviewed_position_start (การแสดงผลที่ล่าช้า)	พารามิเตอร์การแสดงผลที่ล่าช้าจะยอมรับค่าคงที่เพื่อระบุการแสดงผลที่ล่าช้าของวิดีโอ ตัวอย่างการใช้งาน unviewed_position_start=1 ข้อกำหนด ต้องใช้สำหรับเว็บและแอป
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 ความต้องการ ต้องใช้สำหรับเว็บและแอป แนะนำสำหรับการสร้างรายได้แบบเป็นโปรแกรม
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 จากเว็บและแอป แนะนำสำหรับการสร้างรายได้แบบเป็นโปรแกรม