Tracciare gli annunci su Android track-ads-on-android

Identifica quando inizia il limite dell’interruzione dell’annuncio, incluso il pre-roll, e crea un AdBreakObject utilizzando le informazioni sull’interruzione dell’annuncio.

Specifihe di AdBreakObject:

Creazione dell’oggetto di interruzione annuncio:

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

Chiamata trackEvent() con AdBreakStart nell’istanza MediaHeartbeat per iniziare a tracciare l’interruzione pubblicitaria:

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

Identifica quando inizia l’annuncio e crea un’istanza AdObject utilizzando le informazioni sull’annuncio.

Specifihe di AdObject:

Creazione di oggetti annuncio:

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

Facoltativamente, allega metadati standard e/o di annunci alla sessione di tracciamento dei contenuti multimediali tramite variabili di dati di contesto.

• Implementare metadati standard di annunci su Android

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

• Metadati degli annunci personalizzati - Per i metadati personalizzati, crea un oggetto variabile per le variabili di dati personalizzate e compila i dati per l’annuncio corrente:

  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");

Chiamata trackEvent() con l’evento AdStart nell’istanza MediaHeartbeat per iniziare a tracciare la riproduzione dell’annuncio.

Includi un riferimento alla variabile di metadati personalizzata (o a un oggetto vuoto) come terzo parametro nella chiamata dell’evento:

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

Quando la riproduzione dell’annuncio raggiunge la fine dell’annuncio, chiama trackEvent() con l’evento AdComplete:

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

Se la riproduzione dell’annuncio non è stata completata perché l’utente ha scelto di saltare l’annuncio, tieni traccia dell’evento AdSkip:

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

Se ci sono annunci aggiuntivi all’interno dello stesso AdBreak, ripeti di nuovo i passaggi da 3 a 7.

Al termine dell’interruzione pubblicitaria, utilizza l’evento AdBreakComplete per tracciare:

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