DocumentaciónAnalyticsGuía de Media Analytics

Seguimiento de capítulos y segmentos en iOS track-chapters-and-segments-on-ios

Last update: Mon Jan 23 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Creado para:

  • User
  • Admin
  • Developer

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

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

  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.

    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-none 
    id chapterObject =
  [ADBMediaHeartbeat createChapterObjectWithName:[CHAPTER_NAME]
                     position:[POSITION]
                     length:[LENGTH]
                     startTime:[START_TIME]];

  2. Si incluye metadatos personalizados para el capítulo, cree las variables de datos de contexto para los metadatos:

    code language-none 
    NSMutableDictionary *chapterDictionary = [[NSMutableDictionary alloc] init];
[chapterDictionary setObject:@"Sample segment type" forKey:@"segmentType"];
[chapterDictionary setObject:@"Sample segment name" forKey:@"segmentName"];
[chapterDictionary setObject:@"Sample segment info" forKey:@"segmentInfo"];

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

    code language-none 
    - (void)onChapterStart:(NSNotification *)notification {
    [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventChapterStart
                     mediaObject:chapterObject
                     data:chapterDictionary];
}

  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:

    code language-none 
    - (void)onChapterComplete:(NSNotification *)notification {
    [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventChapterComplete
                     mediaObject:nil
                     data:nil];
}

  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:

    code language-none 
    - (void)onChapterSkip:(NSNotification *)notification {
    [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventChapterSkip
                     mediaObject:nil
                     data:nil];
}

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

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