Tracciare gli annunci su iOS

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

Costanti di tracciamento degli annunci

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.	Sì
   position	La posizione numerica dell’interruzione pubblicitaria all’interno del contenuto, a partire da 1.	Sì
   startTime	Valore della testina di riproduzione all'inizio dell'interruzione pubblicitaria.	Sì

   Creazione dell’oggetto di interruzione annuncio:

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

2. Invoca trackEvent() con AdBreakStart nell'istanza MediaHeartbeat per iniziare a tracciare l'interruzione pubblicitaria:

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

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.	Sì
   adId	Identificatore univoco per l'annuncio.	Sì
   position	La posizione numerica dell’annuncio all’interno dell’interruzione pubblicitaria, 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. 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 iOS

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

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

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:

   - (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’evento AdComplete .

   - (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, tieni traccia dell'evento AdSkip .

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

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:

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

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