Show Menu
主题×

设置概述

Adobe 将于 2021 年 8 月 31 日终止支持版本 4 Mobile SDK,届时还将终止对适用于 iOS 和 Android 的 Media Analytics SDK 的支持。有关更多信息,请参阅 Media Analytics SDK 支持终止常见问题解答
以下说明适用于 2.x Media SDK。如果您实施的是 1.x 版本的 Media SDK,请参阅 1.x Media SDK 文档。 有关 Primetime 集成程序的信息,请参阅以下
Primetime Media SDK 文档

支持的最低平台版本

下表介绍了从 2019 年 2 月 19 日开始每个 SDK 支持的最低平台版本。
操作系统/浏览器
所需的最低版本
iOS
iOS 6+
Android
Android 5.0+ - Lollipop
Chrome
v22+
Mozilla
v27+
Safari
v7+
IE
v11+

一般实施指南

媒体跟踪涉及三个主要 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 跟踪,该值以秒为单位,从媒体项目的开头起计算。对于线性/实时跟踪,该值以秒为单位,从节目的开头起计算。
    服务质量 (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 文档