Seguimiento de anuncios en iOS

IMPORTANTE

Las siguientes instrucciones proporcionan directrices para la implementación mediante SDK de 2.x. Si va a implementar una versión 1.x del SDK, puede descargar las guías del desarrollador de 1.x aquí: Descargar SDK.

Constantes de seguimiento de anuncio

Nombre de la constante Descripción
ADBMediaHeartbeatEventAdBreakStart Constante para rastrear el evento de inicio de AdBreak
ADBMediaHeartbeatEventAdBreakComplete Constante para rastrear el evento de finalización de AdBreak
ADBMediaHeartbeatEventAdStart Constante para rastrear el evento de Inicio de Ad
ADBMediaHeartbeatEventAdComplete Constante para rastrear el evento de Finalización de Ad
ADBMediaHeartbeatEventAdSkip Constante para rastrear el evento Omitir Ad

Pasos de implementación

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

    Nombre de variable Descripción Requerido
    name Nombre de la pausa publicitaria: publicidad pre-roll, mid-roll y post-roll.
    position La posición numérica de la pausa publicitaria del contenido, comenzando por 1.
    startTime Valor del cabezal de reproducción al comienzo de la pausa publicitaria.

    Creación de objeto de pausa publicitaria:

    id adBreakObject = [ADBMediaHeartbeat createAdBreakObjectWithName:[ADBREAK_NAME] 
                                position:[POSITION]  
                                startTime:[START_TIME]];
    
  2. Invoque trackEvent() con AdBreakStart en la instancia de MediaHeartbeat para iniciar el seguimiento de la pausa publicitaria:

    - (void)onAdBreakStart:(NSNotification *)notification { 
        [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventAdBreakStart  
                         mediaObject:adBreakObject  
                         data:nil]; 
    }
    
  3. Identifique cuándo se inicia el anuncio y cree una instancia de AdObject con la información de la publicidad.

    Referencia de AdObject:

    Nombre de variable Descripción Requerido
    name Nombre descriptivo del anuncio.
    adId Identificador único del anuncio.
    position Posición numérica del anuncio en la pausa publicitaria, comenzando por 1.
    length Duración del anuncio

    Creación de objeto de anuncio:

    id adObject = [ADBMediaHeartbeat createAdObjectWithName:[AD_NAME] 
                                     adId:[AD_ID] 
                                     position:[POSITION] 
                                     length:[LENGTH]];
    
  4. 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.

    • Implementación de metadatos de publicidad estándar en iOS

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

      NSMutableDictionary *adDictionary = [[NSMutableDictionary alloc] init]; 
      [adDictionary setObject:@"Sample affiliate" forKey:@"affiliate"]; 
      [adDictionary setObject:@"Sample campaign" forKey:@"campaign"]; 
      [adDictionary setObject:@"Sample creative" forKey:@"creative"];
      
  5. Invoque trackEvent() con el evento AdStart de la instancia de MediaHeartbeat 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:

    - (void)onAdStart:(NSNotification *)notification { 
        [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventAdStart  
                         mediaObject:adObject  
                         data:adDictionary]; 
    }
    
  6. Cuando la reproducción del anuncio llega al final, invoque trackEvent() con el evento AdComplete.

    - (void)onAdComplete:(NSNotification *)notification { 
        [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventAdComplete  
                         mediaObject:nil  
                         data:nil]; 
    }
    
  7. Si la reproducción de la publicidad no ha finalizado porque el usuario ha elegido omitirla, realice un seguimiento del evento AdSkip.

    - (void)onAdSkip:(NSNotification *)notification { 
        [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventAdSkip  
                         mediaObject:nil  
                         data:nil]; 
    }
    
  8. Si hay anuncios adicionales dentro del mismo AdBreak, repita los pasos del 3 al 7.

  9. Cuando finalice la pausa publicitaria, utilice el evento AdBreakComplete para realizar el seguimiento:

    - (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.

En esta página

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now