实施与报表

在播放会话期间,必须单独跟踪每个状态的出现情况(从开始到结束)。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为每个单独的报表启用这些指标。

在Analysis Workspace中,所有新资产都位于“指标”面板中。 例如,您可以在“量度”面板中搜索 full screen 以查看全屏数据。

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

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

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