Ad Break API ของการแทรกโฆษณาแบบไดนามิก (DAI) ช่วยให้คุณสร้างและจัดการข้อมูลเวลาและการกำหนดเป้าหมายโฆษณาของช่วงพักโฆษณาที่กำลังจะเกิดขึ้นในไลฟ์สดได้
DAI Ad Break API ช่วยให้คุณทำสิ่งต่อไปนี้ได้
- เพิ่มอัตราการส่งโฆษณาในช่วงที่มีการเข้าชมสูงสุด: ให้เวลาบริการ DAI มากขึ้นในการเลือกโฆษณาที่ให้ผลตอบแทนสูงสุดสำหรับไลฟ์สด เราขอแนะนำให้ใช้ DAI Ad Break API เมื่อกิจกรรมไลฟ์สดมีผู้เข้าชมพร้อมกันจำนวนมาก มีแท็กโฆษณาแบบไดนามิก หรือมีโฆษณาที่มีเวลาในการตอบสนองสูง
- ควบคุมช่วงพักโฆษณาได้อย่างเต็มที่: สร้าง อัปเดต และลบช่วงพักโฆษณาล่วงหน้า ซึ่งให้ความยืดหยุ่นมากกว่าการส่งสัญญาณโฆษณาในไฟล์ Manifest และอัตราการส่งโฆษณาที่สูงขึ้นสำหรับการแสดงพ็อดโฆษณาเมื่อเทียบกับการตัดสินใจแบบทันท่วงที
- มอบประสบการณ์การรับชมที่ไม่ขาดตอน: ลดข้อผิดพลาดในการเล่นที่เกี่ยวข้องกับโฆษณา เช่น พ็อดโฆษณาที่แสดงโฆษณาน้อยเกินไปหรือมากเกินไป โดยการระบุข้อมูลช่วงพักโฆษณาที่แม่นยำ
คู่มือนี้อธิบายเมธอด DAI Ad Break API และแนะนำวงจรของช่วงพักโฆษณาสำหรับขั้นตอน DAI Full Service และ Pod Serving
ดูข้อมูลเกี่ยวกับเมธอด DAI ช่วงพักโฆษณา 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: ระบบแสดงช่วงพักโฆษณาต่อผู้ใช้แล้วBREAK_STATE_EXPIRED: ช่วงพักโฆษณาหมดอายุก่อนแสดง ใช้ได้เฉพาะเมื่อคุณเปิดใช้การกำหนดเวลาหลายช่วงพักในกิจกรรมไลฟ์สด ดูรายละเอียดได้ที่การตั้งค่าช่วงพักโฆษณาตอนกลาง โดยค่าเริ่มต้น ช่วงพักโฆษณาจะหมดอายุหลังจากค่าในช่องexpectedStartTime30 นาที หรือหลังจากเริ่มการตัดสินใจ 30 นาทีหากคุณไม่ได้ตั้งค่าช่องexpectedStartTimeคุณปรับแต่งระยะเวลานี้ได้โดยใช้ช่องexpireDuration
แผนภาพต่อไปนี้แสดงไทม์ไลน์ของเอนทิตี AdBreak ตั้งแต่การสร้างจนถึงการดำเนินการเสร็จสมบูรณ์

