คำแนะนำเกี่ยวกับโปรแกรมเล่น DAI และการพัฒนาแอป

ใช้ข้อมูลต่อไปนี้เพื่อวางแผนและจัดการโปรแกรมเล่นและการพัฒนาแอปสำหรับการแทรกโฆษณาแบบไดนามิก (Dynamic Ad Insertion หรือ DAI)

ข้ามไปยังส่วนที่ต้องการ

  การรองรับแพลตฟอร์ม DAI
  การรองรับตัวควบคุมของโปรแกรมเล่นวิดีโอ
  ลบล้างแท็กโฆษณาเริ่มต้น
  ลบล้างพารามิเตอร์ของรูปแบบสตรีม
  คำถามที่พบบ่อย

เปรียบเทียบการใช้งานโปรแกรมเล่น DAI ประเภทต่างๆ

การรองรับแพลตฟอร์ม

การรองรับการแทรกโฆษณาแบบไดนามิกแสดงอยู่ด้านล่าง ซึ่งรวมถึงแพลตฟอร์มที่ไม่รองรับด้วย คุณสามารถคลิกเพื่อดูตัวอย่างแอปและข้อมูลเพิ่มเติมเกี่ยวกับแต่ละแพลตฟอร์มได้

ตัวอย่างแอปพื้นฐานสาธิตเหตุการณ์การติดตามวิดีโอเท่านั้น ตัวอย่างดังกล่าวเหมาะสำหรับผู้เผยแพร่โฆษณาที่ใช้โฆษณาตอนต้นเท่านั้น

ตัวอย่างแอปขั้นสูงสาธิตฟังก์ชันการทำงานทั้งหมดของแอปพื้นฐาน ตลอดจนการสร้างบุ๊กมาร์ก, Snapback, คำบรรยาย, Scrubbing และนาฬิกานับเวลาถอยหลัง ซึ่งเหมาะสำหรับผู้เผยแพร่โฆษณาที่สร้างรายได้จากเนื้อหาในรูปแบบยาว

แพลตฟอร์ม	การรองรับ SSB	IMA SDK ที่พร้อมใช้งาน DAI	ตัวอย่างแอป	เอกสารประกอบเพิ่มเติม
iOS	มี	iOS IMA SDK	ตัวอย่างแอป iOS	คู่มือเริ่มใช้งานฉบับย่อ สำหรับ iOS เอกสารอ้างอิงสำหรับ iOS
Android หรือ FireTV	มี	Android IMA SDK	ตัวอย่างแอป Android	คู่มือเริ่มใช้งานฉบับย่อ สำหรับ Android เอกสารอ้างอิงสำหรับ Android
tvOS (Apple TV)	มี	tvOS IMA SDK	ตัวอย่างแอป tvOS	คู่มือเริ่มใช้งานฉบับย่อสำหรับ tvOS เอกสารอ้างอิงสำหรับ tvOS
Roku	มี	SDK ที่ดาวน์โหลดมา ในเวลาที่เรียกใช้	ตัวอย่างแอป Roku	คู่มือเริ่มใช้งานฉบับย่อ สำหรับ Roku
Chromecast	มี	SDK ที่ดาวน์โหลดมา ในเวลาที่เรียกใช้	ตัวอย่างแอปตัวรับสัญญาณ โดยทั่วไปแล้ว คุณต้องมีแอป iOS หรือ Android ที่ "แคสต์" ไปยังอุปกรณ์ Chromecast ได้ คุณดูตัวอย่างได้ใน "ตัวอย่างแอปขั้นสูง" สำหรับ iOS และ Android	คู่มือเริ่มใช้งานฉบับย่อ สำหรับ Chromecast
HTML5	มี	SDK ที่ดาวน์โหลดมา ในเวลาที่เรียกใช้	ตัวอย่างแอป HTML5 โปรแกรมเล่น HTML5 แบบสาธิตของ DAI	คู่มือเริ่มใช้งานฉบับย่อ สำหรับ HTML5

