DocumentaciónAEM 6.5Guía del usuario

Configuración del seguimiento de vídeo para Adobe Analytics configuring-video-tracking-for-adobe-analytics

Last update: Thu Apr 11 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creado para:

  • Admin

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.

NOTE
Antes de continuar, asegúrese de que dispone de un vídeo reproducible AEM cargado dentro de un intervalo de fechas.
Para asegurarse de que los vídeos se reproduzcan en la página, consulte este tutorial AEM para obtener información acerca de cómo transcodificar archivos de vídeo en la.

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

NOTE
Para nuevas implementaciones, se recomienda que no utilice las opciones heredadas de seguimiento de vídeo. Utilice el Hitos en su lugar.

Pasos comunes common-steps

  1. Configurar una página web arrastrando un componente de vídeo de la barra de tareas y añadir un elemento reproducible vídeo como recurso para el componente

  2. Creación de 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 el marco de trabajo.

  3. En la página marco de trabajo, seleccione un RSID y establezca el uso en todo. (https://localhost:4502/cf#/etc/cloudservices/sitecatalyst/videoconf/videofw.html)

  4. En la categoría General, en Sidekick, arrastre el componente Vídeo al módulo.

  5. Seleccione un método de seguimiento:

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

Hitos milestones

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

Para utilizar el método Milestones, especifique los desplazamientos de seguimiento basados en el tiempo para definir los hitos. Cuando la reproducción de un 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 creará 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 desvío de 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 CQ
Propiedades de Adobe Analytics
eventdata.videoName
Las variables asignadas a esto contendrán el fácil de usar name (Título) del vídeo si se establece en DAM; si no se establece, el nombre de archivo se enviarán en su lugar. Solo se envía una vez, al principio de la reproducción de un vídeo.
eventdata.videoFileName
Las variables asignadas a esta variable contienen el nombre del archivo. Solo se envía junto con eventdata.events.a.media.view
eventdata.videoFilePath
Las variables asignadas a esta variable contienen 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 de segmento
eventdata.events.a.media.timePlayed
Cada vez que se activa un hito, se envía junto con este evento el número de segundos que el usuario ha invertido en ver un 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 termina de reproducirse el vídeo
eventdata.events.milestoneX
Enviado cuando se pasa el hito determinado, X significa el segundo en el que se activa el hito
eventdata.a.contentType
Se envía en cada hito; aparece como pev3 en la llamada de Adobe Analytics y normalmente se envía como "vídeo"
eventdata.a.media.name
Exactamente coincide con eventdata.videoName
eventdata.a.media.segment
Contiene información sobre el segmento que se ha visto, por ejemplo, 2:O:4-8
NOTE
Puede establecer el de un vídeo fácil de usar nombre abriendo el vídeo para editarlo en el DAM y configurando el Título campo de metadatos con el nombre deseado.

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

    code language-xml 
    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 CQ a las propiedades de Adobe Analytics, arrastre las propiedades de Adobe Analytics desde ContentFinder junto a la variable CQ en el componente.

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

  3. Añadir el marco de trabajo 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 al déclencheur.

Los siguientes ejemplos de datos de seguimiento de Adobe Analytics se aplican al seguimiento de Milestone mediante desplazamientos de seguimiento de 4, 8, 16, 20 y 24, y a 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
EVAR 3
eventdata.a.media.name
eVar 1, prop1
eventdata.a.media.segment
EVAR 2

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

video1

NOTE
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 deberían tener este aspecto cuando se visualicen con DigitalPulse Debugger:

chlimage_1-128

Este es el primera llamada ​realizado en Adobe Analytics que contiene los siguientes valores:

  • prop1 y eVar 1 para eventdata.a.media.name,
  • props2-4, junto con eVar 2 y eVar 3 que contienen contentType (vídeo) y segmento (1)1-4)
  • event3, que se ha asignado a eventdata.events.a.media.view.

chlimage_1-129

Este es el tercera llamada ​realizado en Adobe Analytics:

  • prop1 y eVar 1 contienen a.media.name;
  • evento1 porque se ha visto un segmento
  • event2 enviado con tiempo de reproducción = 4
  • event11 enviado porque se ha alcanzado eventdata.events.milestone8
  • no se envían prop2 a 4 (ya que eventdata.events.a.media.view no se activó)

Hitos no heredados non-legacy-milestones

