API ช่วงพักโฆษณาสำหรับการแทรกโฆษณาแบบไดนามิก (DAI) ช่วยให้คุณสร้างและจัดการ ข้อมูลการกำหนดเวลาและการกำหนดเป้าหมายโฆษณาของช่วงพักโฆษณาที่กำลังจะเกิดขึ้นในไลฟ์สดได้
DAI Ad Break API ช่วยให้คุณทำสิ่งต่อไปนี้ได้
- เพิ่มอัตราการแสดงโฆษณาในช่วงที่มีการเข้าชมสูงสุด: ให้เวลาบริการ DAI มากขึ้นเพื่อ เลือกโฆษณาที่สร้างรายได้สูงสุดสำหรับกิจกรรมแบบสด เราขอแนะนำให้ใช้ DAI Ad Break API เมื่อกิจกรรมไลฟ์สดมีจำนวนผู้ใช้พร้อมกันสูง แท็กโฆษณาแบบไดนามิก หรือโฆษณาที่มีเวลาในการตอบสนองสูง
- ควบคุมช่วงพักโฆษณาได้อย่างเต็มที่: สร้าง อัปเดต และลบช่วงพักโฆษณาล่วงหน้า ซึ่งมีความยืดหยุ่นมากกว่าการส่งสัญญาณโฆษณาในไฟล์ Manifest และมีอัตราการแสดงโฆษณาสูงกว่าสำหรับการแสดงพอดแคสต์เมื่อเทียบกับการตัดสินใจแบบเรียลไทม์
- มอบประสบการณ์การรับชมที่ไม่ขาดตอนให้แก่ผู้ชม: ลดข้อผิดพลาดในการเล่นที่เกี่ยวข้องกับโฆษณา เช่น พ็อดโฆษณาที่มีโฆษณาน้อยเกินไปหรือมากเกินไป โดยระบุข้อมูลช่วงพักโฆษณาที่แม่นยำ
คู่มือนี้อธิบายเมธอด DAI Ad Break API และแนะนำวงจรช่วงพักโฆษณาสำหรับ DAI Full Service และ Pod Serving Flow
ดูวิธีการของ DAI Ad Break API
API แสดงเมธอดมาตรฐานต่อไปนี้สำหรับการจัดการAdBreak
ทรัพยากร
Create: กำหนดเอนทิตีAdBreakใหม่สำหรับเอนทิตีLiveStreamEventไม่บังคับ: ตั้งค่าพร็อพเพอร์ตี้expectedStartTimeเพื่อกำหนดเวลาให้การตัดสินใจเกี่ยวกับโฆษณา เริ่มภายใน 60 วินาทีก่อนที่ช่วงพักโฆษณาจะเริ่มGet: เรียกข้อมูลรายละเอียดของเอนทิตีAdBreakที่เฉพาะเจาะจง รวมถึงข้อมูลเมตาของสถานะช่วงพักโฆษณาและเวลาList: แสดงผลรายการเอนทิตีAdBreakที่สร้างไว้ก่อนหน้านี้ ด้วย API สำหรับเอนทิตีLiveStreamEventที่ระบุ โดยจัดเรียงตามลำดับ เวลาแบบย้อนกลับ โปรดทราบว่า API จะไม่แสดงช่วงพักโฆษณาที่กำหนด เฉพาะในไฟล์ Manifest ของสตรีมเนื้อหาUpdate: แก้ไขเอนทิตีAdBreakที่มีอยู่ก่อนที่การตัดสินใจเกี่ยวกับโฆษณาจะเริ่มขึ้นDelete: ยกเลิกการตัดสินใจเกี่ยวกับโฆษณาสำหรับเอนทิตีAdBreakที่สร้างไว้ก่อนหน้านี้
ทําความเข้าใจวงจรช่วงพักโฆษณา
AdBreak เอนทิตีมีสถานะต่อไปนี้
BREAK_STATE_UNSPECIFIED: สถานะเริ่มต้นBREAK_STATE_SCHEDULED: สร้างช่วงพักโฆษณาเรียบร้อยแล้วและ กำหนดเวลาสำหรับการตัดสินใจเกี่ยวกับโฆษณาBREAK_STATE_DECISIONED: บริการ DAI เริ่มกระบวนการเลือกโฆษณา สำหรับช่วงพักโฆษณาแล้ว คุณไม่สามารถแก้ไขช่วงพักโฆษณาได้ แต่ยังคง ยกเลิกช่วงพักโฆษณาได้ ซึ่งอาจส่งผลเสียต่อเซิร์ฟเวอร์โฆษณา
BREAK_STATE_COMPLETE: ระบบแสดงช่วงพักโฆษณาต่อผู้ใช้แล้ว
แผนภาพต่อไปนี้แสดงไทม์ไลน์ของเอนทิตี AdBreak ตั้งแต่การสร้าง
จนถึงการดำเนินการเสร็จสมบูรณ์
คุณสร้างเอนทิตี AdBreak ได้ตั้งแต่ 1 ถึง 300 นาทีก่อนที่ระบบคาดว่าจะเริ่มช่วงพักโฆษณา
- หลีกเลี่ยงการสร้างช่วงพักโฆษณาน้อยกว่า 1 นาทีก่อนเวลาเริ่มต้นที่คาดไว้ของช่วงพัก เนื่องจาก Google DAI อาจมีเวลาไม่เพียงพอในการตัดสินใจเกี่ยวกับโฆษณา ซึ่งจะทำให้มีอัตราการส่งโฆษณาต่ำลง
- หลีกเลี่ยงการสร้างช่วงพักโฆษณานานกว่า 6 ชั่วโมงก่อนเวลาเริ่มต้นที่คาดไว้ของช่วงพักโฆษณา เนื่องจากเซิร์ฟเวอร์โฆษณาอาจทำให้โฆษณาที่ขอใช้ไม่ได้
ส่วนต่อไปนี้จะครอบคลุมการเปลี่ยนสถานะช่วงพักโฆษณาใน DAI Full Service และโฟลว์การแสดงพ็อด
ทำความเข้าใจโฟลว์ DAI แบบบริการเต็มรูปแบบ
DAI แบบบริการเต็มรูปแบบของ Google จะจัดการทั้งไฟล์ Manifest ของเนื้อหาและพ็อดโฆษณา
สำหรับการกำหนดเป้าหมายโฆษณาที่กำหนดเอง ให้ใช้ DAI Ad Break API เพื่อสร้างเอนทิตี AdBreak
ก่อนเครื่องหมายโฆษณาที่เกี่ยวข้องในไฟล์ Manifest ของการถ่ายทอดสดเนื้อหา
- เวลานำนี้ช่วยให้บริการ DAI ของ Google ใช้
AdBreakข้อมูลของคุณในการตัดสินใจเกี่ยวกับโฆษณาได้ - เมื่อ Google DAI ตรวจพบเครื่องหมายโฆษณาในไฟล์ Manifest ระบบจะใช้การตัดสินใจเกี่ยวกับโฆษณาที่มีข้อมูลเอนทิตี
AdBreakและเปลี่ยนสถานะของเอนทิตีเป็นBREAK_STATE_COMPLETE
ทําความเข้าใจขั้นตอนการแสดงพ็อด
ในโฟลว์นี้ คุณจะจัดการไฟล์ Manifest ของไลฟ์สดเนื้อหาหรือใช้บริการจัดการไฟล์ Manifest ของบุคคลที่สามเพื่อตรวจหาเครื่องหมายโฆษณาในไฟล์ Manifest
เรียกใช้ DAI Ad Break API ก่อนเวลาเริ่มต้นที่คาดไว้ของช่วงพักโฆษณาเพื่อสร้างเอนทิตี
AdBreakก่อนที่คุณจะต้องขอกลุ่มพ็อดโฆษณาหรือไฟล์ Manifest ของโฆษณา
เมื่อโปรแกรมต่อวิดีโอตรวจพบเครื่องหมายโฆษณาในไฟล์ Manifest และส่งคำขอเซ็กเมนต์โฆษณา
พร้อมรหัสช่วงพักโฆษณา Google DAI จะใช้AdBreakที่มีรหัสเดียวกัน
ในการตัดสินใจเกี่ยวกับโฆษณา
หลังจากที่ไคลเอ็นต์ขอสื่อโฆษณาแล้ว AdBreakเอนทิตีที่คุณสร้างผ่าน API
จะเปลี่ยนไปเป็นสถานะ BREAK_STATE_COMPLETE
สร้างคำขอแรก
ดูวิธีตั้งค่าการเข้าถึง API และส่งคำขอแรกได้ที่ ใช้ DAI Ad Break API