Show Menu
TOPICS×

Rastrear anúncios no Android

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.
    • 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 evento
    AdComplete
    :
    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.