傳送即將到來的廣告插播通知

Google 動態廣告插播 (DAI) 支援高並行度的直播。即將到來的廣告插播通知 (EABN) 是要求 Google DAI 排定即將到來的廣告插播時間，或立即開始廣告決策，以便同時改善廣告放送率和載入時間。

如要開始針對完整服務、廣告群組放送或伺服器引導廣告插播傳送即將到來的廣告插播通知，請使用 AdBreaks 資源。這個資源可為您透過 Google Ad Manager UI 或 Google Ad Manager SOAP API LiveStreamEventService 建立的所有直播建立及管理廣告插播。

本頁說明如何將廣告插播排定為即將到來的廣告插播通知。

必要條件

如要建立或管理廣告插播，您需要直播系統產生的素材資源金鑰或自訂素材資源金鑰。你也可以在直播詳細資料頁面上找到這些金鑰。請參閱「設定動態廣告插播直播」一文，瞭解如何使用 Google Ad Manager 使用者介面。

排定廣告插播

你可以在直播觀眾人數增加時，排定廣告插播時間。針對每個直播活動，使用 Create 服務方法，提前最多六小時單獨排定一個插播時間點。請附上預期的開始時間和廣告插播 ID。DAI 會在接近排定時間時開始做出廣告決策。如要做出即時廣告插播決策，請省略廣告插播預期開始時間。

如要立即讓 Google DAI 開始廣告決策，您可以在呼叫 Create 時省略廣告插播的預期開始時間。

以下範例會為 Linear 類型的直播活動安排廣告插播，時間為 2025 年 3 月 6 日下午 4 點 (世界標準時間)：

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 方法變更預期的開始時間。如果您想取消目前的廣告插播，請在狀態為 COMPLETED 之前使用 Delete 方法。

如要建立其他廣告插播，請等到目前廣告插播的狀態為 COMPLETED。