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