การรองรับตัวควบคุมของโปรแกรมเล่นวิดีโอ

ตัวควบคุมของโปรแกรมเล่นวิดีโอจะใช้ได้เฉพาะเมื่อมีการเปิดใช้งาน IMA SDK ตัวอย่างแอปขั้นสูงทั้งหมดจะสาธิตฟังก์ชันการทำงานของคุณลักษณะในแพลตฟอร์มต่างๆ ที่รองรับ ตัวอย่างแอปพื้นฐานสามารถสาธิตคุณลักษณะข้อมูลจุดเริ่มโฆษณาได้เช่นกัน

• การนับถอยหลังสำหรับโฆษณาทั้งหมดและการนับถอยหลังสำหรับโฆษณาแต่ละชิ้น: เป็นความสามารถในการเพิ่มการนับถอยหลังเพื่อระบุระยะเวลาที่เหลือสำหรับโฆษณาทั้งหมด

  iOS และ Android: IMA SDK มีคุณลักษณะนี้ให้เลือกใช้งานได้

  Roku และ tvOS: ภายใน IMA SDK ตัวอย่างแอปขั้นสูงมีตัวอย่างของคุณลักษณะนี้ คุณต้องรวมโค้ดที่กำหนดเองไว้ด้วยหากต้องใช้คุณลักษณะนี้

• คำบรรยาย: เป็นความสามารถในการเพิ่มคำอธิบายภาพภายในสตรีมเนื้อหา โปรแกรมคำบรรยายที่รองรับรวมถึงรายการต่อไปนี้

  Timed Text Markup Language (TTML) (side-car): TTML มีจุดประสงค์ในการใช้งานเพื่อการแปลงหรือการแลกเปลี่ยนข้อมูลที่เป็นข้อความที่มีการจับเวลาในรูปแบบเนื้อหาสำหรับการเผยแพร่แบบดั้งเดิมซึ่งปัจจุบันใช้ในฟังก์ชันการใส่คำบรรยายและคำอธิบายภาพ

  WebVTT (side-car): ไฟล์ WebVTT ให้คำอธิบายภาพหรือคำบรรยายสำหรับเนื้อหาวิดีโอ คำอธิบายวิดีโอแบบข้อความ บทต่างๆ สำหรับการนำทางเนื้อหา หรือโดยทั่วไปแล้ว เป็นข้อมูลเมตารูปแบบใดก็ตามที่มีการจับเวลาให้สอดคล้องกับเนื้อหาวิดีโอหรือเสียง

• การสร้างบุ๊กมาร์ก: การสร้างบุ๊กมาร์กเป็นความสามารถในการบันทึกจุดที่เฉพาะเจาะจงในสตรีมเนื้อหา แล้วกลับไปยังจุดนั้นได้ สมมติว่าผู้ใช้คนหนึ่งดูเนื้อหานาน 5 นาที ออกจากสตรีมวิดีโอนั้น แล้วกลับมาดูต่อ การสร้างบุ๊กมาร์กจะบันทึกตำแหน่งของผู้ใช้ในสตรีม ดังนั้นสตรีมจะกลับมาที่จุดที่ดูค้างไว้ แล้วให้ผู้ใช้ดูต่อได้อย่างต่อเนื่อง
• Snapback: Snapback เป็นความสามารถในการนำผู้ใช้กลับไปยังจุดเริ่มต้นของช่วงพักโฆษณาที่ผู้ใช้เลื่อนแถบเลื่อนเลยไป จากนั้นนำผู้ใช้กลับไปยังตำแหน่งเดิมหลังจากช่วงพักโฆษณาสิ้นสุดลง
• Scrubbing: โดยทั่วไปแล้วเป็นคุณลักษณะของเนื้อหาในรูปแบบยาว ซึ่งให้ความสามารถในการดูเฟรมแรกของเนื้อหาขณะที่ผู้ใช้เลื่อนผ่านแถบเนื้อหา

