使用JavaScript安裝Media Analytics install-web-sdks

本頁資訊說明如何安裝獨立 Web SDK 和設定 JavaScript。

或者,您可以使用 Adobe Media Analytics 擴充功能來實施 Analytics,如使用 Media Analytics 擴充功能實施 Analytics 中所述。

先決條件 prerequesites

  • 取得有效設定參數

    設定 Analytics 帳戶之後,可以向 Adobe 代表取得這些參數。

  • 在您的媒體應用程式中實作 JavaScript 適用的 AppMeasurementExperience Cloud Identity Service

    如需詳細資訊,請參閱使用 JavaScript 實作 Analytics實作 Experience Cloud 身分識別服務

  • 在您的媒體播放器中包含以下 API

    • 訂閱播放器事件專用的 API - 當您的播放器中發生事件時,Media SDK 需要您呼叫一組簡易 API。
    • 提供播放器資訊的 API - 這包含目前播放的媒體、廣告和章節之相關資訊。

設定 JavaScript 3.x set-up-javascript

  1. 下載的程式庫新增至專案。為方便起見,請建立類別的本機參照。

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

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

    3. 主控 MediaSDK.js 檔案。

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

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

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

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

      note note
      NOTE
      JavaScript SDK 符合 AMD 和 CommonJS 模組規格,MediaSDK.js 也可以與相容的模組載入器搭配使用。
  2. 建立 AppMeasurement 的例項和設定 visitor

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

    code language-js
     var appMeasurement = new AppMeasurement("<rsid>");
     appMeasurement.visitor = visitor;
     appMeasurement.trackingServer = "<visitor_namespace>.sc.omtrdc.net";
    
  3. 設定 Media SDK

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

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

    以下示範 MediaConfig 初始化:

    code language-js
     // 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 例項。

    code language-js
    var tracker = ADB.Media.getInstance();
    
    note important
    IMPORTANT
    請確保您的 tracker 例項可供存取,並且不會在媒體工作階段結束前遭到取消配置。此例項將用於為該工作階段追蹤下列所有事件。

從 JavaScript 2.x 移轉至 3.x

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

如需舊版內容,請參閱舊版實作

recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb