瞭解 DAI 廣告插播 API

您可以使用動態廣告插播 (DAI) Ad Break API,建立及管理直播中即將放送的廣告插播時間點和指定廣告目標資料。

您可以使用 DAI Ad Break API 執行下列操作:

  • 在流量高峰期提高廣告供應率:讓 DAI 服務有更多時間為直播活動選取收益最高的廣告。如果直播活動有高並行、動態廣告代碼或高延遲廣告,建議使用 DAI 廣告插播 API。
  • 全面控管廣告插播:預先建立、更新及刪除廣告插播,比在資訊清單中設定廣告信號更靈活,且與即時決策相比,廣告連播放送的供應率更高。
  • 提供不中斷的觀看體驗:提供精確的插播資訊,盡量減少與廣告相關的播放錯誤,例如廣告連播未填滿或超額。

本指南說明 DAI Ad Break API 方法,並逐步介紹 DAI 全套服務和廣告連播放送流程的廣告插播生命週期。

瞭解 DAI 廣告插播 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:廣告插播已向使用者放送。
  • BREAK_STATE_EXPIRED:廣告插播時間點在放送前已過期。僅適用於啟用多個廣告插播排程的直播活動。詳情請參閱「片中廣告插播時間點設定」。根據預設,廣告插播會在 expectedStartTime 欄位值 30 分鐘後到期,如果未設定 expectedStartTime 欄位,則會在決策開始 30 分鐘後到期。您可以使用 expireDuration 欄位自訂這段時間。

下圖顯示 AdBreak 實體從建立到完成的時間軸。

廣告插播實體從建立到完成。

您可以在廣告插播預計開始前 1 到 300 分鐘內,建立 AdBreak 實體。

  • 請避免在廣告插播預計開始時間前不到一分鐘建立廣告插播,因為 Google DAI 可能沒有足夠的時間做出廣告決策,導致廣告供應率降低。
  • 請避免在廣告插播預計開始時間前 6 小時以上建立廣告插播,因為廣告伺服器可能會將請求的廣告判定為無效。

下列各節將說明 DAI 完整服務和廣告連播放送流程中的廣告插播狀態轉換。

瞭解全方位服務 DAI 流程

Google 全方位服務 DAI 會同時管理內容資訊清單和廣告連播。

如要自訂廣告指定目標,請使用 DAI Ad Break API,在內容直播資訊清單中對應的廣告標記之前,建立 AdBreak 實體。

  • 這段前置時間可讓 Google DAI 服務使用您的 AdBreak 資料,做出廣告決策。
  • Google DAI 偵測到資訊清單廣告標記時,系統會使用 AdBreak 實體資料做出廣告決策,並將實體狀態轉換為 BREAK_STATE_COMPLETE。

在直播活動啟用多廣告插播排程後,您可以在 AdBreak 實體上設定 matchParams 欄位。這項程序可讓 Google DAI 將偵測到的資訊清單廣告標記,與 BREAK_STATE_SCHEDULED 或 BREAK_STATE_DECISIONED 狀態的廣告插播時間點進行比對。

全服務 DAI 流程中,廣告插播實體從建立到完成的過程。

瞭解 Pod 放送流程

在這個流程中,您會管理內容直播資訊清單,或使用第三方資訊清單修改工具服務,偵測資訊清單中的廣告標記。

在廣告插播的預計開始時間前,呼叫 DAI Ad Break API,在需要請求廣告連播區隔或廣告資訊清單前,建立 AdBreak 實體。

當 Video Stitcher 偵測到資訊清單廣告標記,並使用廣告插播 ID 提出廣告區隔請求時,Google DAI 會使用具有相同 ID 的 AdBreak 資料來決定廣告。

用戶端要求廣告媒體後,您透過 API 建立的 AdBreak 實體會轉換為 BREAK_STATE_COMPLETE 狀態。

廣告插播實體完成狀態。

發出第一項要求

如要設定 API 存取權並提出第一個要求,請參閱「使用 DAI 廣告插播 API」。