ลบล้างแท็กโฆษณาเริ่มต้น

เมื่อกำหนดแหล่งเนื้อหา DAI สำหรับ VOD หรือสตรีมเชิงเส้นแบบสดใน Ad Manager คุณต้องระบุแท็กโฆษณาวิดีโอเริ่มต้น

เมื่อโปรแกรมเล่นวิดีโอขอสตรีม ระบบจะใช้แท็กโฆษณานี้เหมือนกับที่คุณระบุไว้ใน UI ทุกประการ อย่างไรก็ตาม คุณสามารถลบล้างพารามิเตอร์ของแท็กนั้นในคำขอสตรีมได้

ดูวิธีจัดเตรียมพารามิเตอร์การกำหนดเป้าหมายไปยังสตรีมของคุณ

ลบล้างพารามิเตอร์ของรูปแบบสตรีม

ผู้เผยแพร่โฆษณาเป็นผู้กำหนดลำดับของเพลย์ลิสต์ HLS ที่เป็นค่าเริ่มต้น

การลบล้างการเลือกรูปแบบและพารามิเตอร์ของลำดับสามารถระบุในระหว่างเวลาที่สร้างสตรีมได้ ซึ่งช่วยให้คุณระบุชุดย่อยของรูปแบบที่ควรรวมไว้ในการตอบสนองต่อคำขอเพลย์ลิสต์หลักและลำดับของรูปแบบเหล่านั้น ชุดย่อยและลำดับของรูปแบบจะยังคงเหมือนเดิมตลอดช่วงอายุของสตรีม เว้นแต่จะมีการลบล้างอย่างชัดแจ้ง

ดูวิธีลบล้างพารามิเตอร์ตัวแปรสตรีม

คำถามที่พบบ่อย

ขยายทั้งหมด  ยุบทั้งหมด

ฉันจะแสดงโฆษณาตอนต้นได้อย่างไร

ในสตรีม VOD คุณกำหนดค่าได้ว่าจะให้แสดงโฆษณาตอนต้นโดยใช้กฎโฆษณาหรือไม่

ในสตรีมเชิงเส้นแบบสด คุณสามารถกำหนดค่า Ad Manager ให้แสดงโฆษณาตอนต้นได้ (ไม่บังคับ) โปรแกรมเล่นวิดีโอสามารถสร้างคำขอโฆษณา Ad Manager ฝั่งไคลเอ็นต์เพื่อแสดงโฆษณาตอนต้นให้ผู้ใช้ก่อนขอสตรีมแบบสดของ Ad Manager DAI

ตั้งค่าการพักโฆษณา

---

ในสตรีมเชิงเส้นแบบสด คุณสามารถใช้ฟีเจอร์ "การพักโฆษณา" เพื่อหลีกเลี่ยงการแสดงโฆษณา DAI อีกรายการให้แก่ผู้ชมทันทีที่เพิ่งได้ดูโฆษณาตอนต้นไป

การใช้การพักโฆษณาแบ่งออกเป็น 2 ส่วน ดังนี้

1. ระบุ "ระยะเวลาพักโฆษณา" เมื่อคุณตั้งค่าสตรีมแบบสดสำหรับ DAI
2. ส่งพารามิเตอร์ dai-ah ที่ตั้งเป็น 1 ในคำขอสร้างสตรีม adtagparameters คืออาร์เรย์เดียวกันกับที่ใช้เมื่อคุณลบล้างพารามิเตอร์แท็กโฆษณา Ad Manager และเมื่อคุณตั้งค่าพารามิเตอร์ตัวแปรสตรีม

ฉันจะส่งเนื้อหาวิดีโอตามคำขอจาก CDN มากกว่า 1 รายการได้อย่างไร

