ส่งการแจ้งเตือนช่วงพักโฆษณาล่วงหน้า

การแทรกโฆษณาแบบไดนามิก (DAI) ของ Google รองรับสตรีมแบบสดที่ระดับการเรียกใช้พร้อมกันสูง การแจ้งเตือนช่วงพักโฆษณาตอนต้น (EABN) คือคําขอให้ Google DAI กําหนดเวลาช่วงพักโฆษณาที่กําลังจะเกิดขึ้นหรือเริ่มตัดสินใจเกี่ยวกับโฆษณาทันที เพื่อเพิ่มประสิทธิภาพทั้งอัตราการแสดงโฆษณาและเวลาในการโหลด

หากต้องการเริ่มการแจ้งเตือนก่อนเข้าช่วงพักโฆษณาสําหรับบริการแบบเต็ม การแสดงพ็อด หรือการแทรกโฆษณาที่กําหนดโดยเซิร์ฟเวอร์ ให้ใช้แหล่งข้อมูลAdBreaks ทรัพยากรนี้สามารถสร้างและจัดการช่วงพักโฆษณาสําหรับสตรีมแบบสดทั้งหมดที่คุณสร้างขึ้นผ่าน UI ของ Google Ad Manager หรือ SOAP API ของ Google Ad Manager LiveStreamEventService

หน้านี้จะอธิบายวิธีตั้งเวลาช่วงพักโฆษณาเป็นการแจ้งเตือนช่วงพักโฆษณาตอนต้น

ข้อกำหนดเบื้องต้น

หากต้องการสร้างหรือจัดการช่วงพักโฆษณา คุณต้องมีคีย์ของชิ้นงานหรือคีย์ของชิ้นงานที่กําหนดเองที่ระบบสตรีมแบบสดสร้างขึ้น นอกจากนี้ คุณยังดูคีย์เหล่านี้ได้ในหน้ารายละเอียดของสตรีมแบบสด ดูตั้งค่าสตรีมแบบสดสําหรับ DAI โดยใช้ UI ของ Google Ad Manager

กำหนดเวลาช่วงพักโฆษณา

คุณสามารถตั้งเวลาช่วงพักโฆษณาขณะที่ผู้ชมสตรีมเพิ่มขึ้นได้ สําหรับกิจกรรมสตรีมแบบสดแต่ละรายการ ให้กําหนดเวลาช่วงพักโฆษณา 1 ช่วงล่วงหน้าได้สูงสุด 6 ชั่วโมงโดยใช้วิธีการแสดงโฆษณา Create ระบุเวลาเริ่มต้นที่คาดไว้และรหัสช่วงพักโฆษณา DAI จะเริ่มตัดสินใจเกี่ยวกับโฆษณาใกล้กับเวลาที่กําหนดไว้ สําหรับการตัดสินใจช่วงพักโฆษณาทันที ให้ข้ามเวลาเริ่มต้นที่คาดไว้ของช่วงพักโฆษณา

หากต้องการให้ Google DAI เริ่มตัดสินใจแสดงโฆษณาทันที คุณก็ละเว้นเวลาเริ่มต้นที่คาดไว้ของช่วงพักโฆษณาได้เมื่อเรียกใช้ Create

ตัวอย่างต่อไปนี้กำหนดเวลาช่วงพักโฆษณาสำหรับกิจกรรมสตรีมแบบสดประเภท Linear ให้เริ่มในวันที่ 6 มีนาคม 2025 เวลา 16:00 น. ตามเวลาสากลเชิงพิกัด (UTC)

cURL Node.js 
curl 'https://admanager.googleapis.com/v1/networks/NETWORK_CODE/liveStreamEventsByAssetKey/ASSET_KEY/adBreaks' \
  -H 'authorization: Bearer ACCESS_TOKEN' \
  -H 'content-type: application/json' \
  --data-raw '{"adBreakId":"mid-roll-1","assetKey":"ASSET_KEY","duration":"30s","expectedStartTime":"2025-03-06T16:00:00Z"}'

fetch("https://admanager.googleapis.com/v1/networks/NETWORK_CODE/liveStreamEventsByAssetKey/ASSET_KEY/adBreaks", {
    "headers": {
      "authorization":
        "Bearer ACCESS_TOKEN",
        "Content-Type": "application/json",
    },
  "body": JSON.stringify({
    "adBreakId": "mid-roll-1",
    "duration": "30s",
    "expectedStartTime": "2025-03-06T16:00:00Z"
  }),
  "method": "POST"
});

หากดำเนินการสำเร็จ คุณจะเห็นการตอบกลับ JSON ต่อไปนี้

{
  "name": "networks/.../liveStreamEventsByAssetKey/.../adBreaks/mid-roll-1",
  "adBreakId": "mid-roll-1",
  "assetKey": "...",
  "expectedStartTime": "2025-03-06T16:00:00Z",
  "duration": "30s",
  "breakState": "SCHEDULED"
}

หากต้องการค้นหาช่วงพักโฆษณา ให้ใช้วิธี List หากต้องการตรวจสอบรายละเอียดของช่วงพักโฆษณา ให้ใช้วิธี Get

ตัวอย่างต่อไปนี้แสดงช่วงพักโฆษณาทั้งหมดของกิจกรรมสตรีมแบบสด

cURL Node.js 
curl 'https://admanager.googleapis.com/v1/networks/NETWORK_CODE/liveStreamEventsByAssetKey/ASSET_KEY/adBreaks' \
  -H 'authorization: Bearer ACCESS_TOKEN'

fetch(
  "https://admanager.googleapis.com/v1/networks/NETWORK_CODE/liveStreamEventsByAssetKey/ASSET_KEY/adBreaks",
  {
    "headers": {
      "authorization": "Bearer ACCESS_TOKEN",
    },
    "method": "GET"
  }
);

หากดำเนินการสำเร็จ คุณจะเห็นการตอบกลับ JSON ต่อไปนี้

{
  "adBreaks": [
    {
      "name": "networks/.../liveStreamEventsByAssetKey/.../adBreaks/mid-roll-1",
      "adBreakId": "mid-roll-1",
      "assetKey": "...",
      "expectedStartTime": "2025-03-06T16:00:00Z",
      "duration": "30s",
      "breakState": "DECISIONED",
      "breakSequence": "1"
    }
  ]
}

หากต้องการกำหนดเวลาช่วงพักโฆษณาปัจจุบันให้เร็วขึ้น ให้ใช้วิธี Patch เพื่อเปลี่ยนเวลาเริ่มต้นที่คาดไว้ หากต้องการยกเลิกช่วงพักโฆษณาปัจจุบัน ให้ใช้วิธี Delete ก่อนสถานะเป็น COMPLETED

หากต้องการสร้างช่วงพักโฆษณาอีก ให้รอจนกว่าสถานะของช่วงพักโฆษณาปัจจุบันจะCOMPLETED