Show Menu
TEMAS×

Configuración del seguimiento de vídeo para Adobe Analytics

Hay varios métodos disponibles para el seguimiento de 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.
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 archivos de vídeo en AEM.
Utilice el procedimiento siguiente para configurar un marco para el seguimiento de vídeo con cada método.
En implementaciones nuevas, se recomienda no utilizar las opciones heredadas para el seguimiento de vídeo. En su lugar, utilice el método Hitos .

Pasos comunes

  1. Configure una página web arrastrando un componente de vídeo de 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 la 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 al marco.
  5. Seleccione un método de seguimiento:
  6. Al seleccionar un método de seguimiento, la lista de 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 las propiedades de Adobe Analytics.

Milestones

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 el 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 vídeo si se establece en el DAM; si no se establece, se enviará el nombre del 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 junto con eventdata.events.a.media.view
eventdata.videoFilePath Las variables asignadas a esto contendrán la ruta del archivo en el servidor. Solo se envía junto con eventdata.events.a.media.view
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. por ejemplo: 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 Enviado cuando se pasa el hito determinado, X representa el segundo en que se activa el hito
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
Puede definir el nombre práctico de un vídeo abriendo el vídeo para editarlo en DAM y estableciendo el campo de metadatos Título 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 mayores que 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 del 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. Agregue el marco a la página.
  4. Para probar la configuración en modo de vista previa, reproduzca el vídeo para que se activen las llamadas de Adobe Analytics.
Los siguientes ejemplos de datos de seguimiento de Adobe Analytics se aplican al seguimiento de hitos mediante compensaciones de seguimiento de 4, 8, 16, 20 y 24, y las siguientes asignaciones para las variables de CQ:
variable de CQ Propiedad de Adobe Analytics
eventdata.videoName prop2
eventdata.videoFileName prop3
eventdata.videoFilePath prop4
eventdata.events.a.media.segmentView event1
eventdata.events.a.media.timePlayed event2
eventdata.events.a.media.view event3
eventdata.events.a.media.complete event4
eventdata.events.milestone4 event10
eventdata.events.milestone8 event11
eventdata.events.milestone16 event12
eventdata.events.milestone20 event13
eventdata.events.milestone24 event14
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:
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:
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)
  • event3 que se asignó a eventData.events.a.media.view.
Esta es la tercera llamada ​realizada a Adobe Analytics:
  • prop1 y eVar1 contienen a.media.name;
  • event1 porque se ha visto un segmento
  • event2 enviado con tiempo de reproducción = 4
  • event11 enviado porque se ha alcanzado event.events.milestone8
  • no se envían prop2 a 4 (ya que event.events.a.media.view no se activó)

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 el seguimiento del evento.
  • 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 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 mayores que 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 del 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. Agregue el marco a la página.
  4. Para probar la configuración en modo de vista previa, reproduzca el vídeo para que se activen las llamadas de Adobe Analytics.

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.
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.
    • p. ej. 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 vídeo si se establece en el DAM; si no se establece el Título, se enviará el nombre del 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.
Puede definir el nombre práctico de un vídeo abriendo el vídeo para editarlo en DAM y estableciendo el campo de metadatos Título 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á concatenada en una variable denominada pev3 .
    Las llamadas de muestra a Adobe Analytics que utilicen el ejemplo proporcionado deben tener este aspecto cuando se visualizan con DigitalPulse Debugger:
    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 control deslizante para avanzar en el vídeo y dónde dejaron de reproducirlo ( 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
    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 vídeo si se establece en el DAM; si no se establece el Título, se enviará el nombre del 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.
Puede definir el nombre práctico de un vídeo abriendo el vídeo para editarlo en DAM y estableciendo el campo de metadatos Título 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á 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:
    La llamada es similar a la llamada de hitos heredados de arriba. Consulte la información sobre pev3 proporcionada allí .
Referencias utilizadas en este tutorial: