Visão geral

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

O rastreamento de capítulos e segmentos está disponível para capítulos ou segmentos de mídia definidos de forma personalizada. Alguns usos comuns para o rastreamento de capítulos são definir segmentos personalizados com base no conteúdo de mídia (como entradas de beisebol) ou definir segmentos de conteúdo entre ad breaks. O rastreamento de capítulos não é necessário para implementações de heartbeat de mídia principais.

O rastreamento do capítulo inclui inícios de capítulo, conclusões de capítulo e capítulos ignorados. Você pode usar a API do reprodutor de mídia com lógica de segmentação personalizada para identificar eventos do player e para preencher as variáveis de capítulo obrigatórias e opcionais.

Eventos do player

No início do capítulo

• Criar a instância do objeto de anúncio para o capítulo, chapterObject
• Preencha os metadados do capítulo, chapterCustomMetadata
• Chame trackEvent(MediaHeartbeat.Event.ChapterStart, chapterObject, chapterCustomMetadata);

Na conclusão do capítulo

• Chame trackEvent(MediaHeartbeat.Event.ChapterComplete);

Ao ignorar o capítulo

• Chame trackEvent(MediaHeartbeat.Event.ChapterSkip);

Implementar o rastreamento de capítulo

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.

   Aqui está a referência para o 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

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

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

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.

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.

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

O código de exemplo a seguir usa o SDK 2.x do JavaScript para um reprodutor de mídia HTML5. Você deve usar esse código com o código de reprodução de mídia 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);
};