Show Menu
主题×

设置 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
      。例如:
      <script type="text/javascript" src="https://INSERT-DOMAIN-AND-PATH-TO-CODE-HERE/MediaSDK.min.js"></script>
    5. 要快速验证是否成功导入了库,请实例化
      ADB.va.MediaHeartbeatConfig
      类。
      从版本 2.1.0 开始,JavaScript SDK 遵循 AMD 和 CommonJS 模块规范,并且
      VideoHeartbeat.min.js
      也可以与兼容的模块加载器一起使用。
  2. 为便于访问 API,请创建对
    MediaHeartbeat
    类的本地引用。
    var MediaHeartbeat = ADB.va.MediaHeartbeat; var MediaHeartbeatConfig = ADB.va.MediaHeartbeatConfig; var MediaHeartbeatDelegate = ADB.va.MediaHeartbeatDelegate;
  3. 创建一个
    MediaHeartbeatConfig
    实例。
    本节将帮助您了解
    MediaHeartbeat
    配置参数以及如何在您的
    MediaHeartbeat
    实例中设置正确的配置值,以便进行准确跟踪。
    以下是
    MediaHeartbeatConfig
    初始化示例:
    //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
    协议。
    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
    实例。
    this.mediaHeartbeat = new MediaHeartbeat(mediaDelegate, mediaConfig, appMeasurement);
    在媒体会话结束前,请确保您的
    MediaHeartbeat
    实例可以访问且未被取消分配。此实例将用于以下所有的跟踪事件。
    MediaHeartbeat
    需要
    AppMeasurement
    的实例,才能向 Adobe Analytics 发送调用。以下是
    AppMeasurement
    实例的示例:
    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 的详细信息,请参阅 从 VHL 1.x 迁移到 2.x