Show Menu
TOPICS×

Seguimiento de anuncios en iOS

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