实施与报表

在播放会话期间,必须单独跟踪每个状态的出现情况(从开始到结束)。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 Workspace 中,所有新属性都位于“量度”面板中。例如,您可以在“量度”面板中搜索 full screen 以查看全屏数据。

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

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

On this page

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now