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