品質參數

最後更新： 2024年7月18日
  • 主題：

建立對象：

  • 使用者
  • 管理員
  • 開發人員

本主題提供體驗品質 (QoE/QoS) 資料的清單，包含 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 中的特徵名稱

品質中繼資料

平均位元速率

實施網路參數報表
  • SDK 索引鍵:
    bitrate
  • API 索引鍵:
    media.qoe.bitrate
  • 必要:
    ​否
  • 類型:
    ​數字
  • 伴隨傳送:
    ​關閉
  • 最小SDK 版本: 任何版本
  • 樣本值：
    800-899
  • 說明:
    ​平均位元速率 (以每秒位元組數為單位)。值預先定義為 100kbps 間隔的貯體。平均位元速率的計算方式，為播放作業工作階段期間發生、與播放期間相關的所有位元速率值的加權平均。
  • Adobe Analytics:
    (a.media.qoe.
    bitrateAverageBucket)
  • 心率：
    (l:stream:位元速率)
  • 可用:
    ​是
  • 預留變數:
    eVar
  • 過期時間:
    ​點擊時
  • 報表名稱:
    ​平均位元速率
  • 內容資料:
    (a.media.qoe.
    bitrateAverageBucket)
  • 資料摘要:
    videoqoebitrateaverageevar
  • Audience Manager:
    (c_contextdata.
    a.media.qoe.
    bitrateAverageBucket)
  • XDM 欄位路徑:
    media.mediaTimed.primaryAssetViewDetails.
    qoe.bitrateAverageBucket
  • 集合 XDM 欄位路徑:
    mediaCollection.qoeDataDetails.
    bitrate
  • 報告 XDM 欄位路徑:
    mediaReporting.qoeDataDetails.
    bitrateAverageBucket

開始時間

實施網路參數報表
  • SDK 索引鍵:
  • API 索引鍵:
    media.qoe.timeToStart
  • 必要:
    ​否
  • 類型:
    ​數字
  • 伴隨傳送:
    媒體開始、媒體關閉
  • 最小SDK 版本: 任何版本
  • 樣本值：
    30,000
  • 說明:
    ​如未透過 QoSObject 設定，則此值預設為零。您將此值設為毫秒。值將會以時間格式(HH:MM:SS)顯示 Analysis Workspace和Reports & Analytics中的。 在資料摘要、Data Warehouse 及報表 API 中，該值將以秒數顯示。
  • Adobe Analytics:
    (a.media.qoe.
    timeToStart)
  • 心率：
    (l:stream:啟動時間)
  • 可用:
    ​是
  • 預留變數:
    eVar
  • 過期時間:
    ​點擊時
  • 報表名稱:
    ​開始時間
  • 內容資料:
    (a.media.qoe.
    timeToStart)
  • 資料摘要:
    videoqoetimetostartevar
  • Audience Manager:
    (c_contextdata.
    a.media.qoe.
    timeToStart)
  • XDM 欄位路徑:
    media.mediaTimed.primaryAssetViewDetails.
    qoe.timeToStart.value
  • 集合 XDM 欄位路徑:
    mediaCollection.qoeDataDetails.timeToStart
  • 報告 XDM 欄位路徑:
    mediaReporting.qoeDataDetails.timeToStart

每秒影格數

實施網路參數報表
  • SDK 索引鍵:
  • API 索引鍵:
    media.qoe.framesPerSecond
  • 必要:
    ​否
  • 類型:
    ​數字
  • 伴隨傳送:
    媒體開始、媒體關閉
  • 最小SDK 版本: 任何版本
  • 樣本值:
    24
  • 說明:
    ​串流影格速率 (以每秒的影格數為單位) 的目前數值。該欄位在結束通話時會對應至 fps 欄位，並可透過處理規則存取。
  • Adobe Analytics:
  • 心率：
    (l:stream:fps)
  • 可用:
    ​否
  • 預留變數:
    ​不適用
  • 報表名稱:
    ​不適用
  • 內容資料：
  • 資料摘要:
    ​不適用
  • Audience Manager:
  • XDM 欄位路徑:
  • 集合 XDM 欄位路徑:
    mediaCollection.qoeDataDetails.framesPerSecond
  • 報告 XDM 欄位路徑:
    mediaReporting.qoeDataDetails.framesPerSecond

