DocumentaçãoAnalyticsGuia de serviços para mídia de streaming

Rastrear capítulos e segmentos no Roku track-chapters-and-segments-on-roku

Last update: Fri Oct 10 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Tópicos:

Criado para:

  • Usuário
  • Administrador
  • Desenvolvedor

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

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

Implementar metadados de publicidade padrão

  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:

    note note
    NOTE
    Essas variáveis somente são necessárias se você estiver planejando 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
    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:

    code language-none 
    chapterInfo =
  adb_media_init_chapterinfo(<CHAPTER_NAME>,
                             <POSITION>,
                             <LENGTH>,
                             <START_TIME>);)

  2. Se você incluir metadados personalizados para o capítulo, crie as variáveis de dados de contexto para os metadados:

    code language-none 
    chapterContextData = {}
chapterContextData["seg_type"] = "seg_type"
chapterContextData["seg_name"] = "seg_name"
chapterContextData["seg_info"] = "seg_info"

  3. Para começar a rastrear a reprodução do capítulo, chame o evento ChapterStart na instância MediaHeartbeat:

    code language-none 
    ADBMobile().mediaTrackEvent(MEDIA_CHAPTER_START, chapterInfo, chapterContextData)

  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.

    code language-none 
    chapterContextData = {}
ADBMobile().mediaTrackEvent(MEDIA_CHAPTER_COMPLETE, chapterInfo, chapterContextData)

  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.

    code language-none 
    chapterContextData = {}
ADBMobile().mediaTrackEvent(MEDIA_CHAPTER_SKIP, chapterInfo, chapterContextData)

  6. Se houver capítulos adicionais, repita as etapas de 1 até 5.

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