Rastrear anúncios no Android

IMPORTANTE

As instruções a seguir fornecem orientação para a implementação usando os SDKs 2.x. Se estiver implementando uma versão 1.x do SDK, você pode baixar os Guias dos desenvolvedores 1.x aqui: Baixar SDKs.

Constantes de rastreamento do anúncio

Nome da constante Descrição
MediaHeartbeat.Event.AdBreakStart Constante para rastrear o evento AdBreak Start
MediaHeartbeat.Event.AdBreakComplete Constante para rastrear o evento AdBreak Complete
MediaHeartbeat.Event.AdStart Constante para rastrear o evento Ad Start
MediaHeartbeat.Event.AdComplete Constante para rastrear o evento Ad Complete
MediaHeartbeat.Event.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:

    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

    Criação do objeto Ad break:

    MediaObject adBreakInfo =  
      MediaHeartbeat.createAdBreakObject(<ADBREAK_NAME>,  
                                         <POSITION>,  
                                         <START_TIME>);
    
  2. Chame trackEvent() com AdBreakStart na instância MediaHeartbeat para começar a rastrear o ad break:

    public void onAdBreakStart(Observable observable, Object data) {  
        _heartbeat.trackEvent(MediaHeartbeat.Event.AdBreakStart,  
                              adBreakInfo,  
                              null); 
    }
    
  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

    Criação do objeto de anúncio:

    MediaObject adInfo =  
      MediaHeartbeat.createAdObject(<AD_NAME> 
                                    <AD_ID>,  
                                    <POSITION>,  
                                    <LENGTH>);
    
  4. Opcionalmente, anexe metadados padrão e/ou de anúncio à sessão de rastreamento de mídia por meio de variáveis de dados de contexto.

    • Implementar Metadados de publicidade padrão no Android

    • 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:

      // Setting Ad Metadata 
      HashMap<String, String> adMetadata = new HashMap<String, String>(); 
      adMetadata.put("affiliate", "Sample affiliate"); 
      adMetadata.put("campaign", "Sample ad campaign");
      
  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:

    public void onAdStart(Observable observable, Object data) {  
        _heartbeat.trackEvent(MediaHeartbeat.Event.AdStart,  
                              adInfo,  
                              adMetadata); 
    }
    
  6. Quando a reprodução atingir o fim do anúncio, chame trackEvent() com o eventoAdComplete:

    public void onAdComplete(Observable observable, Object data) {  
        _heartbeat.trackEvent(MediaHeartbeat.Event.AdComplete, null, null); 
    }
    
  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

    public void onAdSkip(Observable observable, Object data) {  
        _heartbeat.trackEvent(MediaHeartbeat.Event.AdSkip, null, null); 
    }
    
  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 rastrear:

    public void onAdBreakComplete(Observable observable, Object data) {  
        _heartbeat.trackEvent(MediaHeartbeat.Event.AdBreakComplete, null, null); 
    }
    

Consulte o cenário de rastreamento Reprodução de VOD com anúncios antes da exibição para obter mais informações.

Nesta página