Visão geral

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

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

No início de pausa de anúncio

• 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

Constantes de rastreamento do anúncio

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:

   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:

   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.

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);
};