实施与报表
在播放会话期间,必须单独跟踪每个状态的出现情况(从开始到结束)。Media SDK和媒体收集API提供了针对此功能的跟踪方法。
Media SDK包括两种自定义状态跟踪方法:
trackStateStart("state_name")
trackStateClose("state_name")
媒体收集API包含两个事件,它们将media.stateName
作为必需参数:
stateStart
和 stateEnd
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为每个单独的报表启用这些指标。
在Analysis Workspace中,所有新资产都位于“指标”面板中。 例如,您可以在“量度”面板中搜索 full screen
以查看全屏数据。
将播放器规定的量度导入 Adobe Experience Platform
存储在 Analytics 中的数据可用于任何目的,并且可以使用 XDM 将播放器状态量度导入到 Adobe Experience Platform 中,用于 Customer Journey Analytics。标准状态属性具有特定属性,而自定义状态属性可使用自定义事件获得。有关标准状态属性的更多信息,请参阅播放器状态参数页面上的 XDM 身份标识的属性列表 部分。