Seguimiento de anuncios en iOS track-ads-on-ios
Las siguientes instrucciones proporcionan directrices para la implementación mediante SDK de 2.x.
Constantes de seguimiento de anuncio
ADBMediaHeartbeatEventAdBreakStart
ADBMediaHeartbeatEventAdBreakComplete
ADBMediaHeartbeatEventAdStart
ADBMediaHeartbeatEventAdComplete
ADBMediaHeartbeatEventAdSkip
Pasos de implementación
-
Identifique cuándo comienza la zona de salto de anuncio, incluido el anuncio previo a la emisión, y cree un
AdBreakObject
utilizando la información de la pausa publicitaria.Referencia de
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 Nombre de variable Descripción Requerido name
Nombre de la pausa publicitaria: publicidad pre-roll, mid-roll y post-roll. Sí position
La posición numérica de la pausa publicitaria del contenido, comenzando por 1. Sí startTime
Valor del cabezal de reproducción al comienzo de la pausa publicitaria. Sí Creación de objeto de pausa publicitaria:
code language-none id adBreakObject = [ADBMediaHeartbeat createAdBreakObjectWithName:[ADBREAK_NAME] position:[POSITION] startTime:[START_TIME]];
-
Invoque
trackEvent()
conAdBreakStart
en la instancia deMediaHeartbeat
para iniciar el seguimiento de la pausa publicitaria:code language-none - (void)onAdBreakStart:(NSNotification *)notification { [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventAdBreakStart mediaObject:adBreakObject data:nil]; }
-
Identifique cuándo se inicia el anuncio y cree una instancia de
AdObject
con la información de la publicidad.Referencia de
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 Nombre de variable Descripción Requerido name
Nombre descriptivo del anuncio. Sí adId
Identificador único del anuncio. Sí position
Posición numérica del anuncio en la pausa publicitaria, comenzando por 1. Sí length
Duración del anuncio Sí Creación de objeto de anuncio:
code language-none id adObject = [ADBMediaHeartbeat createAdObjectWithName:[AD_NAME] adId:[AD_ID] position:[POSITION] length:[LENGTH]];
-
Opcionalmente, se pueden adjuntar metadatos estándar o de anuncio a la sesión de seguimiento de contenido mediante el uso de variables de datos de contexto.
-
Metadatos de anuncio personalizados: para los metadatos personalizados, cree un objeto de variable para las variables de datos personalizadas y rellénelas con los datos del anuncio actual:
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"];
-
Invoque
trackEvent()
con el eventoAdStart
de la instancia deMediaHeartbeat
para iniciar el seguimiento de la reproducción de publicidad.Incluya una referencia a la variable de metadatos personalizada (o un objeto vacío) como tercer parámetro de la llamada de evento:
code language-none - (void)onAdStart:(NSNotification *)notification { [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventAdStart mediaObject:adObject data:adDictionary]; }
-
Cuando la reproducción del anuncio llega al final, invoque
trackEvent()
con el eventoAdComplete
.code language-none - (void)onAdComplete:(NSNotification *)notification { [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventAdComplete mediaObject:nil data:nil]; }
-
Si la reproducción de la publicidad no ha finalizado porque el usuario ha elegido omitirla, realice un seguimiento del evento
AdSkip
.code language-none - (void)onAdSkip:(NSNotification *)notification { [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventAdSkip mediaObject:nil data:nil]; }
-
Si hay anuncios adicionales dentro del mismo
AdBreak
, repita los pasos del 3 al 7. -
Cuando finalice la pausa publicitaria, utilice el evento
AdBreakComplete
para realizar el seguimiento:code language-none - (void)onAdBreakComplete:(NSNotification *)notification { [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventAdBreakComplete mediaObject:nil data:nil]; }
Consulte la situación de seguimiento Reproducción de VOD con anuncios previos a la emisión para obtener más información.