文件Analytics串流媒體收集指南

章節參數 chapter-parameters

Last update: Fri Oct 04 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主題：

建立對象：

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

本主題介紹章節與/或區段資料清單，包含 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 中的特徵名稱
IMPORTANT
請勿變更下列任何變數的分類名稱，其說明以「分類」形式顯示於「報表/保留變數」下方。
為媒體追蹤啟用報表套裝時，系統會定義媒體分類。Adobe 有時會新增屬性，而發生這種情形時，客戶必須重新啟用其報表套裝才能存取新的媒體屬性。在更新程序期間，Adobe 會檢查變數名稱，藉此決定是否啟用分類。如果有任何變數名稱遺失，Adobe 會再次新增遺失的項目。

章節中繼資料 chapter-metadata

章節名稱

實施
網路參數
報表
  • SDK 索引鍵:
    name
  • API 索引鍵:
    media.chapter.friendlyName
  • 必要:
    ​否
  • 類型:
    ​字串
  • 伴隨傳送:
    章節關閉
  • 最小SDK 版本: 1.3
  • 樣本值:
    「The Big Bang Chapter 2 - Dating」
  • 說明:
    ​章節和/或區段名稱。
  • Adobe Analytics:
    (a.media.chapter.
    friendlyName)
  • 心率：
    (s:stream:chapter_name)
  • 可用:
    ​預設建立…
  • 預留變數:
    ​分類
  • 報表名稱:
    ​章節名稱
  • 內容資料:
    (a.media.chapter.
    friendlyName)
  • 資料摘要:
    ​不適用
  • Audience Manager:
    (c_contextdata.
    a.media.chapter.
    friendlyName)
  • XDM 欄位路徑:
    media.mediaTimed.mediaChapter.
    chapterAssetReference.dc:title
  • 集合 XDM 欄位路徑:
    mediaCollection.chapterDetails.friendlyName
  • 報告 XDM 欄位路徑:
    mediaReporting.chapterDetails.friendlyName

章節位置

實施
網路參數
報表
  • SDK 索引鍵:
    position
  • API 索引鍵:
    media.chapter.index
  • 必要:
    SDK: 否；API: 是。
  • 類型:
    ​數字
  • 伴隨傳送:
    章節關閉
  • 最小SDK 版本: 1.3
  • 樣本值：
    2
  • 說明:
    ​內容內的章節位置 (索引、整數)。
  • Adobe Analytics:
    (a.media.chapter.
    position)
  • 心率：
    (l:stream:chapter_pos)
  • 可用:
    ​是
  • 預留變數:
    ​分類
  • 報表名稱:
    ​章節位置
  • 內容資料:
    (a.media.chapter.
    position)
  • 資料摘要:
    ​不適用
  • Audience Manager:
    (c_contextdata.
    a.media.chapter.
    position)
  • XDM 欄位路徑:
    media.mediaTimed.mediaChapter.
    chapterAssetViewDetails.index
  • 集合 XDM 欄位路徑:
    mediaCollection.chapterDetails.index
  • 報告 XDM 欄位路徑:
    mediaReporting.chapterDetails.index

章節位移

實施
網路參數
報表
  • SDK 索引鍵:
    startTime
  • API 索引鍵:
    media.chapter.offset
  • 必要:
    SDK: 否；API: 是。
  • 類型:
    ​數字
  • 伴隨傳送:
    章節關閉
  • 最小SDK 版本: 1.3
  • 樣本值：
    58
  • 說明:
    ​內容內從頭開始的章節位移 (以秒為單位)。
  • Adobe Analytics:
    (a.media.chapter.
    offset)
  • 心率：
    (l:stream:chapter_offset)
  • 可用:
    ​是
  • 預留變數:
    ​分類
  • 報表名稱:
    ​章節位移
  • 內容資料:
    (a.media.chapter.
    offset)
  • 資料摘要:
    ​不適用
  • Audience Manager:
    (c_contextdata.
    a.media.chapter.
    offset)
  • XDM 欄位路徑:
    media.mediaTimed.mediaChapter.
    chapterAssetViewDetails.offset
  • 集合 XDM 欄位路徑:
    mediaCollection.chapterDetails.offset
  • 報告 XDM 欄位路徑:
    mediaReporting.chapterDetails.offset

章節長度

實施
網路參數
報表
  • SDK 索引鍵:
  • API 索引鍵:
    media.chapter.length
  • 必要:
    SDK: 否；API: 是。
  • 類型:
    ​數字
  • 伴隨傳送:
    章節關閉
  • 最小SDK 版本: 1.3
  • 樣本值：
    486
  • 說明:
    ​章節長度 (以秒為單位)。
  • Adobe Analytics:
    (a.media.chapter.
    length)
  • 心率：
    (l:stream:chapter_length)
  • 可用:
    ​是
  • 預留變數:
    ​分類
  • 報表名稱:
    ​章節長度
  • 內容資料:
    (a.media.chapter.
    length)
  • 資料摘要:
    ​不適用
  • Audience Manager:
    (c_contextdata.
    a.media.chapter.
    length)
  • XDM 欄位路徑:
    media.mediaTimed.mediaChapter.
    chapterAssetReference.xmpDM:duration
  • 集合 XDM 欄位路徑:
    mediaCollection.chapterDetails.length
  • 報告 XDM 欄位路徑:
    mediaReporting.chapterDetails.length

