Rastreador de señal personalizado de vídeo: documentación sobre la extensión BrightCove

Requisitos previos

Cada propiedad de Adobe Experience Platform Launch necesita las siguientes extensiones instaladas y configuradas en la pantalla Extension:

• Adobe Analytics
• Servicio de ID de visitante de Experience Cloud
• Extensiones principales instaladas

Por https://es.studio.support.brightcove.com/publish/choosing-correct-embed-code.html, utilice el fragmento de código "Código incrustado en la página (avanzado)" en el HTML de cada página web en la que se va a procesar un reproductor de vídeo. Consulte también: https://es.studio.support.brightcove.com/players/generating-player-embed-code.html

Aunque esta extensión versión 1.1.0 admite la incrustación de varios vídeos BrightCove en una sola página web, asegúrese de que la propiedad id de las etiquetas embed avanzadas, si existen, tenga valores diferentes, como: player1, player2, etc.

En páginas con varios vídeos, tenga en cuenta que cada vídeo utiliza el mismo conjunto de configuración 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 activa la regla en el punto de referencia del 50 %.

Si la página web que planea usar con esta extensión tiene la posibilidad de interactuar con el vídeo antes de que la etiqueta Platform Launch se haya cargado completamente, considere cargar la biblioteca Platform Launch de manera sincrónica y coloque la etiqueta <script type="text/javascript">\_satellite.pageBottom();\</script\> antes de que el vídeo se incruste en la página para mitigar posibles problemas temporales. Consulte https://docs.brightcove.com/brightcove-player/1.x/Player.html#vjsplayer sobre la API de BrightCove que se utiliza con esta extensión.

Elementos de datos

Hay siete elementos de datos disponibles dentro de la extensión, y ninguno de ellos requiere configuración.

• Posición del cabezal de reproducción: este elemento de datos registra el lugar, en segundos, de la posición del cursor de reproducción en la cronología del vídeo, cuando se le llama dentro de una regla de Platform Launch.
• ID de cuenta de vídeo: este elemento de datos registra el ID de la cuenta de Brightcove que publicó el vídeo.
• Duración del vídeo: este elemento de datos registra la duración total, en segundos, del contenido del vídeo. Además, se puede crear una métrica calculada en Analytics para convertir el número en segundos a minutos u horas.
• Compatibilidad con anuncios de vídeo: estos elementos de datos especifican si el vídeo admite publicidades o no.
• ID de vídeo: este elemento de datos especifica el ID de BrightCove asociado al vídeo.
• Nombre del vídeo: este elemento de datos especifica el nombre descriptivo o informal del vídeo.
• ID de vídeo: este elemento de datos especifica las etiquetas asociadas al vídeo.

Eventos

Hay siete eventos disponibles en la extensión. Solo el seguimiento de puntos de referencia personalizados requiere configuración.

• Seguimiento de puntos de referencia personalizados: este evento 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 es del 50 %, el evento se activará en la marca de 30 segundos. Tenga en cuenta que este evento se activa cada vez que se alcanza este punto de referencia. Por ejemplo, si el usuario alcanza la marca del 50 %, busca el vídeo antes de la marca del 50 % y luego vuelve a alcanzar la marca del 50 % y el activador se activa otra vez.
• Vídeo completado: este evento se activa cuando un vídeo se completa.
• Metadatos cargados de vídeo: este evento se activa cuando el reproductor ha recibido la duración inicial y la información de dimensión.
• Pausa de vídeo: este evento se activa cuando se pone en pausa el vídeo.
• Reanudación del vídeo: este evento se desencadena cuando se reanuda el contenido del vídeo tras un evento de pausa.
• Cambio en la pantalla de vídeo: el evento se desencadena cuando el vídeo entra o sale del modo de pantalla completa.
• Inicio de vídeo: este evento se activa cuando el contenido de vídeo se inicia por primera vez.

Uso

Habrá una regla de Platform Launch por cada Evento de vídeo (los siete eventos enumerados arriba). Cree una regla de Platform Launch específica para cada evento que desee rastrear. En otras palabras, si no desea rastrear la pausa del vídeo, no se crea una regla para ella.

Las reglas tienen tres acciones:

1. Configuran las variables de Adobe Analytics. (Crean elementos de datos para todos o algunos de los elementos de datos mencionados).
2. Envían la señalización de Adobe Analytics.
3. Borran las variables de Adobe Analytics.

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

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

Eventos:

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

Condición:

Ninguna

Acciones:

1. En una acción "Set Variables" de Analytics, establezca:

   • El evento del Inicio de vídeo (ejemplo: event17)
   • Una prop/eVar para el elemento de datos del nombre del vídeo (ejemplo: eVar10)
   • Una prop/eVar para el elemento de datos de la duración del vídeo (ejemplo: eVar11)
   • Una prop/eVar para el sitio del vídeo actual (ejemplo: eVar12)

2. Acción "Send Beacon" de Analytics (s.tl)

3. Acción "Clear Variables" de Analytics

var r = [];

r.push( \_satellite.getVar( 'Video ID' ) );

r.push( \_satellite.getVar( 'Video Name' ) );

r.push( \_satellite.getVar( 'Video Duraction' ) );


return r.join('|');