使用 JavaScript 3.x 追蹤廣告

下列指示提供使用 3.x SDK 實作的指引。

廣告追蹤常數

實作步驟

1. 識別廣告插播界限何時開始 (包括前段)，並使用廣告插播資訊建立 AdBreakObject。

   AdBreakObject 參考資料：

   變數名稱	類型	說明
   name	字串	表示廣告插播名稱 (前段、中段和後段) 的非空白字串。
   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	字串	表示廣告名稱的非空白字串。
   adId	字串	表示廣告識別碼的非空白字串。
   position	數字	廣告插播中的廣告編號位置從 1 開始。
   length	數字	表示廣告長度的正數。

   廣告物件建立：

   var adObject =
     ADB.Media.createAdObject.createAdObject(<AD_NAME>,
                                   <AD_ID>,
                                   <POSITION>,
                                   <LENGTH>);
   

4. （選用）透過內容資料變數，將標準和/或廣告中繼資料附加到媒體追蹤工作階段。

   • 在 JavaScript 上實作標準廣告中繼資料

   • 自訂廣告中繼資料 - 對於自訂中繼資料，請建立自訂資料變數的變數物件，並填入目前廣告的資料：

     /* Set context data */
     // Standard metadata keys provided by adobe.
     adMetadata[ADB.Media.AdMetadataKeys]  ="Sample Advertiser";
     adMetadata[ADB.Media.AdMetadataKeys] = "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 播放。

精細的廣告追蹤

預設廣告Ping間隔為 10 seconds.

您可以設定精細的廣告追蹤，以啟用 1 second 廣告追蹤。

語法

ADB.Media.MediaObjectKey = {
   GranularAdTracking: "media.granularadtracking"
   }

範例

var mediaObject = ADB.Media.createMediaObject("media-name", "media-id", 60, ADB.Media.StreamType.VOD, ADB.Media.MediaType.Video);

// Enable granular ad tracking
mediaObject[ADB.Media.MediaObjectKey.GranularAdTracking] = true;

tracker.trackSessionStart(mediaObject);