Le istruzioni seguenti forniscono indicazioni per l’implementazione tramite gli SDK 2.x.
Se implementi una versione 1.x dell’SDK, puoi scaricare le guide per sviluppatori 1.x qui: Scaricare gli SDK.
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 |
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. | 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]];
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];
}
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. | 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]];
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:
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’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];
}
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];
}
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];
}
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 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.