Tracciare gli annunci su iOS track-ads-on-ios
Le istruzioni seguenti forniscono indicazioni per l’implementazione tramite gli SDK 2.x.
Costanti di tracciamento degli annunci
ADBMediaHeartbeatEventAdBreakStartADBMediaHeartbeatEventAdBreakCompleteADBMediaHeartbeatEventAdStartADBMediaHeartbeatEventAdCompleteADBMediaHeartbeatEventAdSkipPassaggi di implementazione
-
Identifica quando inizia il limite dell’interruzione dell’annuncio, incluso il pre-roll, e crea un
AdBreakObjectutilizzando le informazioni sull’interruzione dell’annuncio.Specifihe di
AdBreakObject:table 0-row-3 1-row-3 2-row-3 3-row-3 3-align-center 7-align-center 11-align-center 15-align-center Nome variabile Descrizione Obbligatorio nameNome dell’interruzione dell’annuncio come pre-roll, mid-roll e post-roll. Sì positionLa posizione numerica dell’interruzione pubblicitaria all’interno del contenuto, a partire da 1. Sì startTimeValore della testina di riproduzione all’inizio dell’interruzione pubblicitaria. Sì Creazione dell’oggetto di interruzione annuncio:
code language-none id adBreakObject = [ADBMediaHeartbeat createAdBreakObjectWithName:[ADBREAK_NAME] position:[POSITION] startTime:[START_TIME]]; -
Chiamata
trackEvent()conAdBreakStartnell’istanzaMediaHeartbeatper iniziare a tracciare l’interruzione pubblicitaria:code language-none - (void)onAdBreakStart:(NSNotification *)notification { [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventAdBreakStart mediaObject:adBreakObject data:nil]; } -
Identifica quando inizia l’annuncio e crea un’istanza
AdObjectutilizzando le informazioni sull’annuncio.Specifihe di
AdObject:table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 3-align-center 7-align-center 11-align-center 15-align-center 19-align-center Nome variabile Descrizione Obbligatorio nameNome descrittivo dell’annuncio. Sì adIdIdentificatore univoco per l’annuncio. Sì positionLa posizione numerica dell’annuncio all’interno dell’interruzione pubblicitaria, a partire da 1. Sì lengthLunghezza annuncio Sì Creazione di oggetti annuncio:
code language-none id adObject = [ADBMediaHeartbeat createAdObjectWithName:[AD_NAME] adId:[AD_ID] position:[POSITION] length:[LENGTH]]; -
Facoltativamente, allega metadati standard e/o di annunci alla sessione di tracciamento dei contenuti multimediali tramite variabili di dati di contesto.
-
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:
code language-none NSMutableDictionary *adDictionary = [[NSMutableDictionary alloc] init]; [adDictionary setObject:@"Sample affiliate" forKey:@"affiliate"]; [adDictionary setObject:@"Sample campaign" forKey:@"campaign"]; [adDictionary setObject:@"Sample creative" forKey:@"creative"];
-
Chiamata
trackEvent()con l’eventoAdStartnell’istanzaMediaHeartbeatper 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:
code language-none - (void)onAdStart:(NSNotification *)notification { [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventAdStart mediaObject:adObject data:adDictionary]; } -
Quando la riproduzione dell’annuncio ne raggiunge la fine, esegui la chiamata
trackEvent()con l’eventoAdComplete.code language-none - (void)onAdComplete:(NSNotification *)notification { [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventAdComplete mediaObject:nil data:nil]; } -
Se la riproduzione dell’annuncio non è stata completata perché l’utente ha scelto di saltarlo, traccia l’evento
AdSkip.code language-none - (void)onAdSkip:(NSNotification *)notification { [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventAdSkip mediaObject:nil data:nil]; } -
Se ci sono annunci aggiuntivi all’interno dello stesso
AdBreak, ripeti di nuovo i passaggi da 3 a 7. -
Al termine dell’interruzione pubblicitaria, utilizza l’evento
AdBreakCompleteper tracciare:code language-none - (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.