Configuración del seguimiento de videos para Adobe Analytics

Existen varios métodos disponibles para rastrear eventos de vídeo, dos de los cuales son opciones heredadas para versiones anteriores de Adobe Analytics. Estas opciones heredadas son: Hitos heredados y segundos heredados.

NOTA

Antes de continuar, asegúrese de que tiene un vídeo reproducible cargado en AEM.

Para asegurarse de que los vídeos se reproducen en la página, consulte este tutorial para obtener información sobre cómo transcodificar los archivos de vídeo en AEM.

Utilice el procedimiento siguiente para configurar un marco para el seguimiento de vídeo con cada método.

NOTA

Para nuevas implementaciones, se recomienda que no utilice las opciones heredadas para el seguimiento de videos. En su lugar, utilice el método Hitos.

Pasos comunes

  1. Configure una página web arrastrando un componente de vídeo desde la barra de tareas y agregando un vídeo reproducible como recurso para el componente

  2. Cree una configuración y un marco de trabajo de Adobe Analytics.

    • Los ejemplos de las secciones siguientes utilizan el nombre my-sc-configuration para la configuración y videofw para la estructura.
  3. En la página de marco, seleccione un RSID y defina el uso en todos. (https://localhost:4502/cf#/etc/cloudservices/sitecatalyst/videoconf/videofw.html)

  4. En la categoría de componentes General de la barra de tareas, arrastre el componente Vídeo a la estructura.

  5. Seleccione un método de seguimiento:

  6. Al seleccionar un método de seguimiento, la lista de las variables de CQ cambia en consecuencia. Utilice las secciones siguientes para obtener información sobre cómo seguir configurando el componente y asignar las variables de CQ con propiedades de Adobe Analytics.

Hitos

El método Hitos rastrea la mayor cantidad de información sobre el vídeo, es altamente personalizable y fácil de configurar.

Para utilizar el método Hitos, especifique los desplazamientos de seguimiento basados en el tiempo para definir los hitos. Cuando una reproducción de vídeo supera un hito, la página llama a Adobe Analytics para realizar un seguimiento del evento. Para cada hito que defina, el componente crea una variable de CQ que puede asignar a una propiedad de Adobe Analytics. El nombre de estas variables de CQ utiliza el siguiente formato:

eventdata.events.milestoneXX

El sufijo XX es el desplazamiento de la pista que define el hito. Por ejemplo, si se especifican desplazamientos de seguimiento de 4, 8, 16, 20 y 28 segundos, se generan las siguientes variables de CQ:

  • eventdata.events.milestone4
  • eventdata.events.milestone8
  • eventdata.events.milestone16
  • eventdata.events.milestone20
  • eventdata.events.milestone28

En la tabla siguiente se describen las variables de CQ predeterminadas que se proporcionan para el método Milestones:

Variables de CQ Propiedades de Adobe Analytics
eventdata.videoName Las variables asignadas a esto contendrán el nombre práctico (Título) del video si se establece en el DAM; si no se establece, se enviará el nombre de archivo del vídeo en su lugar. Solo se envía una vez, al comienzo de la reproducción de un vídeo.
eventdata.videoFileName Las variables asignadas a esto contendrán el nombre del archivo. Solo se envía junto con eventdata.eventos.a.media.vista
eventdata.videoFilePath Las variables asignadas a esto contendrán la ruta del archivo en el servidor. Solo se envía junto con eventdata.eventos.a.media.vista
eventdata.events.a.media.segmentView Se envía cada vez que se pasa un hito del segmento
eventdata.events.a.media.timePlayed Se envía cada vez que se activa un hito, junto con este evento, el número de segundos que el usuario ha pasado viendo el segmento determinado. p. ej. eventX=21
eventdata.events.a.media.view Enviado al inicializar la vista de vídeo
eventdata.events.a.media.complete Se envía cuando el vídeo termina de reproducirse
eventdata.events.milestoneX Cuando se envía el hito dado, X representa el segundo en que el hito se activa a
eventdata.a.contentType Enviado en cada hito; se muestra como pev3 en la llamada de Adobe Analytics, generalmente enviada como "video"
eventdata.a.media.name Coincide exactamente con eventdata.videoName
eventdata.a.media.segment Contiene información sobre el segmento que se ha visto, por ejemplo: 2:O:4-8
NOTA

Puede establecer el nombre práctico de un vídeo abriendo el vídeo para editarlo en DAM y estableciendo el campo de metadatos Title en el nombre deseado.

  1. Después de seleccionar Hitos como método de seguimiento, en el cuadro Desplazamiento de seguimiento, introduzca una lista separada por comas de los desplazamientos de seguimiento en segundos. Por ejemplo, el siguiente valor define hitos en 4, 8, 16, 20 y 28 segundos después del inicio del vídeo:

    4,8,16,20,24
    

    Los valores de desplazamiento deben ser enteros que sean buenos a 0. El valor predeterminado es 10,25,50,75.

  2. Para asignar las variables de CQ a las propiedades de Adobe Analytics, arrastre las propiedades de Adobe Analytics desde ContentFinder junto a la variable de CQ en el componente.

    Para obtener información sobre la optimización de las asignaciones, consulte la guía Medición de vídeo en Adobe Analytics.

  3. Añada el marco a la página.

  4. Para probar la configuración en modo de Previsualización, reproduzca el vídeo para obtener llamadas de Adobe Analytics a déclencheur.

Los siguientes ejemplos de datos de seguimiento de Adobe Analytics se aplican al seguimiento de hitos mediante desplazamientos de seguimiento de 4, 8, 16, 20 y 24, y las siguientes asignaciones para las variables de CQ:

variable de CQ Propiedad Adobe Analytics
eventdata.videoName prop2
eventdata.videoFileName prop3
eventdata.videoFilePath prop4
eventdata.events.a.media.segmentView evento1
eventdata.events.a.media.timePlayed evento2
eventdata.events.a.media.view evento3
eventdata.events.a.media.complete evento4
eventdata.events.milestone4 evento10
eventdata.events.milestone8 evento11
eventdata.events.milestone16 evento12
eventdata.events.milestone20 evento13
eventdata.events.milestone24 evento14
eventdata.a.contentType eVar3
eventdata.a.media.name eVar1, prop1
eventdata.a.media.segment eVar2

Para este ejemplo, el componente Vídeo aparece de la siguiente manera en la página de marco:

video1

NOTA

Para ver las llamadas realizadas a Adobe Analytics, utilice una herramienta adecuada, como DigitalPulse Debugger o Fiddler.

Las llamadas a Adobe Analytics que utilicen el ejemplo proporcionado deben tener este aspecto cuando se visualizan con DigitalPulse Debugger:

chlimage_1-128

Esta es la primera​llamada realizada a Adobe Analytics que contiene los siguientes valores:

  • prop1 y eVar1 para eventdata.a.media.name,
  • props2-4, junto con eVar2 y eVar3 que contienen contentType (vídeo) y segment (1:O:1-4)
  • evento3 que se asignó a eventdata.eventos.a.media.vista.

chlimage_1-129

Esta es la tercera llamada​a Adobe Analytics:

  • prop1 y eVar1 contienen a.media.name;
  • evento 1 porque se ha visto un segmento
  • evento2 enviado con tiempo de reproducción = 4
  • evento11 enviado porque se ha alcanzado eventdata.eventos.milestone8
  • no se envían prop2 a 4 (ya que no se activó event.data.eventos.a.media.vista)

Hitos no heredados

El método de hitos no heredados es similar al método de hitos, excepto que los hitos se definen usando porcentajes de la longitud de la pista. Las características comunes son las siguientes:

  • Cuando una reproducción de vídeo supera un hito, la página llama a Adobe Analytics para realizar un seguimiento del evento.
  • El conjunto estático de variables de CQ que se definen para la asignación con propiedades de Adobe Analytics.
  • Para cada hito que defina, el componente crea una variable de CQ que puede asignar a una propiedad de Adobe Analytics.

El nombre de estas variables de CQ utiliza el siguiente formato:

El sufijo XX es el porcentaje de longitud de la pista que define el hito. Por ejemplo, si se especifican porcentajes de 10, 25, 50 y 75, se generan las siguientes variables de CQ:

  • eventdata.events.milestone10
  • eventdata.events.milestone25
  • eventdata.events.milestone50
  • eventdata.events.milestone75
eventdata.events.milestoneXX
  1. Después de seleccionar los hitos no heredados como método de seguimiento, en el cuadro Desplazamiento de seguimiento, introduzca una lista separada por comas de los porcentajes de la longitud de la pista. Por ejemplo, el siguiente valor predeterminado define hitos en un 10, 25, 50 y 75 por ciento de la longitud de la pista:

    10,25,50,75
    

    Los valores de desplazamiento deben ser enteros que sean buenos a 0.

  2. Para asignar las variables de CQ a las propiedades de Adobe Analytics, arrastre las propiedades de Adobe Analytics desde ContentFinder junto a la variable de CQ en el componente.

    Para obtener información sobre la optimización de las asignaciones, consulte la guía Medición de vídeo en Adobe Analytics.

  3. Añada el marco a la página.

  4. Para probar la configuración en modo de Previsualización, reproduzca el vídeo para obtener llamadas de Adobe Analytics a déclencheur.

Hitos heredados

Este método es similar al método Hitos con la diferencia de que los hitos especificados en el campo Desplazamiento de seguimiento son porcentajes en lugar de puntos establecidos dentro del vídeo.

NOTA

El campo Desplazamiento de seguimiento solo acepta una lista separada por comas que contenga números enteros entre 1 y 100.

  1. Establezca el desplazamiento de la pista.

    • e.g.10,50,75,100

    Además, la información enviada a Adobe Analytics es menos personalizable; solo hay 3 variables disponibles para la asignación:

eventdata.videoName
Las variables asignadas a esto contendrán el nombre práctico (Título) del video si se establece en el DAM; si no se establece el Título, se enviará en su lugar el nombre de archivo del vídeo. Solo se envía una vez, al comienzo de la reproducción de un vídeo.
eventdata.videoFileName Las variables asignadas a esto contendrán el nombre del archivo. Solo se envía una vez, al comienzo de la reproducción de un vídeo.
eventdata.videoFilePath La variable asignada a esto contendrá la ruta del archivo en el servidor. Solo se envía una vez, al comienzo de la reproducción de un vídeo.
NOTA

Puede establecer el nombre práctico de un vídeo abriendo el vídeo para editarlo en DAM y estableciendo el campo de metadatos Title en el nombre deseado. También debe guardar los cambios realizados al finalizar.

  1. Asigne estas variables a props 1 a 3

    El resto de la información relevante en la llamada se enviará concatenado en una variable denominada pev3.

    Las llamadas de muestra a Adobe Analytics que utilizan el ejemplo proporcionado deben tener este aspecto cuando se visualizan con DigitalPulse Debugger:

    lmilestones1

    La variable pev3​enviada en la llamada contiene la siguiente información:

    • Nombre : el nombre del archivo de vídeo (film.avi)

    • Duración : duración del archivo de vídeo, en segundos (100)

    • Nombre del reproductor: reproductor de vídeo utilizado para reproducir el archivo de vídeo (vídeo ** HTML5)

    • Segundos totales reproducidos : el número total de segundos que se reprodujo el vídeo (25)

    • Marca de hora de inicio: marca de hora que identifica cuándo se inició la reproducción del vídeo (1331035567)

    • Sesión de reproducción: los detalles de la sesión de reproducción. Este campo indica cómo interactuó el usuario con el vídeo. Esto puede incluir datos como dónde empezaron a reproducir el vídeo, si utilizaron el deslizador del vídeo para avanzar y dónde dejaron de reproducirse el vídeo (L10E24S58L58 - el vídeo se detuvo en segundos. 25 de la sección L10, luego se omitió a seg. 48)

Segundos heredados

Al utilizar el método de segundos heredados, las llamadas de Adobe Analytics se activan cada N-ésimo segundo, donde N se especifica en el campo Desplazamiento de seguimiento.

  1. Establezca el desplazamiento de seguimiento en cualquier número de segundos,

    • p. ej. 6
    NOTA

    El campo Desplazamiento de seguimiento solo acepta números enteros superiores a 0

    La información enviada a Adobe Analytics es menos personalizable. Solo hay 3 variables disponibles para la asignación:

eventdata.videoName
Las variables asignadas a esto contendrán el nombre práctico (Título) del video si se establece en el DAM; si no se establece el Título, se enviará en su lugar el nombre de archivo del vídeo. Solo se envía una vez, al comienzo de la reproducción de un vídeo.
eventdata.videoFileName La variable asignada a esto contendrá el nombre del archivo. Solo se envía una vez, al comienzo de la reproducción de un vídeo.
eventdata.videoFilePath La variable asignada a esto contendrá la ruta del archivo en el servidor. Solo se envía una vez, al comienzo de la reproducción de un vídeo.
NOTA

Puede establecer el nombre práctico de un vídeo abriendo el vídeo para editarlo en DAM y estableciendo el campo de metadatos Title en el nombre deseado. También debe guardar los cambios realizados al finalizar.

  1. Asigne estas variables a prop1, prop2 y prop3

    El resto de la información relevante en la llamada se enviará concatinada en una variable denominada pev3.

    Las llamadas a Adobe Analytics que utilicen el ejemplo proporcionado deben tener este aspecto cuando se visualizan con DigitalPulse Debugger:

    lseconds

    La llamada es similar a la llamada de hitos heredados de arriba. Consulte la información sobre pev3 proporcionada aquí.

Referencias utilizadas en este tutorial:

[0] https://docs.adobe.com/content/help/es-ES/media-analytics/using/media-overview.html

En esta página