播放器狀態參數

此主題提供 Adobe 透過解決方案變數收集的播放器狀態資料清單。

表格資料說明：

實作：實作數值和需求的資訊
- 索引鍵 - 在您的應用程式中手動設定，或由 Adobe Media SDK 自動設定的變數。
- 必要 - 指出基本視訊追蹤是否需要參數。
- 類型 - 指明預計設定的變數類型 (字串或數字)。
- 「伴隨傳送」- 指出資料傳送的時間:「媒體開始」為媒體開始時傳送的分析呼叫、「廣告開始」為廣告開始時傳送的分析呼叫等等；「關閉」呼叫為媒體工作階段結束或廣告、章節等項目結束時，直接從心率伺服器傳送到分析伺服器的已編譯分析呼叫。網路封包呼叫中使用無法使用關閉呼叫。
- 最低SDK 版本 - 指出您存取參數所需的 SDK 版本。
- 範例值 - 提供常見的變數使用方法範例。
網路參數：顯示傳遞至 Adobe Analytics 或心率伺服器的數值。本欄顯示可於網路呼叫中看到，且由 Adobe Media SDK 產生的參數名稱。
報表：關於如何檢視和分析視訊資料的資訊。
- 可用 - 指出資料是否已由報表預設提供 (是)，或是需要自行設定 (自訂)
- 保留變數 - 指出資料在保留變數中是否被當作事件、eVar、prop 或分類擷取。
- 報表名稱 - 適用於變數的 Adobe Aanlytics 報表名稱
- 內容資料 - 傳遞至報表伺服器以及用於處理規則的 Adobe Aanlytics 內容資料名稱。
- 資料摘要 - 可在 Clickstream 或 Live Stream 資料摘要中找到的變數欄名稱
- Audience Manager - Adobe Audience Manager 中的特徵名稱

重要

請勿變更下列任何變數的分類名稱，其說明以「分類」形式顯示於「報表/保留變數」下方。
為媒體追蹤啟用報表套裝時，系統會定義媒體分類。Adobe 有時會新增屬性，而發生這種情形時，客戶必須重新啟用其報表套裝才能存取新的媒體屬性。在更新程序期間，Adobe 會檢查變數名稱，藉此決定是否啟用分類。如果有任何變數名稱遺失，Adobe 會再次新增遺失的項目。

播放器狀態屬性

播放器狀態追蹤功能可附加至音訊或視訊資料流。標準化的播放器狀態追蹤量度會儲存為解決方案變數。標準狀態為：fullScreen、mute、closeCaption、pictureInPicture 和 inFocus。

全螢幕屬性

受全螢幕影響的資料流

實作	網路參數	報表
SDK 索引鍵自動設定 API 索引鍵不適用必要否類型數字伴隨傳送媒體關閉最低SDK 版本 3.0 範例值 TRUE 說明受全螢幕影響的資料流數量。只有在播放工作階段期間發生至少一個全螢幕狀態時，此量度才會設為 1。重要若此事件已設定，則唯一可能的值為 TRUE。若此事件未設定，則不會傳送值。	Adobe Analytics a.media.states.fullscreen.set 心率不適用	可用是預留變數事件報表名稱受全螢幕影響的資料流內容資料 a.media.states.fullscreen.set 資料摘要 videostatefullscreen Audience Manager c_contextdata.a.media.states.fullscreen.set

全螢幕次數

實作	網路參數	報表
SDK 索引鍵自動設定 API 索引鍵不適用必要否類型數字伴隨傳送媒體關閉最低SDK 版本 3.0 範例值 TRUE 說明全螢幕顯示的次數。只有在播放工作階段期間發生至少一個全螢幕狀態時，此量度才會設為 1。重要若此事件已設定，則次數等於視訊處於全螢幕狀態的次數。若此事件未設定，則不會傳送值。	Adobe Analytics a.media.states.fullscreen.count 心率不適用	可用是預留變數事件報表名稱全螢幕次數內容資料 a.media.states.fullscreen.count 資料摘要 videostatefullscreencount Audience Manager c_contextdata.media.states.fullscreen.count

