文件Analytics串流媒體服務指南

使用 JavaScript 3.x 追蹤章節和區段 track-chapters-and-segments-on-javascript

Last update: Mon Jul 14 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主題：

建立對象：

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

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

IMPORTANT
若您正在實作任何舊版的 SDK，您可以在此處下載開發人員指南：下載 SDK。

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

    ChapterObject 章節追蹤參考資料：

    note note
    NOTE
    唯有在您計劃追蹤章節時，才須使用這些變數。
    table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3
    變數名稱 類型 說明
    name 字串 表示章節名稱的非空白字串。
    position 數字 內容中章節的位置從 1 開始。
    length 數字 表示章節長度的正數。
    startTime 數字 章節開頭的播放點值。

    章節物件：

    code language-js 
    var chapterObject =
  ADB.Media.createChapterObject.createChapterObject(<CHAPTER_NAME>,
                                     <POSITION>,
                                     <LENGTH>,
                                     <START_TIME>);

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

    code language-js 
    var chapterMetadata = {};
chapterMetadata["segmentType"] = "Sample segment type";

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

    code language-js 
    _onChapterStart = function() {
  tracker.trackEvent(ADB.Media.Event.ChapterStart, chapterObject, chapterMetadata);

};

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

    code language-js 
    _onChapterComplete = function() {
   tracker.trackEvent(ADB.Media.Event.ChapterComplete);
};

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

    code language-js 
    _onChapterSkip = function() {
    tracker.trackEvent(ADB.Media.Event.ChapterSkip);
};

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

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