章節

實施
網路參數
報表
  • SDK 索引鍵:
    自動設定
  • API 索引鍵:
    ​不適用
  • 必要:
    ​否
  • 類型:
    ​字串
  • 伴隨傳送:
    章節關閉
  • 最小SDK 版本: 1.3
  • 樣本值：
  • 說明:
    ​自動產生的章節唯一 ID。
  • Adobe Analytics:
    (a.media.chapter.
    名稱)
  • 心率：
    (s:stream:chapter_id)
  • 可用:
    ​是
  • 預留變數:
    eVar
  • 過期時間:
    ​點擊時
  • 報表名稱:
    ​章節
  • 內容資料:
    (a.media.chapter.
    名稱)
  • 資料摘要:
    videochapter
  • Audience Manager:
    (c_contextdata.
    a.media.chapter.
    名稱)
  • XDM 欄位路徑:
    media.mediaTimed.mediaChapter.
    chapterAssetReference.@id
  • 報告 XDM 欄位路徑:
    mediaReporting.chapterDetails.ID

章節量度 chapter-Metrics

章節開始

實施
網路參數
報表
  • SDK 索引鍵:
    自動設定
  • API 索引鍵:
    ​不適用
  • 必要:
    ​是
  • 類型:
    ​字串
  • 伴隨傳送:
    章節關閉
  • 最小SDK 版本: 1.3
  • 樣本值:
    TRUE
  • 說明:
    ​章節開始的數量。重要: 若此事件已設定，則唯一可能的值為 TRUE。若此事件未設定，則不會傳送值。
  • Adobe Analytics:
    (a.media.chapter.
    檢視)
  • 心率：
    (s:event:
    type=chapter_start)
  • 可用:
    ​是
  • 預留變數:
    ​事件
  • 報表名稱:
    ​章節開始
  • 內容資料:
    (a.media.chapter.
    檢視)
  • 資料摘要:
    ​不適用
  • Audience Manager:
    (c_contextdata.
    a.media.chapter.
    檢視)
  • XDM 欄位路徑:
    media.mediaTimed.chapterCount.
    value > 0 => "TRUE"
  • 報告 XDM 欄位路徑:
    mediaReporting.chapterDetails.isStarted

章節完成

實施
網路參數
報表
  • SDK 索引鍵:
    自動設定
  • API 索引鍵:
    ​不適用
  • 必要:
    ​是
  • 類型:
    ​字串
  • 伴隨傳送:
    章節關閉
  • 最小SDK 版本: 1.3
  • 樣本值:
    TRUE
  • 說明:
    ​章節完成的數量。重要: 若此事件已設定，則唯一可能的值為 TRUE。若此事件未設定，則不會傳送值。
  • Adobe Analytics:
    (a.media.chapter.
    complete)
  • 心率：
    (s:event:
    type=chapter_complete)
  • 可用:
    ​是
  • 預留變數:
    ​事件
  • 報表名稱:
    ​章節完成
  • 內容資料:
    (a.media.chapter.
    complete)
  • 資料摘要:
    ​不適用
  • Audience Manager:
    (c_contextdata.
    a.media.chapter.
    complete)
  • XDM 欄位路徑:
    media.mediaTimed.mediaChapter.
    completes.value
  • 報告 XDM 欄位路徑:
    mediaReporting.chapterDetails.isCompleted

章節逗留時間

實施
網路參數
報表
  • SDK 索引鍵:
    自動設定
  • API 索引鍵:
    ​不適用
  • 必要:
    ​是
  • 類型:
    ​數字
  • 伴隨傳送:
    章節關閉
  • 最小SDK 版本: 1.3
  • 樣本值：
  • 說明:
    ​在章節逗留的時間。該值將以時間格式(HH:MM:SS)顯示Analysis Workspace )和Reports & Analytics中。 在資料摘要、Data Warehouse 及報表 API 中，該值將以秒數顯示。
    發行日期: 2018 年 9 月 13 日
  • Adobe Analytics:
    (a.media.chapter.
    timePlayed)
  • 心率:
  • 可用:
    ​是
  • 預留變數:
    ​事件
  • 報表名稱:
    ​章節逗留時間
  • 內容資料:
    (a.media.chapter.
    timePlayed)
  • 資料摘要:
    ​不適用
  • Audience Manager:
    (c_contextdata.
    a.media.chapter.
    timePlayed)
  • XDM 欄位路徑:
    media.mediaTimed.mediaChapter.
    timePlayed.value
  • 報告 XDM 欄位路徑:
    mediaReporting.chapterDetails.timePlayed
recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb