Seguimiento de anuncios con JavaScript 3.x

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

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	Tipo	Descripción
   name	string	Cadena no vacía que indica un nombre de pausa publicitaria (anuncio previo a la emisión, anuncio intermedio y anuncio posterior).
   position	entero	La posición numérica de la pausa publicitaria, comenzando por 1.
   startTime	entero	Valor del cabezal de reproducción al comienzo de la pausa publicitaria.

   Creación de objeto de pausa publicitaria:

   var adBreakObject =
     ADB.Media.createAdBreakObject(<ADBREAK_NAME>,
                                      <POSITION>,
                                      <START_TIME>);
   

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

   tracker.trackEvent(ADB.Media.Event.AdBreakStart, adBreakObject);
   

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	Tipo	Descripción
   name	string	Cadena no vacía que indica el nombre del anuncio.
   adId	string	Cadena no vacía que indica el identificador de la publicidad.
   position	entero	La posición numérica del anuncio dentro de la pausa publicitaria, comenzando por 1.
   length	entero	Número positivo que indica la longitud del anuncio.

   Creación de objeto de anuncio:

   var adObject =
     ADB.Media.createAdObject.createAdObject(<AD_NAME>,
                                   <AD_ID>,
                                   <POSITION>,
                                   <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 JavaScript

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

     /* Set context data */
     // Standard metadata keys provided by adobe.
     adMetadata[ADB.Media.AdMetadataKeys]  ="Sample Advertiser";
     adMetadata[ADB.Media.AdMetadataKeys] = "Sample Campaign";
     
     // Custom metadata keys
     adMetadata["affiliate"] = "Sample affiliate";
     adMetadata["campaign"] = "Sample ad campaign";
     adMetadata["creative"] = "Sample 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:

   _onAdStart = function() {
       tracker.trackEvent(ADB.Media.Event.AdStart, adObject, adMetadata);
   };
   

6. Cuando la reproducción del anuncio llega al final, invoque trackEvent() con el evento AdComplete:

   _onAdComplete = function() {
       tracker.trackEvent(ADB.Media.Event.AdComplete);
   };
   

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

   _onAdSkip = function() {
       tracker.trackEvent(ADB.Media.Event.AdSkip);
   };
   

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:

   _onAdBreakComplete = function() {
       tracker.trackEvent(ADB.Media.Event.AdBreakComplete);
   };
   

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