使用JavaScript安装Media Analytics

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

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

先决条件

  • 获取有效的配置参数

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

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

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

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

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

设置 JavaScript 3.x

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

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

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

    3. 托管 MediaSDK.js 文件。

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

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

    重要

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

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

    在媒体会话结束前，请确保您的 tracker 实例可以访问且未被取消分配。此实例将用于跟踪该会话的以下所有事件。

从 JavaScript 2.x 迁移到 3.x

有关从 2.x 迁移到 3.x 的详细信息，请参阅从 2.x 迁移到 3.x。

有关旧版内容，请参阅旧版实施

在此页面上