實作與報告

在播放工作階段期間，每個狀態發生 (從開始到結束) 都必須個別追蹤。Media SDK 和 Media Collection 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);

Media Collection 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 Workspac 中，所有新屬性都位於量度面板中。例如，您可以依 full screen 搜尋，在量度面板中檢視全螢幕資料。

將播放器狀態量度匯入至 Adobe Experience Platform

儲存在 Analytics 中的資料可用於任何用途，而您可以使用 XDM 將播放器狀態量度匯入至 Adobe Experience Platform，並與 Customer Journey Analytics 搭配使用。標準狀態屬性具有特定屬性，自訂狀態則是可用自訂事件使用的屬性。如需有關標準狀態屬性的詳細資訊，請參閱播放器狀態參數頁面上的 XDM 身分識別的屬性清單​區段。