Pod Serving API 可讓您存取準備的自動調整位元率影片廣告連播,以便對方可以直接拼接成向使用者顯示的 HLS 或 MPEG DASH 媒體播放清單。
這個 API 適合進階發布商和影片技術合作夥伴使用。大規模使用這個 API 需要設計及實作精密的媒體供應工作流程,但這不包含在本說明文件的範圍內。
必要條件
您需要先使用 Google Ad Manager UI 或直播活動 API 建立直播活動,再透過 DAI Podserving API 處理直播。
元件
所有 Pod Serving API 實作程序包含三個元件:Google Ad Manager、用戶端影片播放器和資訊清單操控伺服器。
Ad Manager
Ad Manager 負責向使用者放送廣告,並可透過 Ad Manager SDK 或其網頁介面管理。服務應負以下責任:
- 接收來自用戶端影片播放器的串流請求、決策廣告,並提供符合內容編碼設定檔的指令
- 回應用戶端影片播放器發出的廣告片段請求,並提供廣告連播的適當部分給特定使用者
- 接收及處理來自用戶端影片播放器的追蹤連線偵測 (ping)
客戶影片播放器
用戶端影片播放器是指客戶用來播放結果影片串流的應用程式或網站。玩家必須負起以下責任:
- 初始化 Ad Manager 的串流資源,並接收代表特定直播活動中單一播放工作階段的串流物件。
- 從資訊清單操控伺服器要求串流資訊清單,並啟動播放
- 定期從 Ad Manager 輪詢廣告連播中繼資料,以便說明串流廣告區隔中內嵌的廣告事件
- 監聽包含廣告媒體 ID 的播放器所引發的定時中繼資料事件。遇到這些事件後,播放器會將他們轉送至 Ad Manager,確認廣告事件是否已成功發生。
如要進一步瞭解如何正確實作用戶端影片播放器,請參閱您平台適用的廣告連播放送指南:
如需自訂導入作業,請參閱 DAI API 的廣告連播放送用戶端指南。
資訊清單操控伺服器
資訊清單操控伺服器是負責代管提供給用戶端影片播放器串流資訊清單的伺服器。伺服器具有以下責任:
- 處理向用戶端影片播放器傳送資訊清單
- 從 Ad Manager 要求時段範本 (僅適用於 MPEG DASH 串流),以填入廣告區隔。
- 將 Ad Manager 代管的廣告區隔網址插入影片串流資訊清單 (適用於 HLS) 或廣告插播期間的廣告時段 (適用於 MPEG DASH)。
- 將修改後的資訊清單提供給用戶端影片播放器。
如要進一步瞭解如何實作自訂資訊清單操控器伺服器,請參閱資訊清單操控指南。
詞彙
- 直播活動:儲存直播活動的重要設定資料 (例如編碼設定檔) 的事件。直播活動是使用 Ad Manager 建立。
- 串流物件:代表特定影片資產單一播放工作階段的物件。重要屬性包含串流 ID 和媒體驗證網址。
- 廣告連播:廣告時段中顯示的廣告影片分組
- 廣告區隔:廣告插播的媒體區隔檔案
- 廣告連播中繼資料:用來在用戶端顯示廣告 UI 的廣告插播中繼資料;例如在廣告期間隱藏搜尋按鈕
- 廣告媒體 ID:在廣告區隔檔案中編碼為 ID3 代碼的中繼資料。這項中繼資料用於識別播放期間發生特定廣告相關事件的時間,例如廣告開始或播到一半。