เมื่อสร้างการกำหนดค่า CDN สำหรับเนื้อหาวิดีโอตามคำขอ คุณจะมีตัวเลือกในการตั้งค่า CDN เริ่มต้นและตั้งค่าการแสดงเนื้อหาจาก CDN เพิ่มเติม ซึ่งให้คุณตั้งค่า CDN ได้มากกว่า 1 รายการและเลือก CDN ที่ต้องการให้แสดงเนื้อหาได้ในแบบไดนามิกตั้งแต่เริ่มเซสชันโดยใช้คีย์-ค่า

เมื่อตั้งค่าและบันทึกการกำหนดค่า CDN แล้ว Ad Manager จะกำหนดชื่อให้แต่ละ CDN ชื่อนี้ควรจะส่งเข้าไปในคำขอสร้างสตรีมโดยเป็นค่าของพารามิเตอร์ dai-dlid *

สำหรับ SSB ระบบจะส่งพารามิเตอร์เป็น dai-dlid=AaBbC1aaBa0obA1BABaaBA (โดย AaBbC1aaBa0obA1BABaaBA เป็นชื่อที่ปรากฏใน Ad Manager)

เมื่อใช้ IMA SDK ชื่อดังกล่าวควรจะส่งเข้าไปในคำขอสร้างสตรีมโดยใช้พารามิเตอร์แท็กโฆษณา

_{* Ad Manager จะใช้ CDN เริ่มต้น หากไม่มีการส่งชื่อเข้าไปในคำขอ}

ฉันจะขอสตรีมวิดีโอตามคำขอในตัวอย่างแอปได้อย่างไร

คำขอสตรีม VOD มี cmsid และ vid ซึ่งให้คุณกำหนดเป้าหมายโฆษณาไปยังเนื้อหาวิดีโอได้

จะเกิดอะไรขึ้นหากมีปัญหาในการดึงเนื้อหาวิดีโอจาก Ad Manager

หากแอปของคุณตรวจพบปัญหาในการรับการตอบสนองจาก Ad Manager คุณควรเข้ารหัสตรรกะเพื่อเล่นเนื้อหาดิบโดยไม่มีโฆษณา สำหรับสตรีม VOD นี่คือ ingestUrl ที่ระบุไว้สำหรับ Ad Manager ในฟีด MRSS ของแหล่งเนื้อหาของคุณ สำหรับสตรีมเชิงเส้นแบบสด นี่คือ URL สำหรับสตรีมจากโปรแกรมเข้ารหัสของคุณ ดูข้อมูลเพิ่มเติมเกี่ยวกับแนวทางปฏิบัติที่ดีที่สุดสำหรับสตรีมสำรองของ DAI

เพราะเหตุใดฉันจึงควรเปลี่ยนจากบีคอนฝั่งเซิร์ฟเวอร์ (SSB) ไปใช้ IMA SDK

IMA SDK ช่วยให้ผู้เผยแพร่โฆษณาทำให้สัญญาณต่างๆ สำหรับการรายงานสมบูรณ์ขึ้นได้และทำให้การติดตามผลของกิจกรรมมีความถูกต้องมากขึ้น ดูข้อมูลเพิ่มเติมเกี่ยวกับบีคอนฝั่งเซิร์ฟเวอร์สำหรับ DAI

ฉันจะแก้ปัญหาสตรีมฝั่งเซิร์ฟเวอร์ได้อย่างไร

ทุกครั้งที่โปรแกรมเล่นวิดีโอขอสตรีมจาก Ad Manager DAI ระบบจะส่งสตรีมกลับมาพร้อมด้วยรหัสเซสชัน ให้ตรวจสอบว่าคุณดูรหัสสตรีมนี้จากภายในแอปพลิเคชันของคุณได้เมื่อต้องแก้ไขข้อบกพร่องของโฆษณาในสตรีม โดยคุณใช้รหัสสตรีมนี้เพื่อตรวจสอบและแก้ปัญหากิจกรรมการสตรีมได้

หากมีปัญหาใดๆ เกี่ยวกับการแก้ปัญหาหรือการหยุดทำงานของ DAI โปรดติดต่อทีมสนับสนุนผู้เผยแพร่โฆษณา