Seguimiento de anuncios en Roku

Constantes de seguimiento de anuncio

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.	Sí
   position	La posición numérica de la pausa publicitaria, comenzando por 1.	Sí
   startTime	Valor del cabezal de reproducción al comienzo de la pausa publicitaria.	Sí

   ‘ Create an adbreak info object 
   adBreakInfo = adb_media_init_adbreakinfo() 
   adBreakInfo.name = <ADBREAK_NAME> 
   adBreakInfo.startTime = <START_TIME> 
   adBreakInfo.position = <POSITION>
   

2. Invoque trackEvent() con AdBreakStart en la instancia de MediaHeartbeat para iniciar el seguimiento de la pausa publicitaria:

   contextData = {} 
   ADBMobile().mediaTrackEvent(MEDIA_AD_BREAK_START, adBreakInfo, contextData)
   

3. Identifique cuándo se inicia el recurso publicitario y cree una instancia de AdObject con la información de la publicidad.

   adInfo =  
     adb_media_init_adinfo(ad.title,  
                           ad.id,  
                           ad.position,  
                           ad.duration) 
   

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 Roku

   • 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 recurso publicitario actual:

     contextData = {} 
     contextData["adinfo1"] = "adinfo2" 
     contextData["adinfo2"] = "adinfo2"
     

5. Invoque trackEvent() con el evento AdStart de la instancia de MediaHeartbeat para iniciar el seguimiento de la reproducción de publicidad:

   ADBMobile().mediaTrackEvent(ADBMobile().MEDIA_AD_START, adInfo, contextData)
   

6. Cuando la reproducción del recurso publicitario llega al final de la publicidad, invoque trackEvent() con el evento AdComplete.

   standardAdMetadata = {} 
   contextData = {} 
   ADBMobile().mediaTrackEvent(ADBMobile().MEDIA_AD_COMPLETE, adInfo, contextData)
   

7. Si la reproducción de la publicidad no ha finalizado porque el usuario ha elegido omitirla, realice un seguimiento del evento AdSkip

   contextData = {} 
   ADBMobile().mediaTrackEvent(ADBMobile().MEDIA_AD_SKIP, adInfo, contextData
   

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:

   contextData = {} 
   ADBMobile().mediaTrackEvent(MEDIA_AD_BREAK_COMPLETE, adBreakInfo, contextData)
   

Consulte la situación de seguimiento Reproducción de VOD con anuncios previos a la emisión para obtener más información.