ดูข้อมูลเกี่ยวกับ DAI Ad Break API

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: ช่วงพักโฆษณาหมดอายุก่อนแสดง ใช้ได้เฉพาะเมื่อคุณเปิดใช้การกำหนดเวลาหลายช่วงพักในกิจกรรมไลฟ์สด ดูรายละเอียดได้ที่การตั้งค่าช่วงพักโฆษณาตอนกลาง โดยค่าเริ่มต้น ช่วงพักโฆษณาจะหมดอายุหลังจากค่าในช่อง expectedStartTime 30 นาที หรือหลังจากเริ่มการตัดสินใจ 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 ได้

เอนทิตีช่วงพักโฆษณาตั้งแต่การสร้างจนถึงการเสร็จสมบูรณ์ในขั้นตอน DAI แบบฟูลเซอร์วิส

ทำความเข้าใจขั้นตอนการแสดงพ็อด

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

เรียกใช้ DAI Ad Break API ก่อนเวลาเริ่มต้นที่คาดไว้ของช่วงพักโฆษณาเพื่อสร้างเอนทิตี AdBreak ก่อนเวลาที่คุณต้องขอเซกเมนต์พ็อดโฆษณาหรือไฟล์ Manifest ของโฆษณา

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

หลังจากที่ไคลเอ็นต์ขอสื่อโฆษณา เอนทิตี AdBreak ที่คุณสร้างผ่าน API จะเปลี่ยนเป็นสถานะ BREAK_STATE_COMPLETE

สถานะเสร็จสมบูรณ์ของเอนทิตีช่วงพักโฆษณา

ส่งคำขอแรก

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