Tracciamento annunci su Android

Le istruzioni seguenti forniscono indicazioni per l'implementazione tramite gli SDK 2.x.

IMPORTANTE

Se implementi una versione 1.x dell'SDK, puoi scaricare le guide per sviluppatori 1.x qui: Scaricare gli SDK.

Costanti di tracciamento degli annunci

Nome costante Descrizione
MediaHeartbeat.Event.AdBreakStart Costante per il tracciamento dell'evento di avvio AdBreak
MediaHeartbeat.Event.AdBreakComplete Costante per il tracciamento dell’evento AdBreak Complete
MediaHeartbeat.Event.AdStart Costante per il tracciamento dell’evento Ad Start
MediaHeartbeat.Event.AdComplete Costante per il tracciamento dell’evento Ad Complete
MediaHeartbeat.Event.AdSkip Costante per il tracciamento dell’evento Ad Skip

Passaggi di implementazione

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

    AdBreakObject riferimento:

    Nome variable Descrizione Obbligatorio
    name Nome dell’interruzione dell’annuncio come pre-roll, mid-roll e post-roll.
    position La posizione numerica dell’interruzione pubblicitaria all’interno del contenuto, a partire da 1.
    startTime Valore della testina di riproduzione all'inizio dell'interruzione pubblicitaria.

    Creazione dell’oggetto di interruzione annuncio:

    MediaObject adBreakInfo =  
      MediaHeartbeat.createAdBreakObject(<ADBREAK_NAME>,  
                                         <POSITION>,  
                                         <START_TIME>);
    
  2. Invoca 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);
    }
    
  3. Identifica quando l'annuncio inizia e crea un'istanza AdObject utilizzando le informazioni dell'annuncio.

    AdObject riferimento:

    Nome variable Descrizione Obbligatorio
    name Nome descrittivo dell'annuncio.
    adId Identificatore univoco per l'annuncio.
    position La posizione numerica dell’annuncio all’interno dell’interruzione pubblicitaria, a partire da 1.
    length Lunghezza annuncio

    Creazione di oggetti annuncio:

    MediaObject adInfo =  
      MediaHeartbeat.createAdObject(<AD_NAME>
                                    <AD_ID>,  
                                    <POSITION>,  
                                    <LENGTH>);
    
  4. Facoltativamente, allega metadati standard e/o di annunci alla sessione di tracciamento dei contenuti multimediali tramite variabili di dati di contesto.

    • Implementazione dei metadati standard di annunci su Android

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

      // Setting Ad Metadata
      HashMap<String, String> adMetadata = new HashMap<String, String>();
      adMetadata.put("affiliate", "Sample affiliate");
      adMetadata.put("campaign", "Sample ad campaign");
      
  5. Chiama 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);
    }
    
  6. Quando la riproduzione dell’annuncio raggiunge la fine dell’annuncio, invoca trackEvent() con l’evento AdComplete :

    public void onAdComplete(Observable observable, Object data) {  
        _heartbeat.trackEvent(MediaHeartbeat.Event.AdComplete, null, null);
    }
    
  7. 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);
    }
    
  8. Se sono presenti annunci aggiuntivi all'interno dello stesso AdBreak, ripeti nuovamente i passaggi da 3 a 7.

  9. Al termine dell’interruzione pubblicitaria, utilizza l’evento AdBreakComplete per tenere traccia di:

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

Per ulteriori informazioni, consulta lo scenario di tracciamento Riproduzione VOD con annunci pre-scorrimento .

In questa pagina