Show Menu
主題×

使用JavaScript 3.x追蹤廣告

下列指示提供使用 3.x SDK 實作的指引。If you are implementing any previous versions of the SDK, you can download the Developers Guides here: Download SDKs.

廣告追蹤常數

常數名稱
說明
AdBreakStart
用於追蹤廣告插播開始事件的常數
AdBreakComplete
用於追蹤廣告插播事件的常數
AdStart
用於追蹤廣告開始事件的常數
AdComplete
用於追蹤廣告完成事件的常數
AdSkip
用於追蹤廣告略過事件的常數

實施步驟

  1. 識別廣告插播界限何時開始 (包括前段),並使用廣告插播資訊建立
    AdBreakObject
    AdBreakObject
    參考資料:
    變數名稱
    類型
    說明
    name
    string
    非空字串,表示adbreak名稱(前段、中間段和後段)。
    position
    數字
    廣告插播的編號位置從 1 開始。
    startTime
    數字
    廣告插播開始時的播放點值。
    廣告插播物件建立:
    var adBreakObject = ADB.Media.createAdBreakObject(<ADBREAK_NAME>, <POSITION>, <START_TIME>);
  2. MediaHeartbeat
    例項中使用
    AdBreakStart
    呼叫
    trackEvent()
    以開始追蹤廣告插播。
    tracker.trackEvent(ADB.Media.Event.AdBreakStart, adBreakObject);
  3. 識別廣告何時開始,並使用廣告資訊建立
    AdObject
    例項。
    AdObject
    參考資料:
    變數名稱
    類型
    說明
    name
    string
    表示廣告名稱的非空字串。
    adId
    string
    表示廣告識別碼的非空字串。
    position
    數字
    廣告在adbreak中的數目位置,從1開始。
    length
    數字
    表示廣告長度的正數。
    廣告物件建立:
    var adObject = ADB.Media.createAdObject.createAdObject(<AD_NAME>, <AD_ID>, <POSITION>, <LENGTH>);
  4. 可選擇透過內容資料變數,將標準和/或廣告中繼資料附加到媒體追蹤工作階段。
    • 自訂廣告中繼資料 -
      對於自訂中繼資料,請建立自訂資料變數的變數物件,並填入目前廣告的資料:
      /* Set context data */ // Standard metadata keys provided by adobe. adMetadata[ADB.Media.AdMetadataKeys.ADVERTISER] ="Sample Advertiser"; adMetadata[ADB.Media.AdMetadataKeys.CAMPAIGN_ID] = "Sample Campaign"; // Custom metadata keys adMetadata["affiliate"] = "Sample affiliate"; adMetadata["campaign"] = "Sample ad campaign"; adMetadata["creative"] = "Sample creative";
  5. MediaHeartbeat
    例項中使用
    AdStart
    事件呼叫
    trackEvent()
    以開始追蹤廣告播放。
    將參考加入您的自訂中繼資料變數 (或空白物件),作為事件呼叫中的第三個參數:
    _onAdStart = function() { tracker.trackEvent(ADB.Media.Event.AdStart, adObject, adMetadata); };
  6. 當廣告播放達到廣告結尾時,請使用
    AdComplete
    事件呼叫
    trackEvent()
    :
    _onAdComplete = function() { tracker.trackEvent(ADB.Media.Event.AdComplete); };
  7. 如果由於使用者選擇略過廣告而導致廣告播放未完成,請追蹤
    AdSkip
    事件:
    _onAdSkip = function() { tracker.trackEvent(ADB.Media.Event.AdSkip); };
  8. 如果在相同
    AdBreak
    內有任何其他廣告,請再次重複步驟 3 到 7。
  9. 當廣告插播完成時,請使用
    AdBreakComplete
    事件進行追蹤:
    _onAdBreakComplete = function() { tracker.trackEvent(ADB.Media.Event.AdBreakComplete); };
如需詳細資訊,請參閱追蹤案例 具有前段廣告的 VOD 播放