您可以使用動態廣告插播 (DAI) 串流活動監控器 (SAM) API,檢查個別直播和隨選影片 (VOD) 觀看工作階段,並排解相關問題。
如要目視檢查及排解個別直播或 VOD 觀看工作階段的問題,請使用 Google Ad Manager 使用者介面中的串流播放活動監控器。如要透過程式輔助方式擷取工作階段的診斷資料,請使用 Ad Manager API networks.daiSessions 資源。
瞭解用途
您可以使用 SAM API 自動診斷串流,並解決 DAI 整合中的廣告放送問題,例如:
- 驗證串流工作階段建立:確認 Google DAI 在建立直播或 VOD 工作階段時,收到的參數、
STITCHED或POD_SERVING的拼接模式、報表模式和內容中繼資料。 - 稽核廣告請求和回應:檢查傳出的影片廣告放送範本 (VAST) 和影片多重廣告播放清單 (VMAP) 廣告代碼、HTTP 狀態碼、回應延遲時間、原始 XML 回應主體,以及包裝函式重新導向鏈。
- 排解廣告連播決策和廣告素材問題:確認 Google DAI 為每個廣告連播選取或捨棄的廣告、廣告連播中每個廣告的時間長度,以及廣告素材的來源廣告系統。
- 追蹤廣告預先擷取執行情形:判斷 Google DAI 是否預先擷取廣告連播,並查看每個廣告連播的預先擷取階段。
- 驗證 DAI 廣告插播 API 和廣告連播放送 DAI API 呼叫:根據 API 呼叫 (例如 DAI 廣告插播 API 和廣告連播放送 DAI API),檢查實際的廣告插播執行、放送的廣告時間長度,以及插入的插入畫面時間長度。
- 驗證廣告事件追蹤:確認用戶端或伺服器端追蹤連線偵測 (ping) 是否成功,並檢查廣告伺服器的 HTTP 回應。
- 自動監控工作階段並發出快訊:剖析嚴重程度為
INFO、WARNING或ERROR的結構化發現項目,在自動化整合測試和正式版監控管道中偵測播放或營利問題。
瞭解頂層資源
SAM API 是 admanager.googleapis.com 端點上 Google Ad Manager REST API (Beta 版) 的一部分,並公開 networks.daiSessions.get 唯讀方法。您可以使用 DAI 工作階段 ID 或自訂偵錯鍵,查詢 DaiSession 資源。DAI 會在播放後保留工作階段記錄最多三天。
SAM API 不支援列出 Google Ad Manager 聯播網中的所有 DaiSession 資源。
使用 SAM 檢查 DAI 串流回應
如要確認 Google DAI 如何處理串流請求,請檢查 DaiSession 回應:
- 全服務 DAI API:檢查
creationContext.streamCreateRequest欄位,驗證串流註冊呼叫;查看adSelections和adPods對應,檢查廣告決策;以及檢查adBreaks對應,確認拼接廣告、字卡廣告素材和基本內容時間長度。 - 廣告連播放送 DAI API:確認
creationContext.stitchingType欄位已設為POD_SERVING值,交叉比對adPods和adBreaks對應中的adBreakId欄位與廣告連播資訊清單或廣告連播片段要求呼叫,並檢查trackingPings對應中的伺服器端或媒體驗證信標。 - DAI 廣告插播時間點 API:比對
AdBreak物件的breakSequence值與AdBreak.breakSequence屬性。
發出第一項要求
如要設定驗證及擷取 DAI 工作階段資源,請參閱「使用串流播放活動監控器 API」。