全螢幕總時間

實作	網路參數	報表
SDK 索引鍵自動設定 API 索引鍵不適用必要否類型數字伴隨傳送媒體關閉最低SDK 版本 3.0 範例值 TRUE 說明全螢幕顯示的時間長度。只有在播放工作階段期間發生至少一個全螢幕狀態時，此量度才會設為 1。重要若此事件已設定，則時間等於視訊處於全螢幕狀態的時間長度。若此事件未設定，則不會傳送值。	Adobe Analytics a.media.states.fullscreen.time 心率不適用	可用是預留變數事件報表名稱全螢幕總時間內容資料 a.media.states.fullscreen.time 資料摘要 videostatefullscreentime Audience Manager c_contextdata.media.states.fullscreen.time

受隱藏式字幕屬性

受隱藏式字幕影響的資料流

實作	網路參數	報表
SDK 索引鍵自動設定 API 索引鍵不適用必要否類型數字伴隨傳送媒體關閉最低SDK 版本 3.0 範例值 TRUE 說明受隱藏式字幕影響的資料流數量。只有在播放工作階段期間發生至少一個隱藏式字幕狀態時，此量度才會設為 1。重要若此事件已設定，則唯一可能的值為 TRUE。若此事件未設定，則不會傳送值。	Adobe Analytics a.media.states.closedcaptioning.set 心率不適用	可用是預留變數事件報表名稱受隱藏式字幕影響的資料流內容資料 a.media.states.closedcaptioning.set 資料摘要 videostateclosedcaptioning Audience Manager c_contextdata.a.media.states.closedcaptioning.set

隱藏式字幕次數

實作	網路參數	報表
SDK 索引鍵自動設定 API 索引鍵不適用必要否類型數字伴隨傳送媒體關閉最低SDK 版本 3.0 範例值 TRUE 說明隱藏式字幕的顯示次數。只有在播放工作階段期間發生至少一個隱藏式字幕狀態時，此量度才會設為 1。重要若此事件已設定，則次數等於視訊處於隱藏式字幕狀態的次數。若此事件未設定，則不會傳送值。	Adobe Analyticsa.media.states.clousedcaptioning.count 心率不適用	可用是預留變數事件報表名稱隱藏式字幕次數內容資料 a.media.states.closedcaptioning.count 資料摘要 videostateclosedcaptioningcount Audience Manager c_contextdata.media.states.closedcaptioning.count

隱藏式字幕總時間

實作	網路參數	報表
SDK 索引鍵自動設定 API 索引鍵不適用必要否類型數字伴隨傳送媒體關閉最低SDK 版本 3.0 範例值 TRUE 說明隱藏式字幕的顯示時間長度。只有在播放工作階段期間發生至少一個全螢幕狀態時，此量度才會設為 1。重要若此事件已設定，則時間等於視訊處於隱藏式字幕狀態的時間。若此事件未設定，則不會傳送值。	Adobe Analytics a.media.states.closedcaptioning.time 心率不適用	可用是預留變數事件報表名稱隱藏式字幕總時間內容資料 a.media.states.closedcaptioning.time 資料摘要 videostateclosedcaptioningtime Audience Manager c_contextdata.media.states.closedcaptioning.time

靜音屬性

受靜音影響的資料流

實作	網路參數	報表
SDK 索引鍵自動設定 API 索引鍵不適用必要否類型數字伴隨傳送媒體關閉最低SDK 版本 3.0 範例值 TRUE 說明受靜音影響的資料流的數量。只有在播放工作階段期間發生至少一個靜音狀態時，此量度才會設為 1。重要若此事件已設定，則唯一可能的值為 TRUE。若此事件未設定，則不會傳送值。	Adobe Analytics a.media.states.mute.set 心率不適用	可用是預留變數事件報表名稱受靜音影響的資料流內容資料 a.media.states.mute.set 資料摘要 videostatemute Audience Manager c_contextdata.a.media.states.mute.set

