在播放工作階段期間,每個狀態發生 (從開始到結束) 都必須個別追蹤。Media SDK 和 Media Collection API 為此功能提供新的追蹤方法。
Media SDK 提供兩種新的自訂狀態追蹤方法:
trackStateStart("state_name")
trackStateClose("state_name")
媒體收集 API 提供兩種含必要參數 media.stateName
的新事件:
stateStart
與 stateEnd
播放器狀態開始
// 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);
播放器狀態開始
// 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 Workspac 中,所有新屬性都位於量度面板中。例如,您可以依 full screen
搜尋,在量度面板中檢視全螢幕資料。
儲存在 Analytics 中的資料可用於任何用途,而您可以使用 XDM 將播放器狀態量度匯入至 Adobe Experience Platform,並與 Customer Journey Analytics 搭配使用。標準狀態屬性具有特定屬性,自訂狀態則是可用自訂事件使用的屬性。如需有關標準狀態屬性的詳細資訊,請參閱播放器狀態參數頁面上的 XDM 身分識別的屬性清單區段。