Documentazione Analytics Guida di Media Analytics

Panoramica overview

Last update: Tue Jan 03 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Argomenti:
Media Analytics

Creato per:

User
Admin
Developer

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

IMPORTANT

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 gli inning di baseball) o la definizione di segmenti di contenuto tra interruzioni di annunci. Il tracciamento dei capitoli not è richiesto per le implementazioni di tracciamento dei contenuti multimediali di base.

Il tracciamento dei capitoli include gli inizi dei capitoli, i completamenti dei capitoli e i salti 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 implement-chapter-tracking

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

Qui è il riferimento di tracciamento del capitolo 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ì

Se includi metadati personalizzati per il capitolo, crea le variabili di dati di contesto per i metadati.
Per iniziare a tenere traccia della riproduzione del capitolo, chiamare l’evento ChapterStart nell’istanza MediaHeartbeat.
Quando la riproduzione raggiunge il limite finale del capitolo, come definito dal codice personalizzato, chiama l’evento ChapterComplete nell’istanza MediaHeartbeat.
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.
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);
};

recommendation-more-help

c8eee520-cef5-4f8c-a38a-d4952cfae4eb