掉格

實施網路參數報表
  • SDK 索引鍵:
    droppedFrames
  • API 索引鍵:
    media.qoe.droppedFrames
  • 必要:
    ​否
  • 類型:
    ​數字
  • 伴隨傳送:
    媒體關閉
  • 最小SDK 版本: 任何版本
  • 樣本值：
    3
  • 說明:
    ​掉格的數量 (整數)。此值的計算方式為播放工作階段期間所有掉格的總數。此值擷取自(l:stream:dropped_frames)的最後一個值)。
  • Adobe Analytics:
    (a.media.qoe.
    droppedFrameCount)
  • 心率：
    (l:stream:
    dropped_frame)
  • 可用:
    ​是
  • 預留變數:
    eVar
  • 過期時間:
    ​點擊時
  • 報表名稱:
    ​掉格
  • 內容資料:
    (a.media.qoe.
    droppedFrameCount)
  • 資料摘要:
    videoqoedroppedframecountevar
  • Audience Manager:
    (c_contextdata.
    a.media.qoe.
    droppedFrameCount)
  • XDM 欄位路徑:
    media.mediaTimed.primaryAssetViewDetails.
    qoe.droppedFrames.value
  • 集合 XDM 欄位路徑:
    mediaCollection.qoeDataDetails.
    droppedFrames
  • 報告 XDM 欄位路徑:
    mediaReporting.qoeDataDetails.
    droppedFrames

緩衝事件

實施網路參數報表
  • SDK 索引鍵:
    自動設定
  • API 索引鍵:
    ​不適用
  • 必要:
    ​否
  • 類型:
    ​數字
  • 伴隨傳送:
    媒體關閉
  • 最小SDK 版本: 任何版本
  • 樣本值：
    2
  • 說明:
    ​緩衝事件的數量。此量度是以發生在播放作業期間的不同緩衝狀態的計數來計算。這是該播放器從其他狀態 (例如播放或暫停) 進行緩衝狀態的計數。
  • Adobe Analytics:
    (a.media.qoe.
    bufferCount)
  • 心率：
    (s:event:
    type=buffer)
  • 可用:
    ​是
  • 預留變數:
    eVar
  • 過期時間:
    ​點擊時
  • 報表名稱:
    ​緩衝事件
  • 內容資料:
    (a.media.qoe.
    bufferCount)
  • 資料摘要:
    videoqoebuffercountevar
  • Audience Manager:
    (c_contextdata.
    a.media.qoe.
    bufferCount)
  • XDM 欄位路徑:
    media.mediaTimed.primaryAssetViewDetails.
    qoe.buffers.value
  • 報告 XDM 欄位路徑:
    mediaReporting.qoeDataDetails.bufferCount

總緩衝期間

實施網路參數報表
  • SDK 索引鍵:
    自動設定
  • API 索引鍵:
    ​不適用
  • 必要:
    ​否
  • 類型:
    ​數字
  • 伴隨傳送:
    媒體關閉
  • 最小SDK 版本:
  • 樣本值：
    30
  • 說明:
    ​緩衝花費的總時間量 (以秒為單位)。此值的計算方式為播放工作階段期間發生的所有緩衝事件持續期間的總和。值將會以時間格式(HH:MM:SS)顯示 Analysis Workspace和Reports & Analytics中的。 在資料摘要、Data Warehouse 及報表 API 中，該值將以秒數顯示。
    發行日期: 2018 年 9 月 13 日
  • Adobe Analytics:
    (a.media.qoe.
    bufferTime)
  • 心率：
    (l:event:持續時間)
  • 可用:
    ​是
  • 預留變數:
    eVar
  • 過期時間:
    ​點擊時
  • 報表名稱:
    ​總緩衝期間
  • 內容資料:
    (a.media.qoe.
    bufferTime)
  • 資料摘要:
    videoqoebuffertimeevar
  • Audience Manager:
    (c_contextdata.
    a.media.qoe.
    bufferTime)
  • XDM 欄位路徑:
    media.mediaTimed.primaryAssetViewDetails.
    qoe.bufferTime.value
  • 報告 XDM 欄位路徑:
    mediaReporting.qoeDataDetails.bufferTime

