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 Aug 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Temas:

Creado para:

  • Administrador

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
AEM Antes de continuar, asegúrate de que has subido un vídeo reproducible en el que se puede hacer clic en el botón de.
AEM Para asegurarte de que tus vídeos se reproduzcan en la página, consulta este tutorial para obtener información sobre 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 use las opciones heredadas para el seguimiento de vídeo. En su lugar, use el método Milestones.

Pasos comunes common-steps

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

  2. Crear una configuración y un módulo 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 nombre descriptivo (Título) del vídeo si se establece en DAM; si no se establece, se enviará el nombre de archivo del vídeo 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 envió cuando el vídeo terminó de reproducirse
eventdata.events.milestoneX
Enviado cuando se pase el hito dado, X significa el segundo en que el hito se activa en
eventdata.a.contentType
Enviado en cada hito; aparece como pev3 en la llamada de Adobe Analytics, 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 nombre fácil de usar 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, 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 guía Medición de vídeo en Adobe Analytics.

  3. Agregar el marco de trabajo a la página.

  4. Para probar la configuración en modo de vista previa, 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
evento2
eventdata.events.a.media.view
event3
eventdata.events.a.media.complete
evento4
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:

vídeo1

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

Esta es la primera llamada ​a 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 (11-4)
  • event3 asignado a eventdata.events.a.media.view.

chlimage_1-129

Esta es la tercera llamada ​realizada a Adobe Analytics:

  • prop1 y eVar 1 contienen a.media.name;
  • evento1 porque se ha visto un segmento
  • evento2 enviado con tiempo de reproducción = 4
  • evento11 enviado porque se ha alcanzado eventdata.events.milestone8
  • prop2 a 4 no se envían (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 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 guía Medición de vídeo en Adobe Analytics.

  3. Agregar el marco de trabajo a la página.

  4. Para probar la configuración en modo de vista previa, 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 el campo Desplazamiento de seguimiento son porcentajes en lugar de puntos de conjunto 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 nombre descriptivo (Título) del vídeo si se establece en DAM; si no se establece el Título, se enviará el nombre de archivo del vídeo en su lugar. Solo se envió 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 nombre fácil de usar 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 cuando termine.

  1. Asigne estas variables a las 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 usen el ejemplo proporcionado deberían tener este aspecto cuando se visualicen con DigitalPulse Debugger:

    hitos1

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

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

    • Longitud - La longitud del archivo de vídeo, en segundos (100)

    • Nombre del reproductor - El reproductor de vídeo usado para reproducir el archivo de vídeo (vídeo del HTML 5)

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

    • Iniciar marca de tiempo - Marca de tiempo que identifica cuándo comenzó la reproducción de 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 usaron el control deslizante 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 nombre descriptivo (Título) del vídeo si se establece en DAM; si no se establece el Título, se enviará el nombre de archivo del vídeo en su lugar. Solo se envió 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 nombre fácil de usar 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 cuando termine.

  1. Asigne estas variables a prop1, prop2 y prop3

    El resto de la información relevante de la llamada se enviará concatenado a la variable one 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 de hitos heredados anterior. Consulte la información sobre pev3 proporcionada en Integración con Adobe Analytics.

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