廣告中繼資料

本指南說明 Video Stitcher API 支援的廣告中繼資料功能。廣告中繼資料會從廣告代碼回應中的 VAST 廣告中擷取，其中包含廣告追蹤事件和隨播廣告。廣告代碼網址是在工作階段建立要求中設定。詳情請參閱「管理直播工作階段」和「管理隨選即播工作階段」。

事前準備

請務必熟悉 Video Stitcher API 中的入門概念和術語。詳情請參閱技術總覽。

廣告中繼資料包含與拼接廣告相關的廣告追蹤事件和隨附廣告。廣告追蹤事件包含回呼 ping，用於追蹤 VAST 廣告和觀眾互動情形。隨播廣告是用來補充父項 VAST 廣告的廣告。在用戶端追蹤模式中，您必須根據觀眾的行為觸發事件。

在伺服器端追蹤模式中，每個廣告片段 URI 都會包裝在重新導向 URI 中，而 Video Stitcher API 會在播放器要求這些片段時處理進度事件。不過，Video Stitcher API 不會處理活動事件，例如 pause。

在用戶端追蹤模式中，用戶端負責觸發事件。詳情請參閱事件說明文件。

進度事件是指在廣告播放期間經過指定時間後觸發的事件。舉例來說，事件 Start 應在廣告開始時觸發。如要進一步瞭解進度事件，請參閱進度事件物件。

活動事件是指觀眾進行特定活動時應觸發的事件。舉例來說，當觀眾暫停廣告影片時，應觸發 pause 事件。如要進一步瞭解活動事件，請參閱活動事件物件。

系統會在 VOD 工作階段建立要求的回應中傳回插播廣告物件。如需建立 VOD 工作階段的操作說明，請參閱如何建立 VOD 工作階段。

插頁式廣告包含每個插入廣告的中繼資料。啟用用戶端廣告追蹤模式後，用戶端必須負責在必要時觸發追蹤事件。詳情請參閱插頁物件。

Video Stitcher API 會持續在直播中插入廣告，每次插入新廣告時，系統就會產生廣告中繼資料資訊。

對於 HLS，您可以在 #EXT-X-DATERANGE 標記中找到用於擷取廣告中繼資料的 AdMetadataURI。

針對 DASH，您可以在每個 <Period> 元素的 <EventStream> 元素中，找到用於擷取廣告中繼資料的 AdMetadataURI。

隨播廣告是可與插入的線性廣告一併顯示的輔助廣告。詳情請參閱隨附廣告物件。