Tracciare gli annunci su iOS

Ultimo aggiornamento: 2023-01-03
  • Argomenti:
  • Media Analytics
    Visualizza ulteriori informazioni su questo argomento
  • Creato per:
  • User
    Admin
    Developer

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
ADBMediaHeartbeatEventAdBreakStart Costante per il tracciamento dell’evento di avvio AdBreak
ADBMediaHeartbeatEventAdBreakComplete Costante per il tracciamento dell’evento AdBreak Complete
ADBMediaHeartbeatEventAdStart Costante per il tracciamento dell’evento Ad Start
ADBMediaHeartbeatEventAdComplete Costante per il tracciamento dell’evento Ad Complete
ADBMediaHeartbeatEventAdSkip Costante per il tracciamento dell’evento Ad Skip

Passaggi di implementazione

  1. 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:

    Nome variabile 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:

    id adBreakObject = [ADBMediaHeartbeat createAdBreakObjectWithName:[ADBREAK_NAME]
                                position:[POSITION]
                                startTime:[START_TIME]];
    
  2. Chiamata 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 inizia l’annuncio e crea un’istanza AdObject utilizzando le informazioni sull’annuncio.

    Specifihe di AdObject:

    Nome variabile 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:

    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.

    • Implementare metadati standard di annunci su iOS

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

      NSMutableDictionary *adDictionary = [[NSMutableDictionary alloc] init];
      [adDictionary setObject:@"Sample affiliate" forKey:@"affiliate"];
      [adDictionary setObject:@"Sample campaign" forKey:@"campaign"];
      [adDictionary setObject:@"Sample creative" forKey:@"creative"];
      
  5. 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:

    - (void)onAdStart:(NSNotification *)notification {
        [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventAdStart
                         mediaObject:adObject
                         data:adDictionary];
    }
    
  6. Quando la riproduzione dell’annuncio ne raggiunge la fine, esegui la chiamata 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 saltarlo, traccia l’evento AdSkip.

    - (void)onAdSkip:(NSNotification *)notification {
        [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventAdSkip
                         mediaObject:nil
                         data:nil];
    }
    
  8. Se ci sono annunci aggiuntivi all’interno dello stesso AdBreak, ripeti di nuovo i passaggi da 3 a 7.

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

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

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

In questa pagina