靜音次數

實作	網路參數	報表
SDK 索引鍵自動設定 API 索引鍵不適用必要否類型數字伴隨傳送媒體關閉最低SDK 版本 3.0 範例值 TRUE 說明靜音的顯示次數。只有在播放工作階段期間發生至少一個靜音狀態時，此量度才會設為 1。重要若此事件已設定，則次數等於視訊處於靜音狀態的次數。若此事件未設定，則不會傳送值。	Adobe Analytics a.media.states.mute.count 心率不適用	可用是預留變數事件報表名稱靜音次數內容資料 a.media.states.mute.count 資料摘要 videostatemutecount Audience Manager c_contextdata.media.states.mute.count

靜音總時間

實作	網路參數	報表
SDK 索引鍵自動設定 API 索引鍵不適用必要否類型數字伴隨傳送媒體關閉最低SDK 版本 3.0 範例值 TRUE 說明靜音的顯示時間長度。只有在播放工作階段期間發生至少一個靜音狀態時，此量度才會設為 1。重要若此事件已設定，則時間等於視訊處於靜音狀態的時間。若此事件未設定，則不會傳送值。	Adobe Analytics a.media.states.mute.time 心率不適用	可用是預留變數事件報表名稱靜音總時間內容資料 a.media.states.mute.time 資料摘要 videostatemutetime Audience Manager c_contextdata.media.states.mute.time

子母畫面屬性

受子母畫面影響的資料流

實作	網路參數	報表
SDK 索引鍵自動設定 API 索引鍵不適用必要否類型數字伴隨傳送媒體關閉最低SDK 版本 3.0 範例值 TRUE 說明受子母畫面影響的資料流的數量。只有在播放工作階段期間發生至少一個子母畫面狀態時，此量度才會設為 1。重要若此事件已設定，則唯一可能的值為 TRUE。若此事件未設定，則不會傳送值。	Adobe Analytics a.media.states.pictureinpicture.set 心率不適用	可用是預留變數事件報表名稱受子母畫面影響的資料流內容資料 a.media.states.pictureinpicture.set 資料摘要 videostatepictureinpicture Audience Manager c_contextdata.a.media.states.pictureinpicture.set

子母畫面次數

實作	網路參數	報表
SDK 索引鍵自動設定 API 索引鍵不適用必要否類型數字伴隨傳送媒體關閉最低SDK 版本 3.0 範例值 TRUE 說明子母畫面顯示的次數。只有在播放工作階段期間發生至少一個子母畫面狀態時，此量度才會設為 1。重要若此事件已設定，則次數等於視訊處於子母畫面狀態的次數。若此事件未設定，則不會傳送值。	Adobe Analytics a.media.states.pictureinpicture.count 心率不適用	可用是預留變數事件報表名稱子母畫面次數內容資料 a.media.states.pictureinpicture.count 資料摘要 videostatepictureinpicturecount Audience Manager c_contextdata.media.states.pictureinpicture.count

子母畫面總時間

實作	網路參數	報表
SDK 索引鍵自動設定 API 索引鍵不適用必要否類型數字伴隨傳送媒體關閉最低SDK 版本 3.0 範例值 TRUE 說明子母畫面顯示的時間長度。只有在播放工作階段期間發生至少一個子母畫面狀態時，此量度才會設為 1。重要若此事件已設定，則時間等於視訊處於子母畫面狀態的時間。若此事件未設定，則不會傳送值。	Adobe Analytics a.media.states.pictureinpicture.time 心率不適用	可用是預留變數事件報表名稱子母畫面總時間內容資料 a.media.states.pictureinpicture.time 資料摘要 videostatepictureinpicturetime Audience Manager c_contextdata.media.states.pictureinpicture.time

觀看中屬性

受觀看中影響的資料流

