Seguimiento de anuncios en Roku track-ads-on-roku

Las siguientes instrucciones proporcionan directrices para la implementación mediante SDK de 2.x.

IMPORTANT
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
AdBreakStart
Constante para rastrear el evento de inicio de AdBreak
AdBreakComplete
Constante para rastrear el evento de finalización de AdBreak
AdStart
Constante para rastrear el evento de Inicio de Ad
AdComplete
Constante para rastrear el evento de Finalización de Ad
AdSkip
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:

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

    code language-none
    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.

    code language-none
    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:

      code language-none
      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:

    code language-none
    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.

    code language-none
    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

    code language-none
    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:

    code language-none
    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.

recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb