Seguimiento personalizado de referencia para vídeo: documentación de la extensión de YouTube

Requisitos previos

Cada propiedad de Adobe Experience Platform Launch requiere que se instalen y configuren las siguientes extensiones desde la pantalla Extensiones:

• Adobe Analytics
• Servicio de ID de visitante de Experience Cloud
• Extensión principal

Por https://developers.google.com/youtube/player_parameters, utilice el fragmento de código Incrustar un reproductor con una etiqueta en el HTML de cada página web en la que se va a incluir un reproductor de vídeo.

La versión 1.0.1 de esta extensión admite la incrustación de uno o más vídeos de YouTube en una sola página web mediante la inserción de un id atributo con un valor único en la etiqueta iframe y anexándolo ?enablejsapi=1 al final del src valor del atributo. Por ejemplo:

<iframe id="player1" width="560" height="315" src="https://www.youtube.com/embed/xpatB77BzYE?enablejsapi=1" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>

Dado que la extensión agrega dinámicamente el campo id y el parámetro de cadena de consulta enablejsapi=1 al iFrame, no lo añada manualmente al iFrame.

En páginas con varios vídeos, tenga en cuenta que cada vídeo utiliza el mismo conjunto de configuraciones en la regla de Platform Launch que se ejecuta en esa página. Por ejemplo, si crea una regla con un evento que se activa cuando se completa el 50 % del vídeo, cada vídeo de la página activará la regla en el punto de referencia del 50 %.

La extensión se basa en la siguiente lógica para reescribir iFrames:

document.onreadystatechange = function () {
 if (document.readyState === 'complete') {

Por lo tanto, habrá un ligero parpadeo después de que se cargue la página. Este comportamiento es predecible.

Elementos de datos

Hay cinco elementos de datos disponibles en la extensión y ninguno de ellos requiere configuración.

• Posición del cursor de reproducción: Registra el lugar, en segundos, de la posición del cursor de reproducción en la cronología del vídeo, cuando se le hace referencia en una regla de Launch.
• ID de vídeo: Especifica el ID de YouTube asociado al vídeo.
• Nombre del vídeo: Especifica el nombre descriptivo o informal del vídeo.
• Dirección URL del vídeo: Arroja la URL de YouTube.com del vídeo que se está cargando o reproduciendo.
• Duración del vídeo: Registra la duración total, en segundos, del contenido de vídeo.

Eventos

Hay ocho eventos disponibles en la extensión, pero solo el seguimiento personalizado de puntos de referencia requiere configuración.

• Listo para vídeo: Se activa cuando se referencia el vídeo y está listo para reproducirse.
• Inicio de vídeo: Se activa cuando se inicia el vídeo por primera vez y cuando player.getCurrentTime() === 0
• Nueva reproducción de vídeo: Se activa cuando se referencia el vídeo y se vuelve a reproducir después del inicio. Este activador se iniciará en cada nueva reproducción.
• Pausa de vídeo: Se activa cuando se pausa el vídeo.
• Reanudación del vídeo: Se activa cuando se reanuda el vídeo y cuando player.getCurrentTime() !== 0
• Seguimiento personalizado de referencias: Se activa cuando el vídeo alcanza el porcentaje de umbral de vídeo especificado.
  Por ejemplo, si un vídeo dura 60 segundos y el punto de referencia especificado está en el 50 %, el evento se activará cuando la posición del cursor de reproducción esté en 30 segundos. El seguimiento de puntos de referencia se aplica tanto a las reproducciones iniciales como a las nuevas reproducciones. Tenga en cuenta que si el usuario busca en un punto de referencia, el evento no se activará. Los eventos de referencia solo se activan cuando el cursor de reproducción cruza la ubicación del punto de referencia calculada en la cronología y se está reproduciendo el vídeo.
• Búfer de vídeo: Se activa cuando el reproductor descarga una cierta cantidad de datos antes de que comience a reproducir el vídeo.
• Vídeo finalizado: Se activa cuando un vídeo termina por completo.

Uso

Hay una regla de Platform Launch para cada evento de vídeo (mostrado anteriormente). Debe crear una regla específica para cada evento que desee seguir. En otras palabras, si no desea rastrear la pausa del vídeo, no crearía una regla para ella.

Las reglas tienen tres acciones:

• Establecer variables: Configure las variables de Adobe Analytics (asigne a todos los elementos de datos incluidos todos o algunos de ellos).
• Enviar baliza: Envíe la baliza de Adobe Analytics como llamada de seguimiento de vínculo personalizado y proporcione un valor en el nombre del vínculo.
• Borrar variables: Borre las variables de Adobe Analytics.

Ejemplo de regla de Platform Launch para Inicio de vídeo

Se deben incluir los siguientes objetos de extensión de vídeo.

Eventos:

Inicio de vídeo: Con este evento, la regla se activa cuando el visitante comienza a reproducir un vídeo de YouTube.

Condición: ninguna

Acciones: Utilice la extensión de Analytics para:

Acción Establecer variables para asignar:

• El evento Inicio de vídeo,
• Un prop/eVar para el elemento de datos de la duración del vídeo
• Un prop/eVar para el elemento de datos de ID de vídeo
• Un prop/eVar para el elemento de datos del nombre del vídeo
• Un prop/eVar para el elemento de datos de la URL de vídeo

A continuación, incluya la acción Enviar baliza (s.tl) con el nombre de vínculo "inicio de vídeo", seguida de una acción Borrar variables.

Para concatenar valores de información del vídeo, cree un nuevo elemento de datos denominado Metadatos de vídeo y prográmelo para que extraiga todos los elementos de datos de vídeo (mostrados arriba) y combinarlos. Por ejemplo:

var r = ””;

r.push('YouTube'); //Player Name
r.push(_satellite.getVar('Video ID'));
r.push(_satellite.getVar('Video Name'));
r.push(_satellite.getVar('Video Duration'));

return r.join('|');