Seguimiento de anuncios en Android track-ads-on-android

Identifique cuándo comienza la zona de salto de anuncio, incluido el anuncio previo a la emisión, y cree un AdBreakObject utilizando la información de la pausa publicitaria.

Referencia de AdBreakObject:

Creación de objeto de pausa publicitaria:

MediaObject adBreakInfo =
  MediaHeartbeat.createAdBreakObject(<ADBREAK_NAME>,
                                     <POSITION>,
                                     <START_TIME>);

Invoque trackEvent() con AdBreakStart en la instancia de MediaHeartbeat para iniciar el seguimiento de la pausa publicitaria:

public void onAdBreakStart(Observable observable, Object data) {
    _heartbeat.trackEvent(MediaHeartbeat.Event.AdBreakStart,
                          adBreakInfo,
                          null);
}

Identifique cuándo se inicia el anuncio y cree una instancia de AdObject con la información de la publicidad.

Referencia de AdObject:

Creación de objeto de anuncio:

MediaObject adInfo =
  MediaHeartbeat.createAdObject(<AD_NAME>
                                <AD_ID>,
                                <POSITION>,
                                <LENGTH>);

Opcionalmente, se pueden adjuntar metadatos estándar o de anuncio a la sesión de seguimiento de contenido mediante el uso de variables de datos de contexto.

• Implementación de metadatos de publicidad estándar en Android

help/use-cases/track-ads/impl-std-ad-metadata/impl-std-ad-metadata-android.md

• Metadatos de anuncio personalizados: para los metadatos personalizados, cree un objeto de variable para las variables de datos personalizadas y rellénelas con los datos del anuncio actual:

  code language-java
  // Setting Ad Metadata HashMap<String, String> adMetadata = new HashMap<String, String>(); adMetadata.put("affiliate", "Sample affiliate"); adMetadata.put("campaign", "Sample ad campaign");

Invoque trackEvent() con el evento AdStart de la instancia de MediaHeartbeat para iniciar el seguimiento de la reproducción de publicidad.

Incluya una referencia a la variable de metadatos personalizada (o un objeto vacío) como tercer parámetro de la llamada de evento:

public void onAdStart(Observable observable, Object data) {
    _heartbeat.trackEvent(MediaHeartbeat.Event.AdStart,
                          adInfo,
                          adMetadata);
}

Cuando la reproducción del anuncio llega al final, invoque trackEvent() con el evento AdComplete:

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

Si la reproducción de la publicidad no ha finalizado porque el usuario ha elegido omitirla, realice un seguimiento del evento AdSkip

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

Si hay anuncios adicionales dentro del mismo AdBreak, repita los pasos del 3 al 7.

Cuando finalice la pausa publicitaria, utilice el evento AdBreakComplete para realizar el seguimiento:

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