文档Analytics流媒体集合指南

设置 JavaScript 2.x set-up-javascript

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

创建对象：

  • 用户
  • 管理员
  • 开发人员

先决条件

  • 获取有效配置参数
    在设置 Analytics 帐户后，您可以从 Adobe 代表处获取这些参数。

  • 在媒体应用程序中实施适用于 JavaScript 的 AppMeasurement
    有关 Adobe Mobile SDK 文档的更多信息，请参阅使用 JavaScript 实施 Analytics。

  • 在媒体播放器中提供以下功能：

    • 用于订阅播放器事件的 API - Media SDK 要求在播放器中发生事件时调用一组简单的 API。
    • 提供播放器信息的 API - 此信息包括媒体名称和播放头位置等详细信息。

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

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

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

    3. 托管 MediaSDK.min.js 文件。

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

    4. 在所有网站页面上引用 MediaSDK.min.js。

      通过将下面一行代码添加到每个页面的 <head> 或 <body> 标记中，加入适用于 JavaScript 的 MediaSDK。例如：

      code language-none 
      <script type="text/javascript"
src="https://INSERT-DOMAIN-AND-PATH-TO-CODE-HERE/MediaSDK.min.js"></script>

    5. 要快速验证是否成功导入了库，请实例化 ADB.va.MediaHeartbeatConfig 类。

      note note
      NOTE
      从版本 2.1.0 开始，JavaScript SDK 遵循 AMD 和 CommonJS 模块规范，并且 VideoHeartbeat.min.js 也可以与兼容的模块加载器一起使用。

  2. 为便于访问 API，请创建对 MediaHeartbeat 类的本地引用。

    code language-js 
    var MediaHeartbeat = ADB.va.MediaHeartbeat;
var MediaHeartbeatConfig = ADB.va.MediaHeartbeatConfig;
var MediaHeartbeatDelegate = ADB.va.MediaHeartbeatDelegate;

  3. 创建一个 MediaHeartbeatConfig 实例。

    本节将帮助您了解 MediaHeartbeat 配置参数以及如何在您的 MediaHeartbeat 实例中设置正确的配置值，以便进行准确跟踪。

    以下是 MediaHeartbeatConfig 初始化示例：

    code language-js 
    //Media Heartbeat initialization
var mediaConfig = new MediaHeartbeatConfig();
mediaConfig.trackingServer = Configuration.HEARTBEAT.TRACKING_SERVER;
mediaConfig.playerName = Configuration.PLAYER.NAME;
mediaConfig.channel = Configuration.HEARTBEAT.CHANNEL;
mediaConfig.debugLogging = true;
mediaConfig.appVersion = Configuration.HEARTBEAT.SDK;
mediaConfig.ssl = false;
mediaConfig.ovp = Configuration.HEARTBEAT.OVP;

  4. 实施 MediaHeartbeatDelegate 协议。

    code language-js 
    var mediaDelegate = new MediaHeartbeatDelegate();

// Replace <currentPlaybackTime> with the video player current playback time
mediaDelegate.getCurrentPlaybackTime = function() {
    return <currentPlaybackTime>;
};

// Replace <bitrate>, <startuptime>, <fps> and <droppeFrames> with the current playback QoS values.
mediaDelegate.getQoSObject = function() {
    return MediaHeartbeat.createQoSObject(<bitrate>, <startuptime>, <fps>, <droppedFrames>);
};

  5. 创建 MediaHeartbeat 实例。

    使用 MediaHeartbeatConfig 和 MediaHeartbeatDelegate 创建 MediaHeartbeat 实例。

    code language-js 
    this.mediaHeartbeat = new MediaHeartbeat(mediaDelegate, mediaConfig, appMeasurement);
    note important
    IMPORTANT
    在媒体会话结束前，请确保您的 MediaHeartbeat 实例可以访问且未被取消分配。此实例将用于以下所有的跟踪事件。
    note tip
    TIP
    MediaHeartbeat 需要 AppMeasurement 的实例，才能向 Adobe Analytics 发送调用。以下是 AppMeasurement 实例的示例：
    code language-js 
    var appMeasurement = new AppMeasurement();
appMeasurement.visitor = visitor;
appMeasurement.trackingServer = "<visitor_namespace>.sc.omtrdc.net";
appMeasurement.account = <rsid>;
appMeasurement.pageName = <page_name>;
appMeasurement.charSet = "UTF­8";

从 JavaScript 1.x 迁移到 2.x

在版本 2.x 中，所有公共方法都已合并到 ADB.va.MediaHeartbeat 类中，从而更加便于开发人员使用。此外，所有配置现在都已合并到 ADB.va.MediaHeartbeatConfig 类中。

有关从 1.x 迁移到 2.x 的信息，请参阅旧版实施文档。

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