實作	網路參數	報表
SDK 索引鍵自動設定 API 索引鍵不適用必要否類型數字伴隨傳送媒體關閉最低SDK 版本 3.0 範例值 TRUE 說明受觀看中影響的資料流的數量。只有在播放工作階段期間發生至少一個觀看中狀態時，此量度才會設為 1。重要若此事件已設定，則唯一可能的值為 TRUE。若此事件未設定，則不會傳送值。	Adobe Analytics a.media.states.infocus.set 心率不適用	可用是預留變數事件報表名稱受觀看中影響的資料流內容資料 a.media.states.infocus.set 資料摘要 videostateinfocus Audience Manager c_contextdata.a.media.states.infocus.set

觀看中次數

實作	網路參數	報表
SDK 索引鍵自動設定 API 索引鍵不適用必要否類型數字伴隨傳送媒體關閉最低SDK 版本 3.0 範例值 TRUE 說明觀看中顯示的次數。只有在播放工作階段期間發生至少一個觀看中狀態時，此量度才會設為 1。重要若此事件已設定，則次數等於視訊處於觀看中狀態的次數。若此事件未設定，則不會傳送值。	Adobe Analytics a.media.states.infocus.count 心率不適用	可用是預留變數事件報表名稱觀看中次數內容資料 a.media.states.infocus.count 資料摘要 videostateinfocuscount Audience Manager c_contextdata.media.states.infocus.count

觀看中總時間

實作	網路參數	報表
SDK 索引鍵自動設定 API 索引鍵不適用必要否類型數字伴隨傳送媒體關閉最低SDK 版本 3.0 範例值 TRUE 說明觀看中顯示的時間長度。只有在播放工作階段期間發生至少一個觀看中狀態時，此量度才會設為 1。重要若此事件已設定，則時間等於視訊處於觀看中狀態的時間。若此事件未設定，則不會傳送值。	Adobe Analytics a.media.states.infocus.time 心率不適用	可用是預留變數事件報表名稱觀看中總時間內容資料 a.media.states.infocus.time 資料摘要 videostateinfocustime Audience Manager c_contextdata.media.states.infocus.time

XDM 身分識別的屬性清單

儲存在 Analytics 中的資料可用於任何用途，而您可以使用 XDM 將播放器狀態量度匯入至 Adobe Experience Platform，並與 Customer Journey Analytics 搭配使用。

播放器狀態屬性	映射
a.media.states.fullScreen.set	media.mediaTimed.primaryAssetViewDetails.fullScreen.playerStateSet
a.media.states.fullScreen.count	media.mediaTimed.primaryAssetViewDetails.fullScreen.playerStateCount
a.media.states.fullScreen.time	media.mediaTimed.primaryAssetViewDetails.fullScreen.playerStateTime
a.media.states.mute.set	media.mediaTimed.primaryAssetViewDetails.mute.playerStateSet
a.media.states.mute.count	media.mediaTimed.primaryAssetViewDetails.mute.playerStateCount
a.media.states.mute.time	media.mediaTimed.primaryAssetViewDetails.mute.playerStateTime
a.media.states.closeCaption.set	media.mediaTimed.primaryAssetViewDetails.closeCaption.playerStateSet
a.media.states.closeCaption.count	media.mediaTimed.primaryAssetViewDetails.closeCaption.playerStateCount
a.media.states.closeCaption.time	media.mediaTimed.primaryAssetViewDetails.closeCaption.playerStateTime
a.media.states.pictureInPicture.set	media.mediaTimed.primaryAssetViewDetails.pictureInPicture.playerStateSet
a.media.states.pictureInPicture.count	media.mediaTimed.primaryAssetViewDetails.pictureInPicture.playerStateCount
a.media.states.pictureInPicture.time	media.mediaTimed.primaryAssetViewDetails.pictureInPicture.playerStateTime
a.media.states.inFocus.set	media.mediaTimed.primaryAssetViewDetails.inFocus.playerStateSet
a.media.states.inFocus.count	media.mediaTimed.primaryAssetViewDetails.inFocus.playerStateCount
a.media.states.inFocus.time	media.mediaTimed.primaryAssetViewDetails.inFocus.playerStateTime