DocumentazioneAnalyticsGuida ai servizi Streaming Media

Tracciare capitoli e segmenti in Roku track-chapters-and-segments-on-roku

Last update: Fri Feb 06 2026 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Argomenti:

Creato per:

  • Utente
  • Amministratore
  • Sviluppatore

Le istruzioni seguenti forniscono indicazioni per l’implementazione utilizzando gli SDK 2.x.

IMPORTANT
Se implementi una versione 1.x dell'SDK, puoi scaricare la Guida per gli sviluppatori qui: Scaricare gli SDK.

Implementare metadati standard di annunci

  1. Identifica quando si verifica l’evento di inizio del capitolo e crea l’istanza ChapterObject utilizzando le informazioni sul capitolo.

    Riferimento di tracciamento dei capitoli ChapterObject:

    note note
    NOTE
    Queste variabili sono necessarie solo se intendi tenere traccia dei capitoli.
    table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 3-align-center 7-align-center 11-align-center 15-align-center 19-align-center
    Nome variabile Descrizione Obbligatorio
    name Nome del capitolo Sì
    position Posizione del capitolo Sì
    length Durata capitolo Sì
    startTime Ora di inizio capitolo Sì

    Oggetto capitolo:

    code language-none 
    chapterInfo =
  adb_media_init_chapterinfo(<CHAPTER_NAME>,
                             <POSITION>,
                             <LENGTH>,
                             <START_TIME>);)

  2. Se includi metadati personalizzati per il capitolo, crea le variabili di dati di contesto per i metadati:

    code language-none 
    chapterContextData = {}
chapterContextData["seg_type"] = "seg_type"
chapterContextData["seg_name"] = "seg_name"
chapterContextData["seg_info"] = "seg_info"

  3. Per iniziare a tenere traccia della riproduzione del capitolo, chiama l’evento ChapterStart nell’istanza MediaHeartbeat.

    code language-none 
    ADBMobile().mediaTrackEvent(MEDIA_CHAPTER_START, chapterInfo, chapterContextData)

  4. Quando la riproduzione raggiunge il limite finale del capitolo, come definito dal codice personalizzato, chiama l’evento ChapterComplete nell’istanza MediaHeartbeat.

    code language-none 
    chapterContextData = {}
ADBMobile().mediaTrackEvent(MEDIA_CHAPTER_COMPLETE, chapterInfo, chapterContextData)

  5. Se la riproduzione del capitolo non è stata completata perché l’utente ha scelto di saltare il capitolo (ad esempio, se l’utente cerca fuori dal limite del capitolo), chiama l’evento ChapterSkip nell’istanza MediaHeartbeat.

    code language-none 
    chapterContextData = {}
ADBMobile().mediaTrackEvent(MEDIA_CHAPTER_SKIP, chapterInfo, chapterContextData)

  6. Se ci sono capitoli aggiuntivi, ripeti i punti da 1 a 5.

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