Documentación Experience Platform Etiquetas

Información general sobre la extensión BrightCove Video Tracking

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Temas:

Creado para:

Desarrollador

NOTE

Adobe Experience Platform Launch se ha convertido en un conjunto de tecnologías de recopilación de datos en Adobe Experience Platform. Como resultado, se han implementado varios cambios terminológicos en la documentación del producto. Consulte el siguiente documento para obtener una referencia consolidada de los cambios terminológicos.

Requisitos previos

Cada propiedad de etiqueta de Adobe Experience Platform necesita las siguientes extensiones instaladas y configuradas en la pantalla Extensión:

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

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. El fragmento HTML Código incrustado en la página (avanzado) se encuentra en la documentación de Brightcove. El siguiente vínculo proporciona más información sobre cómo generar código incrustado para reproductores de vídeo publicados y de vista previa.

Esta extensión con versión 1.1.0 admite la incrustación de varios vídeos BrightCove en una sola página web. Si hay varias propiedades id dentro de las etiquetas incrustadas avanzadas, asegúrese de que cada una de ellas tenga valores únicos. Por ejemplo, player1, player2, etc.

NOTE

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 etiquetas 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 utiliza esta extensión interactúa con el vídeo antes de que el script relevante se haya cargado completamente, puede realizar dos acciones para solucionar el problema. En primer lugar, la biblioteca de etiquetas se puede cargar sincrónicamente y, en segundo lugar, coloque el elemento <script type="text/javascript">\_satellite.pageBottom();\</script\> antes de que el vídeo se incruste en la página.

Consulte la documentación de la API de BrightCove para obtener más información sobre los métodos y eventos de componentes utilizados en 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: Cuando se llama a este elemento de datos dentro de una regla de etiqueta, se registra en segundos, el lugar de la posición del cursor de reproducción en la cronología del vídeo.
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 publicaciones 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.
Etiquetas 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.

NOTE

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

Se puede configurar una regla de etiqueta para cada evento de vídeo (los siete eventos enumerados arriba). Cree una regla de etiqueta específica para cada evento que desee rastrear. Si no desea rastrear un evento, simplemente omita crear una regla para él.

Las reglas tienen tres acciones:

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

Ejemplo de regla de etiquetas para 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
1. 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 elemento de datos del sitio del vídeo actual (ejemplo: eVar12)
2. Acción "Send Beacon" de Analytics (s.tl)
3. Acción "Clear Variables" de Analytics

TIP

Para los que no deseen aprovisionar varias eVars o propiedades para cada elemento de vídeo, los valores de los elementos de datos se concatenan como un método alternativo. A continuación, se dividen en informes de clasificación mediante la herramienta de clasificación del generador de reglas. Consulte la documentación de la Herramienta de clasificación del generador de reglas para obtener más información. Finalmente, se aplican como un segmento en Analysis Workspace.

Para ello, cree un nuevo elemento de datos denominado, por ejemplo, Metadatos de vídeo, y prográmelo para extraer todos los elementos de datos de vídeo (antes mencionados) y concatenarlos juntos.

var r = [];

r.push( \_satellite.getVar( &#39;Video ID&#39; ) );

r.push( \_satellite.getVar( &#39;Video Name&#39; ) );

r.push( \_satellite.getVar( &#39;Video Duraction&#39; ) );


return r.join(&#39;|&#39;);

recommendation-more-help

12b4e4a9-5028-4d88-8ce6-64a580811743