Rastrear anúncios no Android
Criado para:
- Usuário
- Administrador
- Desenvolvedor
As instruções a seguir fornecem orientação para a implementação usando os SDKs 2.x.
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
-
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>);
-
Chame
trackEvent()
comAdBreakStart
na instânciaMediaHeartbeat
para começar a rastrear o ad break:public void onAdBreakStart(Observable observable, Object data) { _heartbeat.trackEvent(MediaHeartbeat.Event.AdBreakStart, adBreakInfo, null); }
-
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ávelDescriçãoObrigatórioname
Nome amigável do anúncio.SimadId
identificador exclusivo para o anúncio.Simposition
A posição do número do anúncio no ad break, começando com 1.Simlength
Duração do anúncioSimCriação do objeto de anúncio:
MediaObject adInfo = MediaHeartbeat.createAdObject(<AD_NAME> <AD_ID>, <POSITION>, <LENGTH>);
-
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.
help/use-cases/track-ads/impl-std-ad-metadata/impl-std-ad-metadata-android.md
-
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");
-
-
Chame
trackEvent()
com o eventoAdStart
na instânciaMediaHeartbeat
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); }
-
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); }
-
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); }
-
Se houver algum anúncio adicional em um mesmo
AdBreak
, repita novamente as etapas 3 a 7. -
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.