位元速率變更

實施網路參數報表
  • SDK 索引鍵:
  • API 索引鍵:
    media.qoe.bitrateChange
  • 必要:
    ​否
  • 類型:
    ​數字
  • 伴隨傳送:
    媒體關閉
  • 最小SDK 版本: 任何版本
  • 樣本值：
    3
  • 說明:
    ​位元速率變更的數量 (整數)。此值的計算方式為播放工作階段期間發生的所有位元速率變更事件的總數。
  • Adobe Analytics:
    (a.media.qoe.
    bitrateChangeCount)
  • 心率：
    (s:event:
    type=bitrate_change)
  • 可用:
    ​是
  • 預留變數:
    eVar
  • 過期時間:
    ​點擊時
  • 報表名稱:
    ​位元速率變更
  • 內容資料:
    (a.media.qoe.
    bitrateChangeCount)
  • 資料摘要:
    videoqoebitratechangecountevar
  • Audience Manager:
    (c_contextdata.
    a.media.qoe.
    bitrateChangeCount)
  • XDM 欄位路徑:
    media.mediaTimed.primaryAssetViewDetails.
    qoe.bitrateChanges.value
  • 集合 XDM 欄位路徑:
    mediaCollection.qoeDataDetails.
    bitrateChangeCount
  • 報告 XDM 欄位路徑:
    mediaReporting.qoeDataDetails.
    bitrateChangeCount

錯誤/錯誤事件

實施網路參數報表
  • SDK 索引鍵:
  • API 密鑰:
  • 必要:
    ​否
  • 類型:
    ​數字
  • 伴隨傳送:
    媒體關閉
  • 最小SDK 版本: 任何版本
  • 樣本值：
    1
  • 說明:
    ​發生錯誤的次數 (整數)。此值的計算方式為播放工作階段期間發生的所有錯誤事件的總數。
  • Adobe Analytics:
    (a.media.qoe.
    errorCount)
  • 心率：
    (s:event:
    type=error)
  • 可用:
    ​是
  • 預留變數:
    eVar
  • 過期時間:
    ​點擊時
  • 報表名稱:
    ​錯誤
  • 內容資料:
    (a.media.qoe.
    errorCount)
  • 資料摘要:
    videoqoeerrorcountevar
  • Audience Manager:
    (c_contextdata.
    a.media.qoe.
    errorCount)
  • XDM 欄位路徑:
    media.mediaTimed.primaryAssetViewDetails.
    qoe.errors.value
  • 報告 XDM 欄位路徑:
    mediaReporting.qoeDataDetails.errorCount

播放器 SDK 錯誤 ID

實施網路參數報表
  • SDK 索引鍵:
    ​自動設定
  • API 密鑰:
  • 必要:
    ​否
  • 類型:
    ​數字
  • 伴隨傳送:
    媒體關閉
  • 最小SDK 版本: 任何版本
  • 樣本值：
  • 說明:
    ​播放器 SDK 產生的唯一錯誤 ID。客戶必須透過系統提供的錯誤 API，在實施時提供錯誤代碼/ID。
  • Adobe Analytics:
    (a.media.qoe.
    playerSdkErrors)
  • 心率：
    (s:event:
    type=error)
  • 可用:
    ​是
  • 預留變數:
    eVar
  • 過期時間:
    ​點擊時
  • 報表時間:
    播放器 SDK 錯誤 ID
  • 內容資料:
    (a.media.qoe.
    playerSdkErrors)
  • 資料摘要:
    videoqoeplayersdkerrors
  • Audience Manager:
    (c_contextdata.
    a.media.qoe.
    playerSdkErrors)
  • XDM 欄位路徑:
    media.mediaTimed.primaryAssetViewDetails.
    qoe.playerSdkErrors
  • 報告 XDM 欄位路徑:
    mediaReporting.qoeDataDetails.
    playerSdkErrors

