设置 JavaScript 2.x set-up-javascript

先决条件

  • 获取有效配置参数
    在设置 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 实例。

    使用 MediaHeartbeatConfigMediaHeartbeatDelegate 创建 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