设置概述

以下说明适用于 2.x Media SDK。如果您实施的是 1.x 版本的 Media SDK，请参阅 1.x Media SDK 文档。有关 Primetime 集成程序的信息，请参阅以下 Primetime Media SDK 文档。

支持的最低平台版本

下表介绍了从 2019 年 2 月 19 日开始每个 SDK 支持的最低平台版本。

一般实施指南

媒体跟踪涉及三个主要 SDK 组件：

• 媒体心率配置 - 配置包含用于报表的基本设置。
• 媒体心率委派 - 委派控制播放时间和 QoS 对象。
• 媒体心率 - 包含成员和方法的主库。

完成以下实施步骤：

1. 创建一个 MediaHeartbeatConfig 实例，并设置您的配置参数值。

   变量名称	描述	必需	默认值
   trackingServer	适用于 Media Analytics 的跟踪服务器。这与您的分析跟踪服务器不同。	是	空字符串
   channel	渠道名称	否	空字符串
   ovp	用于分发内容的在线媒体平台的名称	否	空字符串
   appVersion	媒体播放器应用程序/SDK 的版本	否	空字符串
   playerName	正在使用的媒体播放器的名称（例如“AVPlayer”、“HTML5 播放器”、“我的自定义播放器”）	否	空字符串
   ssl	指示是否应通过 HTTPS 进行调用	否	false
   debugLogging	指示是否启用调试日志记录	否	false

2. 实施 MediaHeartbeatDelegate。

   方法名称	描述	必需
   getQoSObject()	返回包含当前 QoS 信息的 MediaObject 实例。在播放会话期间，此方法将被调用多次。播放器实施必须始终返回最新的可用 QoS 数据。	是
   getCurrentPlaybackTime()	返回播放头的当前位置。 对于 VOD 跟踪，该值以秒为单位，从媒体项目的开头起计算。 对于直播，如果播放器不提供有关内容持续时间的信息，则该值可以指定为自当天 UTC 午夜开始的秒数。 请注意：使用进度标记时，需要内容持续时间，并且播放头需要更新为从媒体项目开始的秒数，从 0 开始。	是

   小贴士

   服务质量 (QoS) 对象是可选的。如果您的播放器有 QoS 数据，并且您希望跟踪该数据，则需要以下变量：

   变量名称	描述	必需
   bitrate	媒体的比特率（以位/秒为单位）。	是
   startupTime	媒体的开始时间（以毫秒为单位）。	是
   fps	每秒显示的帧数。	是
   droppedFrames	到目前为止丢帧的数量。	是

3. 创建 MediaHeartbeat 实例。

   使用 MediaHertbeatConfig 和 MediaHertbeatDelegate 创建 MediaHeartbeat 实例。

   重要

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

   小贴士

   MediaHeartbeat 需要 AppMeasurement 的实例，才能向 Adobe Analytics 发送调用。

4. 合并所有部分。

   以下代码示例对 HTML5 媒体播放器使用 JavaScript 2.x SDK。

   // Create local references to the heartbeat classes
   var MediaHeartbeat = ADB.va.MediaHeartbeat;
   var MediaHeartbeatConfig = ADB.va.MediaHeartbeatConfig;
   var MediaHeartbeatDelegate = ADB.va.MediaHeartbeatDelegate;
   
   //Media Heartbeat Config
   var mediaConfig = new MediaHeartbeatConfig();
   mediaConfig.trackingServer = "[your_namespace].hb.omtrdc.net";
   mediaConfig.playerName = "HTML5 Basic";
   mediaConfig.channel = "Video Channel";
   mediaConfig.debugLogging = true;
   mediaConfig.appVersion = "2.0";
   mediaConfig.ssl = false;
   mediaConfig.ovp = "";
   
   // Media Heartbeat Delegate
   var mediaDelegate = new MediaHeartbeatDelegate();
   
   // Set mediaDelegate CurrentPlaybackTime
   mediaDelegate.getCurrentPlaybackTime = function() {
       return video.currentTime;
   };
   
   // Set mediaDelegate QoSObject - OPTIONAL
   mediaDelegate.getQoSObject = function() {
       return MediaHeartbeat.createQoSObject(video.bitrate,
                                             video.startuptime,
                                             video.fps,
                                             video.droppedframes);
   }
   // Create mediaHeartbeat instance
   this.mediaHeartbeat =
     new MediaHeartbeat(mediaDelegate, mediaConfig, appMeasurementInstance);
   

验证

Media Analytics 跟踪实施会生成两种类型的跟踪调用：

• 将媒体和广告开始调用直接发送到 Adobe Analytics (AppMeasurement) 服务器。

• 将心率调用发送到 Media Analytics (Heartbeats) 跟踪服务器，在该服务器上进行处理，然后传递到 Adobe Analytics 服务器。

• Adobe Analytics (AppMeasurement) 服务器
  有关跟踪服务器选项的更多信息，请参阅正确填充 trackingServer 和 trackingServerSecure 变量。

  重要

  Experience Cloud 访客 ID 服务需要一个 RDC 跟踪服务器或解析为 RDC 服务器的 CNAME。

  分析跟踪服务器应该以“.sc.omtrdc.net”结尾，或者应该为一个 CNAME。

• ** Media Analytics (Heartbeats) 服务器**
  其格式始终为“[your_namespace].hb.omtrdc.net”。“[your_namespace]”的值指定您的公司，由 Adobe 提供。

媒体跟踪在所有平台、桌面和移动设备上的工作方式都是相同的。音频跟踪当前适用于移动设备平台。在所有跟踪调用中，有一些需要验证的关键通用变量：

SDK 1.x 文档

Primetime Media SDK 文档

• Primetime 用户指南