Las siguientes instrucciones proporcionan directrices para la implementación mediante SDK de 2.x. Si va a implementar una versión 1.x del SDK, puede descargar las guías del desarrollador de 1.x 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 | 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í |
Creación de objeto de pausa publicitaria:
var adBreakObject =
MediaHeartbeat.createAdBreakObject(<ADBREAK_NAME>,
<POSITION>,
<START_TIME>);
Invoque trackEvent()
con AdBreakStart
en la instancia de MediaHeartbeat
para iniciar el seguimiento de la pausa publicitaria:
mediaHeartbeat.trackEvent(MediaHeartbeat.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 | Descripción | Requerido |
---|---|---|
name |
Nombre descriptivo del anuncio. | Sí |
adId |
Identificador único del anuncio. | Sí |
position |
Posición numérica del anuncio en la pausa publicitaria, comenzando por 1. | Sí |
length |
Duración del anuncio | Sí |
Creación de objeto de anuncio:
var adObject =
MediaHeartbeat.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 custom context data */
var adCustomMetadata = {
affiliate: "Sample affiliate",
campaign: "Sample ad campaign",
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() {
this._mediaHeartbeat.trackEvent(MediaHeartbeat.Event.AdStart,
adObject,
adCustomMetadata);
};
Cuando la reproducción del anuncio llega al final, invoque trackEvent()
con el evento AdComplete
:
_onAdComplete = function() {
this._mediaHeartbeat.trackEvent(MediaHeartbeat.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() {
this._mediaHeartbeat.trackEvent(MediaHeartbeat.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() {
this._mediaHeartbeat.trackEvent(MediaHeartbeat.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.