外部錯誤 ID

實施網路參數報表
  • SDK 索引鍵:
    ​自動設定
  • API 密鑰:
  • 必要:
    ​否
  • 類型:
    ​數字
  • 伴隨傳送:
    媒體關閉
  • 最小SDK 版本: 任何版本
  • 樣本值：
  • 說明:
    ​任何外部來源的唯一錯誤 ID (例如 CDN 錯誤)。客戶必須透過系統提供的錯誤 API，在實施時提供錯誤代碼/ID。
  • Adobe Analytics:
    (a.media.qoe.
    externalErrors)
  • 心率：
    (s:event:
    type=error)
  • 可用:
    ​是
  • 預留變數:
    eVar
  • 過期時間:
    ​點擊時
  • 報表時間:
    外部錯誤 ID
  • 內容資料:
    (a.media.qoe.
    externalErrors)
  • 資料摘要:
    videoqoeextneralerrors
  • Audience Manager:
    (c_contextdata.
    a.media.qoe.
    externalErrors)
  • XDM 欄位路徑:
    media.mediaTimed.primaryAssetViewDetails.
    qoe.externalSdkErrors
  • 報告 XDM 欄位路徑:
    mediaReporting.qoeDataDetails.
    externalErrors

Media SDK 錯誤 ID

實施網路參數報表
  • SDK 索引鍵:
    ​自動設定
  • API 密鑰:
  • 必要:
    ​否
  • 類型:
    ​數字
  • 伴隨傳送:
    媒體關閉
  • 最小SDK 版本: 任何版本
  • 樣本值：
  • 說明:
    Media SDK 在播放期間產生的唯一錯誤 ID。
  • Adobe Analytics:
    (a.media.qoe.
    mediaSdkErrors)
  • 心率：
    (s:event:
    type=error)
  • 可用:
    ​是
  • 預留變數:
    eVar
  • 過期時間:
    ​點擊時
  • 報表名稱:
    ​自訂
  • 內容資料:
    (a.media.qoe.
    mediaSdkErrors)
  • 資料摘要:
    mediaqoeexternalerrors
  • Audience Manager:
    (c_contextdata.
    a.media.qoe.
    mediaSdkErrors)
  • XDM 欄位路徑:
    media.mediaTimed.primaryAssetViewDetails.
    qoe.mediaSdkErrors
  • 報告 XDM 欄位路徑:
    mediaReporting.qoeDataDetails.
    mediaSdkErrors

工作階段結束

實施網路參數報表
  • SDK 索引鍵:
    ​自動設定
  • API 密鑰:
  • 類型:
    ​字串
  • 伴隨傳送:
    媒體關閉
  • 最小SDK 版本: 2.1
  • 樣本值:
    結束
  • 說明:
    ​結束事件表示 SDK 傳送關閉呼叫至後端。接收此事件後，後端會關閉此影片的作業階段，不會進行後續處理。
    如果媒體的完成度為 100%，這應在 s:event:type=complete. 後傳送。如需相關資訊，請參閱內容完成。
  • Adobe Analytics:
    ​不適用
  • 心率：
    (s:event:type=end)
  • 可用:
    ​使用自訂處理規則
  • 預留變數:
    ​事件
  • 報表名稱:
    ​不適用
  • 內容資料：
  • 資料摘要:
    ​不適用
  • Audience Manager:
  • XDM 欄位路徑:

品質量度

開始時間

