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

Visão geral overview

Last update: Mon Jul 14 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 os SDKs 2.x.

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

A reprodução do anúncio inclui o rastreamento de ad breaks, anúncios iniciados, anúncios concluídos e anúncios ignorados. Use a API do reprodutor de mídia para identificar eventos importantes do reprodutor e preencher as variáveis de anúncio obrigatórias e opcionais. Consulte a lista abrangente de metadados aqui: Parâmetros de anúncios.

Eventos do player player-events

No início de pausa de anúncio

NOTE
Incluindo precedente

  • Crie uma instância de objeto adBreak para o ad break. Por exemplo, adBreakObject.

  • Chame trackEvent para iniciar o ad break com adBreakObject.

Em cada início de ativo de anúncio

  • Crie a instância do objeto de anúncio para o ativo de anúncio. Por exemplo, adObject.
  • Preencha os metadados do anúncio, adCustomMetadata.
  • Chame trackEvent para iniciar o anúncio.

Em cada conclusão de anúncio

  • Chame trackEvent para concluir o anúncio.

Ao ignorar o anúncio

  • Chame trackEvent para o anúncio ignorado.

Na conclusão do ad break

  • Chame trackEvent para concluir o ad break.

Implementar o rastreamento de anúncios implement-ad-tracking

Constantes de rastreamento do anúncio

Nome da constante
Descrição
AdBreakStart
Constante para rastrear o evento AdBreak Start
AdBreakComplete
Constante para rastrear o evento AdBreak Complete
AdStart
Constante para rastrear o evento Ad Start
AdComplete
Constante para rastrear o evento Ad Complete
AdSkip
Constante para rastrear o evento Ad Skip

Etapas da implementação

  1. Identifique o início do limite do ad break, incluindo o anúncio precedente, e crie um AdBreakObject usando as informações do ad break.

    AdBreakObject referência:

    table 0-row-3 1-row-3 2-row-3 3-row-3 3-align-center 7-align-center 11-align-center 15-align-center
    Nome da variável Descrição Obrigatório
    name Nome do ad break, como precedente, intermediário e posterior. Sim
    position A posição do número do ad break no conteúdo, começando com 1. Sim
    startTime Valor do indicador de reprodução no início do ad break. Sim

  2. Chame trackEvent() com AdBreakStart na instância MediaHeartbeat para começar a rastrear o ad break.

  3. Identifique o início do anúncio e crie uma instância AdObject usando as informações do anúncio.

    AdObject referência:

    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 amigável do anúncio. Sim
    adId identificador exclusivo para o anúncio. Sim
    position A posição do número do anúncio no ad break, começando com 1. Sim
    length Duração do anúncio Sim

  4. Opcionalmente, anexe metadados padrão e/ou de anúncio à sessão de rastreamento por meio de variáveis de dados de contexto.

    • Metadados de publicidade padrão - Para metadados de anúncios padrão, crie um dicionário de pares de valores-chave de Metadados de publicidade padrão usando as chaves da sua plataforma.
    • Metadados de anúncio personalizados - Para metadados personalizados, crie um objeto de variável para as variáveis de dados personalizadas e preencha com os dados do anúncio atual.

  5. Chame trackEvent() com o evento AdStart na instância MediaHeartbeat para começar a rastrear a reprodução de anúncio.

    Inclua uma referência na variável de metadados personalizada (ou um objeto vazio) como o terceiro parâmetro na chamada de evento.

  6. Quando a reprodução atingir o fim do anúncio, chame trackEvent() com o evento AdComplete.

  7. Se a reprodução do anúncio não tiver sido concluída porque o usuário optou por ignorar o anúncio, rastreie o evento AdSkip.

  8. Se houver algum anúncio adicional em um mesmo AdBreak, repita novamente as etapas 3 a 7.

  9. O ad break está concluído, use o evento AdBreakComplete para rastreá-lo.

IMPORTANT
Certifique-se de NÃO incrementar o indicador de reprodução do reprodutor de conteúdo (l:event:playhead) durante a reprodução do anúncio (s:asset:type=ad). Se você fizer isso, as métricas de Tempo gasto do conteúdo serão afetadas negativamente.

O código de exemplo a seguir usa o SDK 2.x do JavaScript para um reprodutor de mídia HTML5.

/* Call on ad break start */

if (e.type == "ad break start") {
    var adBreakObject = MediaHeartbeat.createAdBreakObject("mid-roll", 2, 500);
    this.mediaHeartbeat.trackEvent(MediaHeartbeat.Event.AdBreakStart, adBreakObject);
};

/* Call on ad start */
if (e.type == "ad start") {
    var adObject = MediaHeartbeat.createAdObject("PepsiOne", "123456ab", 1, 30);
    /* Set custom context data */
    var adCustomMetadata = {
        affiliate:"Sample affiliate",
        campaign:"Sample ad campaign",
        creative:"Sample creative"
    }
    this.mediaHeartbeat.trackEvent(MediaHeartbeat.Event.AdStart, adObject, adCustomMetadata);
};

/* Call on ad complete */
if (e.type == "ad complete") {
    this.mediaHeartbeat.trackEvent(MediaHeartbeat.Event.AdComplete);
};

/* Call on ad skip */
if (e.type == "ad skip") {
    this.mediaHeartbeat.trackEvent(MediaHeartbeat.Event.AdSkip);
};

/* Call on ad break complete */
if (e.type == "ad break complete") {
    this.mediaHeartbeat.trackEvent(MediaHeartbeat.Event.AdBreakComplete);
};
recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb