Información general

Las siguientes instrucciones proporcionan directrices para la implementación mediante SDK de 2.x.

IMPORTANTE

Si va a implementar una versión 1.x del SDK, puede descargar la guía del desarrollador aquí: Descargar SDK.

El seguimiento de capítulos y segmentos está disponible para capítulos o segmentos de contenido multimedia detallados. Algunos usos comunes del seguimiento de capítulos son definir los segmentos personalizados basados en el contenido del medio, tales como los innings de béisbol o definir segmentos de contenido entre las pausas publicitarias. El seguimiento de capítulos no es necesario para las implementaciones de seguimiento de contenidos principales.

El seguimiento de capítulos incluye el inicio del capítulo, su finalización y omisión. Puede utilizar la API del reproductor de contenidos con una lógica de segmentación personalizada para identificar eventos de capítulo y llenar las variables de capítulo opcionales y obligatorias.

Eventos del reproductor

Al inicio del capítulo

  • Cree la instancia del objeto para el capítulo, chapterObject.
  • Rellene los metadatos del capítulo, chapterCustomMetadata.
  • La llamada trackEvent(MediaHeartbeat.Event.ChapterStart, chapterObject, chapterCustomMetadata);

Al completar el capítulo

  • La llamada trackEvent(MediaHeartbeat.Event.ChapterComplete);

Omisión del capítulo

  • La llamada trackEvent(MediaHeartbeat.Event.ChapterSkip);

Implementación del seguimiento de capítulos

  1. Identifique cuándo se produce el evento de inicio de capítulo y cree la instancia de ChapterObject con la información del capítulo.

    Esta es la referencia del seguimiento de capítulos de ChapterObject:

    NOTA

    Estas variables solo son necesarias si planea rastrear capítulos.

    Nombre de variable Descripción Requerido
    name Nombre del capítulo
    position Posición del capítulo
    length Duración del capítulo
    startTime Hora de inicio del capítulo
  2. Si incluye metadatos personalizados para el capítulo, cree las variables de datos de contexto para los metadatos.

  3. Para empezar a rastrear la reproducción del capítulo, invoque el evento ChapterStart en la instancia de MediaHeartbeat.

  4. Cuando la reproducción llega al final del capítulo, como se define en el código personalizado, invoque el evento ChapterComplete en la instancia de MediaHeartbeat.

  5. Si no se ha completado la reproducción del capítulo porque el usuario ha elegido omitirlo (por ejemplo, si el usuario hace clic en la línea de tiempo para saltar el capítulo), invoque el evento ChapterSkip en la instancia de MediaHeartbeat.

  6. Si hay más capítulos, repita los pasos del 1 al 5.

El siguiente código de ejemplo utiliza el SDK JavaScript 2.x para un reproductor de contenidos HTML5. Este código debe utilizarse con el código de reproducción de contenidos principal.

/* 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);
};

En esta página