文件Analytics串流媒體收集指南

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

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主題：

建立對象：

  • 使用者
  • 管理員
  • 開發人員

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

或者，您可以使用Adobe Medium Analytics擴充功能來實施Adobe串流媒體收集附加元件，如使用Media Analytics擴充功能實施Analytics中所述。

先決條件 prerequesites

  • 取得有效設定參數

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

  • 在您的媒體應用程式中實作 JavaScript 適用的 AppMeasurement 和 Experience 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 設定需要已設定 visitor 的 AppMeasurement 例項。

    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