Panoramica

Le istruzioni seguenti forniscono indicazioni per l'implementazione tramite SDK 2.x.

IMPORTANTE

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

Il tracciamento di capitoli e segmenti è disponibile per capitoli o segmenti multimediali personalizzati. Alcuni utilizzi comuni per il tracciamento dei capitoli sono la definizione di segmenti personalizzati in base ai contenuti multimediali (ad esempio le impostazioni di baseball) o la definizione di segmenti di contenuto tra interruzioni di annunci. Il tracciamento dei capitoli è non necessario per le implementazioni di tracciamento dei contenuti multimediali di base.

Il tracciamento dei capitoli include gli inizi dei capitoli, i completamenti dei capitoli e gli ignoramenti dei capitoli. Puoi utilizzare l’API del lettore multimediale con logica di segmentazione personalizzata per identificare gli eventi dei capitoli e popolare le variabili dei capitoli richieste e facoltative.

Eventi del lettore

All'inizio del capitolo

  • Creare l'istanza dell'oggetto capitolo per il capitolo chapterObject
  • Compilare i metadati del capitolo, chapterCustomMetadata
  • Chiamata trackEvent(MediaHeartbeat.Event.ChapterStart, chapterObject, chapterCustomMetadata);

Al capitolo completo

  • Chiamata trackEvent(MediaHeartbeat.Event.ChapterComplete);

Salto capitolo

  • Chiamata trackEvent(MediaHeartbeat.Event.ChapterSkip);

Implementare il tracciamento dei capitoli

  1. Identificare quando si verifica l'evento di inizio del capitolo e creare l'istanza ChapterObject utilizzando le informazioni del capitolo.

    Di seguito è riportato il riferimento di tracciamento dei capitoli ChapterObject:

    NOTA

    Queste variabili sono necessarie solo se intendi tenere traccia dei capitoli.

    Nome variable Descrizione Obbligatorio
    name Nome del capitolo
    position Posizione del capitolo
    length Lunghezza del capitolo
    startTime Ora di inizio capitolo
  2. Se includi metadati personalizzati per il capitolo , crea le variabili di dati di contesto per i metadati.

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

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

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

  6. In caso di capitoli aggiuntivi, ripetere i punti da 1 a 5.

Il codice di esempio seguente utilizza l'SDK JavaScript 2.x per un lettore multimediale HTML5. Usa questo codice con il codice di riproduzione del contenuto multimediale principale.

/* Call on chapter start */
if (e.type == "chapter start") {
    var chapterObject = MediaHeartbeat.createChapterObject("Inning 5",5,500,2500);
    /* Set custom context data*/
    var chapterCustomMetadata = {
        segmentType:"Baseball Innings",
        segmentName:"Inning 5",
        segmentInfo:"Game Six"
    }
    this.mediaHeartbeat.trackEvent(MediaHeartbeat.Event.ChapterStart,  
                                   chapterObject,  
                                   chapterCustomMetadata);
};

/* Call on chapter complete */
if (e.type == "chapter complete") {
    this.mediaHeartbeat.trackEvent(MediaHeartbeat.Event.ChapterComplete);
};

/* Call on chapter skip */
if (e.type == "chapter skip") {
    this.mediaHeartbeat.trackEvent(MediaHeartbeat.Event.ChapterSkip);
};

In questa pagina