El método de hitos no heredados es similar al método de hitos, excepto que los hitos se definen mediante porcentajes de la longitud de la pista. Los elementos comunes son los siguientes:

  • Cuando la reproducción de un vídeo supera un hito, la página llama a Adobe Analytics para realizar un seguimiento del evento.
  • El conjunto estático de variables CQ que se definen para su asignación con propiedades de Adobe Analytics.
  • Para cada hito que defina, el componente creará 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 pista que define el hito. Por ejemplo, si se especifican porcentajes de 10, 25, 50 y 75, se generarán 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 porcentajes de longitud de seguimiento. Por ejemplo, el siguiente valor predeterminado define hitos en el 10, 25, 50 y 75 por ciento de la longitud de la pista:

    code language-xml 
    10,25,50,75

    Los valores de desplazamiento deben ser enteros mayores que 0.

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

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

  3. Añadir el marco de trabajo 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 al déclencheur.

Hitos heredados legacy-milestones

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

NOTE
El campo Tracking offset solo acepta una lista separada por comas que contenga números enteros entre 1 y 100.

  1. Defina el desplazamiento de pista.

    • por ejemplo,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 fácil de usar name (Título) del vídeo si se establece en DAM; si no se establece el Título, el nombre de archivo se enviarán en su lugar. Solo se envía una vez, al principio de la reproducción de un vídeo.
eventdata.videoFileName
Las variables asignadas a esta variable contienen el nombre del archivo. Solo se envía una vez, al principio de la reproducción de un vídeo.
eventdata.videoFilePath
La variable asignada a esta ruta contiene la ruta del archivo en el servidor. Solo se envía una vez, al principio de la reproducción de un vídeo.
NOTE
Puede establecer el de un vídeo fácil de usar nombre abriendo el vídeo para editarlo en el DAM y configurando el Título campo de metadatos con el nombre deseado. También debe Guardar los cambios realizados cuando termine.

  1. Asigne estas variables a las props 1 a 3

    El resto de la información pertinente en la llamada se enviará concatenado a uno variable denominada pev3.

    Llamadas de ejemplo Las conexiones a Adobe Analytics mediante el ejemplo proporcionado deberían tener este aspecto cuando se visualizan con DigitalPulse Debugger:

    hitos1

    El pev3 ​enviada en la llamada de contiene la siguiente información:

    • Nombre - El nombre del archivo de vídeo (film.avi)

    • Longitud : 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 de HTML5)

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

    • Marca de tiempo de inicio - Marca de tiempo que identifica cuándo comenzó la reproducción del vídeo (1331035567)

    • Reproducir sesión - Los detalles de la sesión de juego. Este campo indica cómo interactuó el usuario con el vídeo. Esto puede incluir datos como dónde comenzaron a reproducir el vídeo, si utilizaron el deslizador de vídeo para avanzar el vídeo y dónde dejaron de reproducirlo (L10E24S58L58: el vídeo se detuvo a los segundos. 25 de la sección L10, y después se salta a sec. 48)

Segundos heredados legacy-seconds

Al utilizar el método ​ legacy seconds, las llamadas de Adobe Analytics se activan cada N-ésimo segundo, donde N se especifica en el campo Track offset.

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

    • por ejemplo, 6
    note note
    NOTE
    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 fácil de usar name (Título) del vídeo si se establece en DAM; si no se establece el Título, el nombre de archivo se enviarán en su lugar. Solo se envía una vez, al principio de la reproducción de un vídeo.
eventdata.videoFileName
La variable asignada a esta acción contiene el nombre del archivo. Solo se envía una vez, al principio de la reproducción de un vídeo.
eventdata.videoFilePath
La variable asignada a esta ruta contiene la ruta del archivo en el servidor. Solo se envía una vez, al principio de la reproducción de un vídeo.
NOTE
Puede establecer el de un vídeo fácil de usar nombre abriendo el vídeo para editarlo en el DAM y configurando el Título campo de metadatos con el nombre deseado. También debe Guardar los cambios realizados cuando termine.

  1. Asigne estas variables a prop1, prop2 y prop3

    El resto de la información pertinente en la llamada se enviará concatenado a uno variable denominada pev3.

    Las llamadas a Adobe Analytics que utilicen el ejemplo proporcionado deberían tener este aspecto cuando se visualicen con DigitalPulse Debugger:

    lseconds

    La llamada es similar a la llamada a los hitos heredados anterior. Ver la información de pev3 proporcionado allí.

Referencias utilizadas en este tutorial:

[0] https://experienceleague.adobe.com/docs/media-analytics/using/media-overview.html?lang=es

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2