在 Chromecast 上追蹤廣告

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

重要

若您正在實作 SDK 1.x 版，您可以在此處下載 1.x 開發人員指南：下載 SDK。

廣告追蹤常數

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

實作步驟

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

    廣告插播物件建立： createAdBreakObject

    adBreakInfo = ADBMobile.media.createAdBreakObject("First Ad-Break", 1, AD_BREAK_START_TIME, playerName);

  2. 在 MediaHeartbeat 例項中使用 AdBreakStart 呼叫 trackEvent() 以開始追蹤廣告插播：trackEvent

    ADBMobile.media.trackEvent(ADBMobile.media.Event.AdBreakStart, getAdBreakInfo());

  3. 識別廣告資產何時開始，並使用廣告資訊建立 AdObject 例項。

    廣告物件建立： createAdObject

    adInfo = ADBMobile.media.createAdObject("Sample ad", "001", 1, AD_LENGTH);

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

    • 標準廣告中繼資料 - 針對標準廣告中繼資料，請使用平台的索引鍵建立標準廣告中繼資料索引鍵值配對字典：
    • 自訂廣告中繼資料 - 對於自訂中繼資料，請建立自訂資料變數的變數物件，並填入目前廣告資產的資料：

  5. 使用 AdStart 事件呼叫 trackEvent() 以開始追蹤廣告播放。

    將參考加入您的自訂中繼資料變數 (或空白物件)，作為事件呼叫中的第三個參數：trackEvent

    ADBMobile.media.trackEvent(ADBMobile.media.Event.AdStart, getAdInfo(), adContextData);

  6. 當廣告資產播放達到廣告結尾時，請使用 AdComplete 事件呼叫 trackEvent()：trackEvent

    ADBMobile.media.trackEvent(ADBMobile.media.Event.AdComplete);

  7. 如果在相同 AdBreak 內有任何其他廣告，請再次重複步驟 3 到 6。

  8. 當廣告插播完成時，請使用 AdBreakComplete 事件進行追蹤：trackEvent

    ADBMobile.media.trackEvent(ADBMobile.media.Event.AdBreakComplete, getAdBreakInfo());

如需詳細資訊，請參閱追蹤案例具有前段廣告的 VOD 播放。

本頁內容