Tracciare gli annunci su iOS

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:

   id adBreakObject = [ADBMediaHeartbeat createAdBreakObjectWithName:[ADBREAK_NAME] 
                               position:[POSITION]  
                               startTime:[START_TIME]];
   

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

   - (void)onAdBreakStart:(NSNotification *)notification { 
       [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventAdBreakStart  
                        mediaObject:adBreakObject  
                        data:nil]; 
   }
   

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:

   id adObject = [ADBMediaHeartbeat createAdObjectWithName:[AD_NAME] 
                                    adId:[AD_ID] 
                                    position:[POSITION] 
                                    length:[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 iOS

   • 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:

     NSMutableDictionary *adDictionary = [[NSMutableDictionary alloc] init]; 
     [adDictionary setObject:@"Sample affiliate" forKey:@"affiliate"]; 
     [adDictionary setObject:@"Sample campaign" forKey:@"campaign"]; 
     [adDictionary setObject:@"Sample creative" forKey:@"creative"];
     

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:

   - (void)onAdStart:(NSNotification *)notification { 
       [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventAdStart  
                        mediaObject:adObject  
                        data:adDictionary]; 
   }
   

6. Quando la riproduzione dell’annuncio raggiunge la fine dell’annuncio, invoca trackEvent() con l’ AdComplete evento.

   - (void)onAdComplete:(NSNotification *)notification { 
       [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventAdComplete  
                        mediaObject:nil  
                        data:nil]; 
   }
   

7. Se la riproduzione dell’annuncio non è stata completata perché l’utente ha scelto di saltare l’annuncio, tracciate l’ AdSkip evento.

   - (void)onAdSkip:(NSNotification *)notification { 
       [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventAdSkip  
                        mediaObject:nil  
                        data:nil]; 
   }
   

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:

   - (void)onAdBreakComplete:(NSNotification *)notification { 
       [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventAdBreakComplete  
                        mediaObject:nil  
                        data:nil]; 
   }
   

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