設定 JavaScript 3.x

必備條件

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

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

     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。

本頁內容