Las siguientes instrucciones proporcionan directrices para la implementación mediante SDK de 3.x.
Si va implementar cualquier versión anterior del SDK, puede descargar las guías del desarrollador aquí: Descargar SDK.
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 |
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>);
Invoque trackEvent()
con AdBreakStart
en la instancia de MediaHeartbeat
para iniciar el seguimiento de la pausa publicitaria:
tracker.trackEvent(ADB.Media.Event.AdBreakStart, adBreakObject);
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>);
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";
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);
};
Cuando la reproducción del anuncio llega al final, invoque trackEvent()
con el evento AdComplete
:
_onAdComplete = function() {
tracker.trackEvent(ADB.Media.Event.AdComplete);
};
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);
};
Si hay anuncios adicionales dentro del mismo AdBreak
, repita los pasos del 3 al 7.
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.