Pod Serve API ให้สิทธิ์เข้าถึงพ็อดโฆษณาวิดีโอแบบปรับอัตราบิต ซึ่งจัดเตรียมไว้ในลักษณะที่สามารถต่อเข้ากับเพลย์ลิสต์สื่อ HLS หรือ MPEG DASH ที่แสดงต่อผู้ใช้ได้โดยตรง
API นี้มีไว้สำหรับผู้เผยแพร่โฆษณาขั้นสูงและพาร์ทเนอร์เทคโนโลยีวิดีโอ การใช้ API นี้ในวงกว้างต้องมีการออกแบบและปรับใช้เวิร์กโฟลว์การแสดงสื่อที่ซับซ้อนซึ่งอยู่นอกขอบเขตของเอกสารนี้
ข้อกำหนดเบื้องต้น
ก่อนที่จะประมวลผลสตรีมแบบสดผ่าน DAI Podserving API คุณจะต้องสร้างเหตุการณ์สตรีมแบบสดโดยใช้ UI ของ Google Ad Manager หรือ API กิจกรรมสด
คอมโพเนนต์
คอมโพเนนต์ 3 อย่างของการใช้งาน Pod Serve API มีอยู่ด้วยกัน 3 อย่าง ได้แก่ Google Ad Manager, โปรแกรมเล่นวิดีโอของไคลเอ็นต์ และเซิร์ฟเวอร์การจัดการไฟล์ Manifest
Ad Manager
Ad Manager มีหน้าที่แสดงโฆษณาต่อผู้ใช้และสามารถจัดการผ่าน Ad Manager SDK หรือเว็บอินเทอร์เฟซได้ บริการมีหน้าที่รับผิดชอบดังต่อไปนี้
- การรับคำขอสตรีมจากโปรแกรมเล่นวิดีโอของไคลเอ็นต์ การตัดสินใจโฆษณา และเวอร์ชันแปลให้ตรงกับโปรไฟล์การเข้ารหัสเนื้อหาของคุณ
- การตอบสนองต่อคำขอกลุ่มโฆษณาจากโปรแกรมเล่นวิดีโอของไคลเอ็นต์ และจัดเตรียมส่วนที่เหมาะสมของพ็อดโฆษณาให้กับผู้ใช้ที่กำหนด
- การรับและประมวลผลคําสั่ง ping ของการติดตามจากโปรแกรมเล่นวิดีโอของไคลเอ็นต์
โปรแกรมเล่นวิดีโอไคลเอ็นต์
โปรแกรมเล่นวิดีโอของไคลเอ็นต์คือแอปหรือเว็บไซต์ที่ลูกค้าใช้ในการเล่นสตรีมวิดีโอที่เป็นผลลัพธ์ โปรแกรมเล่นจะมีหน้าที่รับผิดชอบดังต่อไปนี้
- การเริ่มต้นทรัพยากรสตรีมจาก Ad Manager และรับออบเจ็กต์สตรีมที่แสดงเซสชันการเล่นครั้งเดียวของเหตุการณ์สตรีมแบบสดที่ระบุ
- การขอไฟล์ Manifest ของสตรีมจากเซิร์ฟเวอร์การจัดการไฟล์ Manifest ซึ่งเริ่มเล่น
- แบบสำรวจข้อมูลเมตาของพ็อดโฆษณาจาก Ad Manager เป็นระยะๆ ซึ่งอธิบายเหตุการณ์โฆษณาที่ฝังอยู่ในกลุ่มโฆษณาของสตรีม
- การรอฟังเหตุการณ์ข้อมูลเมตาที่กำหนดเวลาซึ่งสร้างโดยโปรแกรมเล่นที่มีรหัสสื่อโฆษณา เมื่อพบเหตุการณ์เหล่านี้ โปรแกรมเล่นจะส่งต่อเหตุการณ์ไปยัง Ad Manager เพื่อยืนยันว่าเหตุการณ์โฆษณาเกิดขึ้นเรียบร้อยแล้ว
หากต้องการดูข้อมูลเพิ่มเติมเกี่ยวกับการติดตั้งใช้งานโปรแกรมเล่นวิดีโอของไคลเอ็นต์ที่ถูกต้อง โปรดอ่านคู่มือการแสดงพ็อดสำหรับแพลตฟอร์มของคุณ
ดูการติดตั้งใช้งานที่กำหนดเองได้ที่คู่มือไคลเอ็นต์การแสดงพ็อดสำหรับ DAI API
เซิร์ฟเวอร์การจัดการไฟล์ Manifest
เซิร์ฟเวอร์การจัดการไฟล์ Manifest คือเซิร์ฟเวอร์ที่ทำหน้าที่โฮสต์ไฟล์ Manifest ของสตรีมที่ให้ไว้ในโปรแกรมเล่นวิดีโอของไคลเอ็นต์ เซิร์ฟเวอร์มีหน้าที่ ดังต่อไปนี้
- การจัดการการส่งไฟล์ Manifest ไปยังโปรแกรมเล่นวิดีโอของไคลเอ็นต์
- การขอเทมเพลตช่วงเวลาจาก Ad Manager (สำหรับสตรีม MPEG DASH เท่านั้น) เพื่อเติมข้อมูลด้วยกลุ่มโฆษณา
- การแทรก URL ของกลุ่มโฆษณาที่โฮสต์ไว้ใน Ad Manager ในไฟล์ Manifest ของสตรีมวิดีโอ (สำหรับ HLS) หรือช่วงเวลาโฆษณา (สำหรับ MPEG DASH) ระหว่างช่วงพักโฆษณา
- การแสดงไฟล์ Manifest ที่มีการแก้ไขไปยังโปรแกรมเล่นวิดีโอของไคลเอ็นต์
ดูข้อมูลเพิ่มเติมเกี่ยวกับการใช้งานเซิร์ฟเวอร์เครื่องมือจัดการไฟล์ Manifest ที่กำหนดเองได้ในคู่มือการจัดการไฟล์ Manifest
อภิธานศัพท์
- เหตุการณ์สตรีมแบบสด: เหตุการณ์ที่จัดเก็บข้อมูลการกำหนดค่าที่สำคัญสำหรับสตรีมแบบสด เช่น โปรไฟล์การเข้ารหัส กิจกรรมสตรีมแบบสดจะสร้างขึ้นโดยใช้ Ad Manager
- ออบเจ็กต์สตรีม: ออบเจ็กต์ที่แสดงเซสชันการเล่น 1 ครั้งของเนื้อหาวิดีโอที่เจาะจง พร็อพเพอร์ตี้ที่โดดเด่นประกอบด้วยรหัสสตรีมและ URL การยืนยันสื่อ
- พ็อดโฆษณา: การจัดกลุ่มวิดีโอโฆษณาที่แสดงในช่วงพักโฆษณา
- กลุ่มโฆษณา: ไฟล์กลุ่มสื่อสำหรับช่วงพักโฆษณา
- ข้อมูลเมตาของพ็อดโฆษณา: ข้อมูลเมตาสำหรับช่วงพักโฆษณาที่ใช้เพื่อแสดง UI โฆษณาในไคลเอ็นต์ เช่น ซ่อนปุ่มค้นหาระหว่างโฆษณา
- รหัสสื่อโฆษณา: ข้อมูลเมตาที่เข้ารหัสเป็นแท็ก ID3 ภายในไฟล์กลุ่มโฆษณา ข้อมูลเมตานี้ใช้ระบุเมื่อเกิดเหตุการณ์ที่เกี่ยวข้องกับโฆษณาในระหว่างการเล่น เช่น เริ่มต้นหรือตอนกลางโฆษณา