Seguimiento de capítulos y segmentos en Android track-chapters-and-segments-on-android
Las siguientes instrucciones proporcionan directrices para la implementación mediante SDK de 2.x.
Implementación del seguimiento de capítulos
-
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.Referencia de seguimiento de capítulos
ChapterObject
:note note NOTE Estas variables solo son necesarias si planea rastrear capítulos. 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 Nombre de variable Descripción Requerido name
Nombre del capítulo Sí position
Posición del capítulo Sí length
Duración del capítulo Sí startTime
Hora de inicio del capítulo Sí Objeto de capítulo:
code language-java MediaObject chapterDataInfo = MediaHeartbeat.createChapterObject(<CHAPTER_NAME>, <POSITION>, <LENGTH>, <START_TIME>);
-
Si incluye metadatos personalizados para el capítulo, cree las variables de datos de contexto para los metadatos:
code language-java HashMap<String, String> chapterMetadata = new HashMap<String,String>(); chapterMetadata.put("segmentType", "Sample Segment Type"); chapterMetadata.put("segmentName", "Sample Segment Name"); chapterMetadata.put("segmentInfo", "Sample Segment Info");
-
Para empezar a rastrear la reproducción del capítulo, invoque el evento
ChapterStart
en la instancia deMediaHeartbeat
code language-java public void onChapterStart(Observable observable, Object data) { _heartbeat.trackEvent(MediaHeartbeat.Event.ChapterStart, chapterDataInfo, chapterMetadata); }
-
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 deMediaHeartbeat
:code language-java public void onChapterComplete(Observable observable, Object data) { _heartbeat.trackEvent(MediaHeartbeat.Event.ChapterComplete, null, null); }
-
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:code language-java public void onChapterSkip(Observable observable, Object data) { _heartbeat.trackEvent(MediaHeartbeat.Event.ChapterSkip, null, null); }
-
Si hay más capítulos, repita los pasos del 1 al 5.