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

本页上的信息描述如何安装 Web 独立 SDK 和设置 JavaScript。

或者,还可使用 Adobe Media Analytics 扩展实施 Analytics,如使用 Media Analytics 扩展实施 Analytics 中所述。

先决条件 prerequesites

  • 获取有效的配置参数

    在设置分析帐户后,这些参数可以从 Adobe 代表获取。

  • 在媒体应用程序中实施适用于 JavaScript 的 AppMeasurementExperience Cloud Identity Service

    有关更多信息,请参阅使用 JavaScript 实施 Analytics实施 Experience Cloud Identity Service

  • 在媒体播放器中包含以下 API

    • 用于订阅播放器事件的 API – Media SDK 要求在播放器中发生事件时调用一组简单的 API。
    • 提供播放器信息的 API – 其中包括有关当前播放的媒体、广告和章节的信息。

设置 JavaScript 3.x set-up-javascript

  1. 下载的库添加到您的项目中。为方便起见,请创建对类的本地引用。

    1. 展开您下载的 MediaSDK-js-v3*.zip 文件。

    2. 验证 MediaSDK.js 文件存在于 libs 目录中。

    3. 托管 MediaSDK.js 文件。

      此核心 JavaScript 文件必须在一个您站点的所有页面都能访问的 Web 服务器上托管。您需要具有这些文件的路径才能进行下一步操作。

    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,并且该配置适用于创建的所有跟踪器实例。

    note important
    IMPORTANT
    Media SDK (3.x) 使用媒体收集 API 跟踪媒体,该 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 创建用于跟踪媒体内容的跟踪器实例。

    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