คุณสามารถสร้างเอนทิตี AdBreak ได้ตั้งแต่ 1 ถึง 300 นาทีก่อนที่ช่วงพักโฆษณาจะเริ่มขึ้น
- หลีกเลี่ยงการสร้างช่วงพักโฆษณาก่อนเวลาเริ่มต้นที่คาดไว้ของช่วงพักน้อยกว่า 1 นาที เนื่องจาก Google DAI อาจมีเวลาไม่เพียงพอสำหรับการตัดสินใจเกี่ยวกับโฆษณา ซึ่งจะทำให้อัตราการส่งโฆษณาลดลง
- หลีกเลี่ยงการสร้างช่วงพักโฆษณาล่วงหน้าเกิน 6 ชั่วโมงก่อนเวลาเริ่มต้นที่คาดไว้ของช่วงพักโฆษณา เนื่องจากเซิร์ฟเวอร์โฆษณาอาจทำให้โฆษณาที่ขอไม่ถูกต้อง
ส่วนต่อไปนี้จะครอบคลุมการเปลี่ยนสถานะช่วงพักโฆษณาในขั้นตอนการแสดงโฆษณาแบบ Pod และบริการเต็มรูปแบบของ DAI
ทำความเข้าใจขั้นตอนของ DAI แบบฟูลเซอร์วิส
DAI แบบฟูลเซอร์วิสของ Google จะจัดการทั้งไฟล์ Manifest ของเนื้อหาและพ็อดโฆษณา
สำหรับการกำหนดเป้าหมายโฆษณาที่กำหนดเอง ให้ใช้ DAI Ad Break API เพื่อสร้างเอนทิตี AdBreak ก่อนเครื่องหมายช่วงพักโฆษณาที่เกี่ยวข้องในไฟล์ Manifest ของไลฟ์สดเนื้อหา
- เวลาในการส่งมอบนี้ช่วยให้บริการ DAI ของ Google ใช้ข้อมูล
AdBreakเพื่อการตัดสินใจเกี่ยวกับโฆษณาได้ - เมื่อ DAI ของ Google ตรวจพบตัวทำเครื่องหมายโฆษณาในไฟล์ Manifest ระบบจะใช้การตัดสินใจแสดงโฆษณาที่มีข้อมูลเอนทิตี
AdBreakและเปลี่ยนสถานะของเอนทิตีเป็นBREAK_STATE_COMPLETE
เมื่อเปิดใช้การกำหนดเวลาช่วงพักโฆษณาหลายช่วงในกิจกรรมไลฟ์สด คุณจะตั้งค่าช่อง matchParams ในเอนทิตี AdBreak ได้ กระบวนการนี้ช่วยให้ DAI ของ Google จับคู่เครื่องหมายโฆษณาในไฟล์ Manifest ที่ตรวจพบกับช่วงพักโฆษณาในสถานะ BREAK_STATE_SCHEDULED หรือ BREAK_STATE_DECISIONED ได้

ทำความเข้าใจขั้นตอนการแสดงพ็อด
ในขั้นตอนนี้ คุณจะจัดการไฟล์ Manifest ของไลฟ์สดเนื้อหาหรือใช้บริการจัดการไฟล์ Manifest ของบุคคลที่สามเพื่อตรวจหาเครื่องหมายโฆษณาในไฟล์ Manifest
เรียกใช้ DAI Ad Break API ก่อนเวลาเริ่มต้นที่คาดไว้ของช่วงพักโฆษณาเพื่อสร้างเอนทิตี AdBreak ก่อนเวลาที่คุณต้องขอเซกเมนต์พ็อดโฆษณาหรือไฟล์ Manifest ของโฆษณา
เมื่อเครื่องมือต่อวิดีโอตรวจพบตัวทำเครื่องหมายโฆษณาในไฟล์ Manifest และส่งคำขอเซกเมนต์โฆษณาพร้อมรหัสช่วงพักโฆษณา DAI ของ Google จะใช้ข้อมูล AdBreak ที่มีรหัสเดียวกันในการตัดสินใจเกี่ยวกับโฆษณา
หลังจากที่ไคลเอ็นต์ขอสื่อโฆษณา เอนทิตี AdBreak ที่คุณสร้างผ่าน API จะเปลี่ยนเป็นสถานะ BREAK_STATE_COMPLETE

ส่งคำขอแรก
หากต้องการตั้งค่าการเข้าถึง API และส่งคำขอแรก โปรดดูหัวข้อใช้ DAI ช่วงพักโฆษณา API