Tracciare gli annunci su Android

Costanti di tracciamento annunci

Passaggi di implementazione

1. Identificate quando inizia il limite di interruzione annuncio, incluso il pre-roll, e create un’interruzione AdBreakObject utilizzando le informazioni di interruzione annuncio.

   AdBreakObject riferimento:

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

   Creazione oggetto di interruzione annuncio:

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

2. Chiama trackEvent() con AdBreakStart nell’ MediaHeartbeat istanza per iniziare a monitorare l’interruzione dell’annuncio:

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

3. Identificare quando inizia l’annuncio e creare un’ AdObject istanza utilizzando le informazioni sull’annuncio.

   AdObject riferimento:

   Nome della variabile	Descrizione	Obbligatorio
   name	Nome descrittivo dell’annuncio.	Sì
   adId	Identificatore univoco per l’annuncio.	Sì
   position	La posizione del numero dell’annuncio all’interno dell’interruzione dell’annuncio, a partire da 1.	Sì
   length	Lunghezza annuncio	Sì

   Creazione di oggetti annuncio:

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

4. Se necessario, allegate metadati standard e/o di annunci alla sessione di tracciamento dei supporti tramite le variabili dei dati contestuali.

   • Implementazione di metadati di annunci standard su Android

   • Metadati annunci personalizzati - Per i metadati personalizzati, create un oggetto variabile per le variabili dati personalizzate e compilate con 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. Chiamate trackEvent() con l’ AdStart evento nell’ MediaHeartbeat istanza per iniziare a monitorare la riproduzione dell’annuncio.

   Includete 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’ AdComplete evento:

   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’ AdSkip evento:

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

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

9. Al termine dell’interruzione dell’annuncio, utilizzate l’ AdBreakComplete evento per tenere traccia:

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

Per ulteriori informazioni, consulta lo scenario di tracciamento della riproduzione VOD con annunci pre-roll.