DocumentazioneAnalyticsGuida ai servizi Streaming Media

Tracciare capitoli e segmenti utilizzando JavaScript 3.x track-chapters-and-segments-on-javascript

Last update: Tue Jul 15 2025 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 3.x.

IMPORTANT
Se implementi una versione precedente dell’SDK, puoi scaricare le Guide per sviluppatori qui: Scaricare gli SDK.

  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
    Nome variabile Tipo Descrizione
    name string Stringa non vuota che denota il nome del capitolo.
    position number La posizione numerica del capitolo all’interno del contenuto, a partire da 1.
    length number Numero positivo che indica la lunghezza del capitolo.
    startTime number Valore della testina di riproduzione all’inizio del capitolo.

    Oggetto capitolo:

    code language-js 
    var chapterObject =
  ADB.Media.createChapterObject.createChapterObject(<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-js 
    var chapterMetadata = {};
chapterMetadata["segmentType"] = "Sample segment type";

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

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

};

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

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

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

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

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

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