Rastrear capítulos e segmentos no iOS

As instruções a seguir fornecem orientação para a implementação usando SDKs 2.x.

IMPORTANTE

Se estiver implementando uma versão 1.x do SDK, você pode baixar o Guia dos desenvolvedores aqui: Baixar SDKs.

  1. Identifique quando ocorre o evento de início do capítulo e crie a instância ChapterObject usando as informações do capítulo.

    Referência de rastreamento de capítulo ChapterObject:

    OBSERVAÇÃO

    Essas variáveis somente são necessárias se você estiver planejando rastrear capítulos.

    Nome da variável Descrição Obrigatório
    name Nome do capítulo Sim
    position Posição do capítulo Sim
    length Extensão do capítulo Sim
    startTime Hora de início do capítulo Sim

    Objeto do capítulo:

    id chapterObject =  
      [ADBMediaHeartbeat createChapterObjectWithName:[CHAPTER_NAME]
                         position:[POSITION]
                         length:[LENGTH]
                         startTime:[START_TIME]];
    
  2. Se você incluir metadados personalizados para o capítulo, crie as variáveis de dados de contexto para os metadados:

    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 começar a rastrear a reprodução do capítulo, chame o evento ChapterStart na instância MediaHeartbeat:

    - (void)onChapterStart:(NSNotification *)notification {
        [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventChapterStart  
                         mediaObject:chapterObject     
                         data:chapterDictionary];
    }
    
  4. Quando a reprodução atingir o limite final do capítulo, conforme definido pelo seu código personalizado, chame o evento ChapterComplete na instância MediaHeartbeat:

    - (void)onChapterComplete:(NSNotification *)notification {
        [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventChapterComplete  
                         mediaObject:nil  
                         data:nil];
    }
    
  5. Se a reprodução do capítulo não tiver sido concluída porque o usuário optou por ignorar o capítulo (por exemplo, se o usuário sair do limite do capítulo), chame o evento ChapterSkip na instância MediaHeartbeat:

    - (void)onChapterSkip:(NSNotification *)notification {
        [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventChapterSkip  
                         mediaObject:nil  
                         data:nil];
    }
    
  6. Se houver capítulos adicionais, repita as etapas de 1 até 5.

Nesta página