在 Roku 上追蹤章節和區段

重要

下列指示提供使用 2.x SDK 實作的指引。若您正在實作 SDK 1.x 版,您可以在此處下載開發人員指南: 下載 SDK

實作標準廣告中繼資料

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

    ChapterObject 章節追蹤參考資料:

    注意

    唯有在您計劃追蹤章節時,才須使用這些變數。

    變數名稱 說明 必填
    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。

本頁內容