動態廣告插播 (DAI) 廣告插播 API 可讓您建立及管理直播中即將到來的廣告插播時間和廣告指定目標資料。
透過 DAI 廣告插播 API，您可以執行下列操作：
- 在流量高峰期間提高廣告放送率：讓動態廣告插播 (DAI) 服務有更多時間，為直播活動選取收益最高的廣告。如果直播活動有高並行、動態廣告代碼或高延遲廣告，建議使用 DAI Ad Break API。
- 全面掌控廣告插播：預先建立、更新及刪除廣告插播，與資訊清單內廣告信號相比，更具彈性；與即時決策相比，廣告連播的填充率更高。
- 提供不間斷的觀看體驗：提供準確的插播資訊，盡量減少廣告相關的播放錯誤，例如廣告插播不足或過多。
本指南說明 DAI 廣告插播 API 方法，並逐步介紹 DAI Full Service 和 Pod Serving 流程的廣告插播生命週期。
瞭解 DAI Ad Break API 方法
這個 API 提供下列標準方法，用於管理 AdBreak 資源：
Create：為LiveStreamEvent實體定義新的AdBreak實體。您可以選擇將expectedStartTime屬性設為在廣告插播開始前 60 秒內，排定廣告決策。Get：擷取特定AdBreak實體的詳細資料，包括廣告插播狀態和時間中繼資料。List：傳回先前使用 API 為指定LiveStreamEvent實體建立的AdBreak實體清單，並依時間順序反向排序。請注意，API 不會傳回僅在內容串流資訊清單中定義的廣告插斷。Update：在廣告決策開始前，修改現有的AdBreak實體。Delete：取消先前建立的AdBreak實體的廣告決策。
瞭解廣告插播生命週期
AdBreak 實體有下列幾種狀態：
BREAK_STATE_UNSPECIFIED：預設狀態。BREAK_STATE_SCHEDULED：廣告插播已成功建立，並排定時間進行廣告決策。BREAK_STATE_DECISIONED：DAI 服務已開始為廣告插播時間點選取廣告。您無法修改廣告插播，但仍可取消廣告插播，這可能會對廣告伺服器造成負面影響。
BREAK_STATE_COMPLETE：廣告插播已向使用者放送。
下圖顯示 AdBreak 實體的時間軸，從建立到完成。
您可以在預計廣告插播開始前 1 到 300 分鐘，建立 AdBreak 實體。
- 請避免在廣告插播預計開始時間前不到一分鐘建立廣告插播，因為 Google DAI 可能沒有足夠時間做出廣告決策，導致廣告填充率偏低。
- 請勿在廣告插播預計開始時間前 6 小時以上建立廣告插播，否則廣告伺服器可能會使要求的廣告失效。
下列各節說明 DAI Full Service 和 Pod Serving 流程中的廣告插播狀態轉換。
瞭解全方位服務 DAI 流程
Google Full service DAI 會管理內容資訊清單和廣告連播。
如要自訂廣告指定目標，請使用 DAI 廣告插播 API，在內容直播資訊清單中對應的廣告標記前，建立 AdBreak 實體。
- Google DAI 服務會在這段時間內使用您的
AdBreak資料，做出廣告決策。 - Google DAI 偵測到資訊清單廣告標記時，系統會使用
AdBreak實體資料做出廣告決策，並將實體狀態轉換為BREAK_STATE_COMPLETE。
瞭解 Pod 放送流程
在這個流程中，您可以管理內容直播資訊清單，或使用第三方資訊清單操弄服務，偵測資訊清單中的廣告標記。
在預計廣告插播開始時間前呼叫 DAI 廣告插播 API，以便在需要要求廣告插播片段或廣告資訊清單前，建立 AdBreak 實體。
影片縫合器偵測到資訊清單廣告標記，並使用廣告中斷 ID 提出廣告片段要求時，Google DAI 會使用具有相同 ID 的 AdBreak資料來決定廣告。
用戶端要求廣告媒體後，透過 API 建立的 AdBreak 實體會轉換為 BREAK_STATE_COMPLETE 狀態。
發出第一項要求
如要設定 API 存取權並發出第一筆要求，請參閱「使用 DAI 廣告插斷 API」。