使用 JavaScript 2.x 追蹤廣告 track-ads-on-javascript
下列指示提供使用 2.x SDK 實作的指引。
IMPORTANT
若您正在實作 SDK 1.x 版,您可以在此處下載 1.x 開發人員指南:下載 SDK。
廣告追蹤常數
常數名稱
說明
AdBreakStart用於追蹤廣告插播開始事件的常數
AdBreakComplete用於追蹤廣告插播事件的常數
AdStart用於追蹤廣告開始事件的常數
AdComplete用於追蹤廣告完成事件的常數
AdSkip用於追蹤廣告略過事件的常數
實作步驟
-
識別廣告插播界限何時開始 (包括前段),並使用廣告插播資訊建立
AdBreakObject。AdBreakObject參考資料:table 0-row-3 1-row-3 2-row-3 3-row-3 3-align-center 7-align-center 11-align-center 15-align-center 變數名稱 說明 必填 name廣告插播名稱,例如前段、中段和後段。 是 position廣告插播的編號位置從 1 開始。 是 startTime廣告插播開始時的播放點值。 是 廣告插播物件建立:
code language-js var adBreakObject = MediaHeartbeat.createAdBreakObject(<ADBREAK_NAME>, <POSITION>, <START_TIME>); -
在
MediaHeartbeat例項中使用AdBreakStart呼叫trackEvent()以開始追蹤廣告插播。code language-js mediaHeartbeat.trackEvent(MediaHeartbeat.Event.AdBreakStart, adBreakObject); -
識別廣告何時開始,並使用廣告資訊建立
AdObject例項。AdObject參考資料:table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 3-align-center 7-align-center 11-align-center 15-align-center 19-align-center 變數名稱 說明 必填 name廣告的易記名稱。 是 adId廣告的唯一識別碼。 是 position廣告插播中的廣告編號位置從 1 開始。 是 length廣告長度 是 廣告物件建立:
code language-js var adObject = MediaHeartbeat.createAdObject(<AD_NAME>, <AD_ID>, <POSITION>, <LENGTH>); -
可選擇透過內容資料變數,將標準和/或廣告中繼資料附加到媒體追蹤工作階段。
-
自訂廣告中繼資料 - 對於自訂中繼資料,請建立自訂資料變數的變數物件,並填入目前廣告的資料:
code language-js /* Set custom context data */ var adCustomMetadata = { affiliate: "Sample affiliate", campaign: "Sample ad campaign", creative: "Sample creative" };
-
在
MediaHeartbeat例項中使用AdStart事件呼叫trackEvent()以開始追蹤廣告播放。將參考加入您的自訂中繼資料變數 (或空白物件),作為事件呼叫中的第三個參數:
code language-js _onAdStart = function() { this._mediaHeartbeat.trackEvent(MediaHeartbeat.Event.AdStart, adObject, adCustomMetadata); }; -
當廣告播放達到廣告結尾時,請使用
AdComplete事件呼叫trackEvent():code language-js _onAdComplete = function() { this._mediaHeartbeat.trackEvent(MediaHeartbeat.Event.AdComplete); }; -
如果由於使用者選擇略過廣告而導致廣告播放未完成,請追蹤
AdSkip事件:code language-js _onAdSkip = function() { this._mediaHeartbeat.trackEvent(MediaHeartbeat.Event.AdSkip); }; -
如果在相同
AdBreak內有任何其他廣告,請再次重複步驟 3 到 7。 -
當廣告插播完成時,請使用
AdBreakComplete事件進行追蹤:code language-js _onAdBreakComplete = function() { this._mediaHeartbeat.trackEvent(MediaHeartbeat.Event.AdBreakComplete); };
如需詳細資訊,請參閱追蹤案例具有前段廣告的 VOD 播放。
recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb