設定 JavaScript 3.x

必備條件

  • 取得有效的設定參數
    在您設定分析帳戶後,即可從 Adobe 代表取得這些參數。

  • 在您的媒體應用程式實作 JavaScript 適用的AppMeasurementExperience Cloud Identity Service
    如需詳細資訊,請參閱使用 JavaScript 實作分析實作 Experience Cloud Identity Service。

  • 在您的媒體播放器中提供下列功能:

    • 訂閱播放器事件專用的 API - 當您的播放器中發生事件時,Media SDK 需要您呼叫一組簡易 API。
    • 提供播放器資訊的 API - 這包含目前播放的媒體、廣告、章節之相關資訊。
  1. 下載的程式庫新增至專案。為方便起見,請建立類別的本機參照。

    1. 展開您下載的 MediaSDK-js-v3*.zip 檔案。

    2. 驗證 libs 目錄中存在 MediaSDK.js 檔案。

    3. 主控 MediaSDK.js 檔案。

      此核心 JavaScript 檔案必須放置您網站所有頁面都能存取的網站伺服器上。下一個步驟需要用到前往這些檔案的路徑。

    4. 在所有網站頁面上參考 MediaSDK.js

      在每一頁的 <head><body> 標籤中新增下列程式碼行,加入 JavaScript 適用的 MediaSDK。例如:

      <script type="text/javascript" src="https://INSERT-DOMAIN-AND-PATH-TO-CODE-HERE/MediaSDK.js"></script>
      
    5. 若要快速確認程式庫是否已成功匯入,請確認 ADB.Media 是否已匯出至視窗物件。

      注意

      JavaScript SDK 符合 AMD 和 CommonJS 模組規格,MediaSDK.js 也可以與相容的模組載入器搭配使用。

  2. 建立 AppMeasurement 的例項和設定 visitor

    Media SDK 設定需要已設定 visitorAppMeasurement 例項。

     var appMeasurement = new AppMeasurement(“<rsid>”);
     appMeasurement.visitor = visitor;
     appMeasurement.trackingServer = “<visitor_namespace>.sc.omtrdc.net”;
    
  3. 設定 Media SDK

    每個網頁皆應設定 Media SDK 一次,且該設定將套用至所有已建立的 tracker 例項。

    重要

    Media SDK (3.x) 使用媒體收集 API 來追蹤與 2.x SDK 中使用之 HB 端點不同的媒體。請聯絡您的 Adobe 代表取得更多資訊。

    以下示範 MediaConfig 初始化:

     // Create MediaConfig object (same as above)
     var mediaConfig = new ADB.MediaConfig();
     mediaConfig.trackingServer = Configuration.MEDIA_COLLECTION_ENDPOINT;
     mediaConfig.playerName = Configuration.PLAYER_NAME;
     mediaConfig.channel = Configuration.CHANNEL;
     mediaConfig.appVersion = Configuration.APP_VERSION;
     mediaConfig.debugLogging = false;
     mediaConfig.ssl = true;
    
     ADB.Media.configure(mediaConfig, appMeasurement);
    
  4. 建立 MediaTracker 例項。

    設定 Media SDK 後,可使用 getInstance API 建立追蹤媒體內容的 tracker 例項。

    var tracker = ADB.Media.getInstance();
    
    重要

    請確保您的 tracker 例項可供存取,並且不會在媒體工作階段結束前遭到取消配置。此例項將用於為該工作階段追蹤下列所有事件。

從 JavaScript 2.x 移轉至 3.x

如需有關從 2.x 移轉至 3.x 的詳細資訊,請參閱從 2.x 移轉至 3.x

本頁內容

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now