實施網路參數報表
  • SDK 索引鍵:
    自動設定
  • API 索引鍵:
    ​不適用
  • 必要:
    ​否
  • 類型:
    ​數字
  • 伴隨傳送:
    媒體關閉
  • 最小SDK 版本: 任何版本
  • 樣本值：
    30,000
  • 說明:
    ​如未透過 QoSObject 設定，則此值預設為零。您將此值設為毫秒。值將會以時間格式(HH:MM:SS)顯示 Analysis Workspace和Reports & Analytics中的。 在資料摘要、Data Warehouse 及報表 API 中，該值將以秒數顯示。
    發行日期: 2018 年 9 月 13 日
  • Adobe Analytics:
    (a.media.qoe.
    timeToStart)
  • 心率：
    (l:stream:啟動時間)
  • 可用:
    ​是
  • 預留變數:
    ​事件
  • 報表名稱:
    ​開始時間
  • 內容資料:
    (a.media.qoe.
    timeToStart)
  • 資料摘要:
    ​不適用
  • Audience Manager:
    (c_contextdata.
    a.media.qoe.
    timeToStart)
  • XDM 欄位路徑:
    media.mediaTimed.primaryAssetViewDetails.
    qoe.timeToStart.value
  • 集合 XDM 欄位路徑:
    mediaCollection.qoeDataDetails.timeToStart
  • 報告 XDM 欄位路徑:
    mediaReporting.qoeDataDetails.timeToStart

緩衝事件

實施網路參數報表
  • SDK 索引鍵:
    startupTime
  • API 索引鍵:
    ​不適用
  • 必要:
    ​否
  • 類型:
    ​數字
  • 伴隨傳送:
    媒體關閉
  • 最小SDK 版本: 任何版本
  • 樣本值：
    2
  • 說明:
    ​緩衝事件的數量 (整數)。此度量的計算方式為播放工作階段期間發生的緩衝事件的計數。
  • Adobe Analytics:
    (a.media.qoe.
    bufferCount)
  • 心率：
    (s:event:
    type=buffer)
  • 可用:
    ​是
  • 預留變數:
    ​事件
  • 報表名稱:
    ​緩衝事件
  • 內容資料:
    (a.media.qoe.
    bufferCount)
  • 資料摘要:
    ​不適用
  • Audience Manager:
    (c_contextdata.
    a.media.qoe.
    bufferCount)
  • XDM 欄位路徑:
    media.mediaTimed.primaryAssetViewDetails.
    qoe.buffers.value
  • 報告 XDM 欄位路徑:
    mediaReporting.qoeDataDetails.bufferCount

總緩衝期間

實施網路參數報表
  • SDK 索引鍵:
    自動設定
  • API 索引鍵:
    ​不適用
  • 必要:
    ​否
  • 類型:
    ​數字
  • 伴隨傳送:
    媒體關閉
  • 最小SDK 版本: 任何版本
  • 樣本值：
    15
  • 說明:
    ​花費在緩衝的時間總數 (秒數，須為整數)。此值的計算方式為播放工作階段期間發生的所有緩衝事件持續期間的總和。值將會以時間格式(HH:MM:SS)顯示 Analysis Workspace和Reports & Analytics中的。 在資料摘要、Data Warehouse 及報表 API 中，該值將以秒數顯示。
    發行日期: 2018 年 9 月 13 日
  • Adobe Analytics:
    (a.media.qoe.
    bufferTime)
  • 心率：
    (l:event:duration)
  • 可用:
    ​是
  • 預留變數:
    ​事件
  • 報表名稱:
    ​總緩衝期間
  • 內容資料:
    (a.media.qoe.
    bufferTime)
  • 資料摘要:
    ​不適用
  • Audience Manager:
    (c_contextdata.
    a.media.qoe.
    bufferTime)
  • XDM 欄位路徑:
    media.mediaTimed.primaryAssetViewDetails.
    qoe.bufferTime.value
  • 報告 XDM 欄位路徑:
    mediaReporting.qoeDataDetails.bufferTime