DocumentaciónAnalyticsGuía de servicios de medios de streaming

Seguimiento de anuncios en JavaScript 3.x track-ads-on-javascript

Last update: Fri Feb 06 2026 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Temas:

Creado para:

  • Usuario
  • Administrador
  • Desarrollador

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

IMPORTANT
Si va a implementar cualquier versión anterior del SDK, puede descargar las guías del desarrollador 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
    Nombre de variable Tipo Descripción
    name string Cadena no vacía que indica el nombre de la pausa (pre-roll, mid-roll y post-roll).
    position number La posición numérica de la pausa publicitaria, comenzando por 1.
    startTime number Valor del cabezal de reproducción al comienzo de la pausa publicitaria.

    Creación de objeto de pausa publicitaria:

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

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

    table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3
    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 denota el identificador del anuncio.
    position number La posición numérica del anuncio dentro del adbreak, empezando por 1.
    length number Número positivo que indica la longitud del anuncio.

    Creación de objeto de anuncio:

    code language-js 
    var adObject =
  ADB.Media.createAdObject.createAdObject(<AD_NAME>,
                                <AD_ID>,
                                <POSITION>,
                                <LENGTH>);

  4. (Opcional) Adjunte metadatos estándar o de publicidad 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:

      code language-js 
      /* 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:

    code language-js 
    _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:

    code language-js 
    _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

    code language-js 
    _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:

    code language-js 
    _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.

Seguimiento de anuncios granular

El intervalo de ping de anuncio predeterminado es 10 seconds.

Puede configurar el seguimiento de anuncios granular para habilitar el seguimiento de anuncios de 1 second.

IMPORTANT
Esta información debe proporcionarse al iniciar una sesión de seguimiento.

Sintaxis

ADB.Media.MediaObjectKey = {
   GranularAdTracking: "media.granularadtracking"
   }

Ejemplo

var mediaObject = ADB.Media.createMediaObject("media-name", "media-id", 60, ADB.Media.StreamType.VOD, ADB.Media.MediaType.Video);

// Enable granular ad tracking
mediaObject[ADB.Media.MediaObjectKey.GranularAdTracking] = true;

tracker.trackSessionStart(mediaObject);
recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb