实施与报表

在播放会话期间,必须单独跟踪每个状态的出现情况(从开始到结束)。Media SDK 和媒体收集 API 为实现这项功能提供了新的跟踪方法。

Media SDK 包含两种进行自定义状态跟踪的新方法:

trackStateStart("state_name")

trackStateClose("state_name")

媒体收集 API 包含两个新事件,它们将 media.stateName 作为必需参数:

stateStartstateEnd

Media SDK 实施

播放器状态开始

// StateStart (ex: Mute is switched on)
var stateObject = ADB.Media.createStateObject(ADB.Media.PlayerState.Mute);
tracker.trackEvent(ADB.Media.Event.StateStart, stateObject);

播放器状态结束

// StateEnd (ex: Mute is switched off)
tracker.trackEvent(ADB.Media.Event.StateEnd, stateObject);

媒体收集 API 实施

播放器状态开始

// StateStart (ex: Mute is switched on)
http(s)://<Analytics_Visitor_Namespace>.hb-api.omtrdc.net/api/v1/sessions/<SID>/events
{
  "eventType": "stateStart",
  "params": {
    "media.state.name": "mute"
  },
  "playerTime": {
    "playhead": 0,
    "ts": 1569999130627
  }
}

播放器状态结束

// StateEnd (ex: Mute is switched off)
http(s)://<Analytics_Visitor_Namespace>.hb-api.omtrdc.net/api/v1/sessions/<SID>/events

{
  "eventType": "stateEnd",
  "params": {
    "media.state.name": "mute"
  },
  "playerTime": {
    "playhead": 600,
    "ts": 1569999730638
  }
}

状态量度

会计算为每个单独状态提供的量度,并将其作为“上下文数据”参数推送到 Adobe Analytics,然后进行存储以用于生成报表。每个状态有三个可用量度:

  • a.media.states.[state.name].set = true - 如果每次播放特定流时至少设置一次状态,则设置为 true。
  • a.media.states.[state.name].count = 4 - 标识在每次播放流时某种状态出现的次数
  • a.media.states.[state.name].time = 240 - 标识在每次播放流时持续的时长(以秒为单位)

报告

为播放器状态跟踪启用报表包后,所有播放器状态量度都可用于 Analysis Workspace 或组件(区段、计算量度)中提供的任何报告可视化。可以从 Admin Console 中使用“媒体报告设置”(“编辑设置”>“媒体管理”>“媒体报告”)为每个报告启用新量度。

在 Analytics 工作区中,所有新属性都位于“量度”面板中。例如,您可以在“量度”面板中搜索 full screen 以查看全屏数据。

将播放器规定的量度导入 Adobe Experience Platform

存储在 Analytics 中的数据可用于任何目的,并且可以使用 XDM 将播放器状态量度导入到 Adobe Experience Platform 中,用于 Customer Journey Analytics。标准状态属性具有特定属性,而自定义状态属性可使用自定义事件获得。有关标准状态属性的更多信息,请参阅播放器状态参数页面上的 XDM 标识的属性列表 ​部分。

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