追蹤廣告
廣告播放追蹤涵蓋廣告插播、廣告開始、廣告完成，以及廣告略過。 使用媒體播放器的API來識別關鍵播放器事件，並填入必要的廣告變數。
播放器事件
播放器事件
動作
廣告插播開始
建立廣告插播物件；呼叫AdBreakStart
廣告開始
建立廣告物件；呼叫AdStart
廣告完成
呼叫Adcomplete
廣告略過
呼叫AdSkip
廣告插播完成
呼叫AdBreakComplete
實作步驟
- 識別廣告插播界限何時開始（包括前段），並建立廣告插播物件。 如需欄位定義，請參閱廣告插播名稱和廣告插播開始時間。
- 呼叫廣告插播開始以開始追蹤廣告插播。
- 識別廣告何時開始並建立廣告物件。 如需欄位定義，請參閱廣告名稱、廣告識別碼、廣告長度、Pod位置中的廣告以及廣告播放器名稱。
- 可選擇附加標準廣告中繼資料。 如需可用的金鑰，請參閱廣告商、促銷活動ID、Creative ID、Creative URL、位置ID以及網站ID。
- 呼叫廣告開始以開始追蹤廣告。
- 當廣告播放到完成時，請呼叫廣告完成。
- 如果檢視器略過廣告，請呼叫廣告略過而非廣告完成。
- 對於相同廣告插播中的其他廣告，請重複步驟3到7。
- 當廣告插播完成時，請呼叫廣告插播完成。
IMPORTANT
前段廣告：請勿在
AdBreakStart和AdStart之前呼叫trackPlay。 主要內容增量內容開始上的前play個Ping。 如果在前段廣告事件引發之前呼叫trackPlay，且檢視者在廣告期間退出，則即使未播放任何主要內容，內容開始次數也會增加。 對於前段案例，延遲trackPlay直到傳送AdBreakStart和AdStart之後。NOTE
廣告播放期間報告的播放點值代表檢視者在 主要內容 中的位置，而非廣告中的位置。 對於10分鐘視訊之前的前段廣告，整個廣告的播放點都是
0。 對於以5分鐘標籤開始的中段廣告，播放點在廣告期間維持在300 （秒）。常見問題
廣告之間非預期的main:play呼叫
如果您看到在連續廣告之間發生main:play個呼叫，則AdComplete呼叫與下一個AdStart呼叫之間會存在超過250毫秒的間隙。 發生此間隔時，Media SDK會退回傳送主要內容Ping，這樣可針對前段案例提早設定內容開始量度。
原因： Media SDK未設定廣告資訊，且播放器處於播放狀態，因此會將間隔期間計入主要內容。
解決方法：延遲每個廣告的AdComplete呼叫（最後一個除外），而不是在廣告結束時立即呼叫。 依下列方式批次處理呼叫：
- 在每個 廣告開始 時：如果先前的廣告存在且尚未標籤為完成，請呼叫新廣告的AdComplete before。
- 在每個 廣告資產結束 時：不要立即呼叫AdComplete — 延遲。
- 在廣告插播完成：呼叫最後一個廣告的AdComplete （如果尚未呼叫），然後呼叫AdBreakComplete。
此模式可確保AdComplete和下一個AdStart會連續引發，消除任何間隙。
recommendation-more-help
media-analytics-help