文件Analytics串流媒體收集指南

在 Roku 上追蹤章節和區段

最後更新： 2024年6月27日
  • 主題：

建立對象：

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

下列指示提供使用 2.x SDK 實作的指引。

IMPORTANT
若您正在實作 SDK 1.x 版，您可以在此處下載開發人員指南：下載 SDK。

實作標準廣告中繼資料

  1. 識別章節開始事件何時發生，並使用章節資訊建立 ChapterObject 例項。

    ChapterObject 章節追蹤參考資料：

    NOTE
    唯有在您計劃追蹤章節時，才須使用這些變數。
    變數名稱
    說明
    必填
    name
    章節名稱
    是
    position
    章節位置
    是
    length
    章節長度
    是
    startTime
    章節開始時間
    是

    章節物件：

    chapterInfo =
  adb_media_init_chapterinfo(<CHAPTER_NAME>,
                             <POSITION>,
                             <LENGTH>,
                             <START_TIME>);)

  2. 如果您包含該章節的自訂中繼資料，請為中繼資料建立內容資料變數：

    chapterContextData = {}
chapterContextData["seg_type"] = "seg_type"
chapterContextData["seg_name"] = "seg_name"
chapterContextData["seg_info"] = "seg_info"

  3. 若要開始追蹤章節播放，請呼叫 ChapterStart 例項中的 MediaHeartbeat 事件：

    ADBMobile().mediaTrackEvent(MEDIA_CHAPTER_START, chapterInfo, chapterContextData)

  4. 當播放達到由您的自訂程式碼定義之章節結束界限時，請呼叫 ChapterComplete 例項中的 MediaHeartbeat 事件.

    chapterContextData = {}
ADBMobile().mediaTrackEvent(MEDIA_CHAPTER_COMPLETE, chapterInfo, chapterContextData)

  5. 如果因為使用者選擇略過章節而未完成章節播放 (例如，如果使用者搜尋超出章節界限)，請呼叫 MediaHeartbeat 例項中的 ChapterSkip 事件.

    chapterContextData = {}
ADBMobile().mediaTrackEvent(MEDIA_CHAPTER_SKIP, chapterInfo, chapterContextData)

  6. 如果有任何其他章節，請重複步驟 1 到 5。

recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb