Show Menu
TOPICS×

Tracciare gli annunci su iOS

Le istruzioni seguenti forniscono indicazioni per l’implementazione mediante gli SDK 2.x. Se stai implementando una versione 1.x dell’SDK, puoi scaricare le guide per sviluppatori 1.x qui: Scaricare gli SDK.

Costanti di tracciamento annunci

Nome costante
Descrizione  
ADBMediaHeartbeatEventAdBreakStart
Costante per il tracciamento dell'evento AdBreak Start
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. 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.
    position
    La posizione numerica dell'interruzione annuncio all'interno del contenuto, a partire da 1.
    startTime
    Valore dell'indicatore di riproduzione all'inizio dell'interruzione dell'annuncio.
    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.
    adId
    Identificatore univoco per l’annuncio.
    position
    La posizione del numero dell'annuncio all'interno dell'interruzione dell'annuncio, 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. Se necessario, allegate metadati standard e/o di annunci alla sessione di tracciamento dei supporti tramite le variabili dei dati contestuali.
    • 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.