Seguimiento del Comportamiento del Ratón en un AOI del Sitio Web

Dentro de un marco de sitio web, tanto los eventos del ratón como la fijación se registran de la misma manera subyacente: ninguno puede apuntar a nada excepto a un elemento Website AOI, que es el único objeto que puede contener un marco de sitio web. Esta página cubre la construcción de un evento Mouse Trigger en un AOI del sitio web, en su totalidad. Para la fijación, consulte el Tutorial de Seguimiento de Fijación en el Marco de Sitios Web, la configuración del evento de disparo ya está cubierta allí en detalle y no se repite aquí.

Por Qué Esto Necesita Configuración Aquí, a Diferencia de Otras Partes de Labvanced

Fuera de un marco de sitio web, el seguimiento del ratón mayormente solo funciona: la propiedad de seguimiento continuo del ratón de un marco registra el movimiento del cursor de manera pasiva, sin necesidad de un disparador. Dentro de la página incrustada del marco de un sitio web, ese seguimiento pasivo nunca se dispara, el navegador del participante no entrega el movimiento del ratón a la página principal mientras el cursor está sobre un iframe, independientemente de cualquier configuración de Labvanced. Un Mouse Trigger, respaldado por la extensión Web Bridge de Labvanced, es la única forma de obtener datos del ratón desde dentro del marco en absoluto. Si no construyes uno, un AOI del sitio web no registra nada sobre el comportamiento del ratón, silenciosamente, de la misma manera que un AOI no anclado no registra nada sin que te des cuenta.

Los Tres Modos de Targeting

Agrega un evento Mouse Trigger y, dentro de un marco de sitio web, su sección Targets: ofrece tres modos en lugar de un único selector de objetivo:

Esta es una opción más rica que la que recibe la fijación en el mismo marco: los disparadores Eyetracking Gaze/Eyetracking Fixation ofrecen solo dos modos, Only trigger when looking at specific elements sin marcar (se dispara continuamente, sin objetivo, siempre que exista nuevo dato de fijación) o marcada (limitada a objetivos específicos seleccionados). No hay un equivalente de fijación para Any AOI element.

Si los AOIs se superponen, el modo de targeting cambia lo que cuenta. Para Click, PressDown, y PressUp con objetivos específicos seleccionados, Labvanced verifica cada AOI en el punto de clic, no solo el que visualmente está en la parte superior, por lo que tu objetivo aún se dispara incluso si hay un AOI diferente apilado sobre él allí. Los modos Any element in website frame y Any AOI element, y Hover/Leave/Move independientemente del modo, solo consideran el único elemento más alto en ese punto.

Construyendo el Evento

1. Agrega un nuevo evento, selecciona Mouse Trigger.
2. Establece Action: a la interacción que deseas: Click, PressDown, PressUp, Hover, Leave, o Move. Para Click, PressDown, y PressUp, también aparece un dropdown de Button:, Left o Right, para restringir el disparador a un botón del ratón.
3. Elige un modo de targeting de la tabla de arriba. Si dejas ambas casillas sin marcar, haz clic en Add Target y selecciona el(los) AOI(s) del sitio web que deseas.
4. Agrega una acción Set / Record Variable para capturar datos, un evento sin una no registra nada, igual que un AOI sin un evento Eyetracking Gaze adjunto. Establece el formato de la variable en Array. Para el tipo de registro, Final value mantiene solo la ocurrencia más reciente y Time series mantiene cada una. Elegir Time series revela una opción adicional Sampling method: record all (allow repeated duplicates) o record changes only (no repeated duplicates).
5. En el menú de selección de valores, elige de la categoría Trigger (Mouse), aquí es donde residen los valores específicos de este evento, descritos en la siguiente sección.

Disparador: Mouse Trigger → Action: Move → Targets: Any AOI element
Acción: Set / Record Variable → Formato: Array, Tipo de Registro: Time series, Método de Muestreo: record all (allow repeated duplicates) → valor: Mouse [Name, Info, X, Y] Array de Trigger (Mouse)

Esto registra el nombre y la etiqueta del AOI junto a su X/Y relativa a la página en cada movimiento del ratón sobre cualquier AOI registrado, sin necesidad de un evento separado por AOI.

Elegir un Valor, y el Espacio de Coordenadas que Viene con él

La categoría Trigger (Mouse) ofrece:

MouseX/MouseY (y los arreglos construidos a partir de ellos) no significan lo mismo a través de cada tipo de interacción:

• Click, PressDown, PressUp, Move reportan coordenadas relativas a la página, la posición en el área de desplazamiento total de la página incrustada, incluyendo lo que el participante ha desplazado más allá.
• Hover, Leave reportan coordenadas relativas al elemento en su lugar, la posición dentro del AOI mismo, no de la página.

Ambos están etiquetados idénticamente (MouseX, MouseY) en el selector de valores, nada en la interfaz los distingue más allá de qué tipo de interacción se basa el evento. Mezclar datos de un evento Hover y un evento Move en la misma columna exportada mezclará dos espacios de coordenadas diferentes sin ninguna advertencia. Decide de antemano qué tipo de interacción realmente necesitas antes de conectar la acción de grabación.

Stimulus Name y Stimulus Info identifican qué AOI disparó el evento, la misma etiqueta Stimulus Info cubierta en Nombrando un AOI para tus Datos Exportados, útil una vez que estás grabando desde más de un AOI o desde el modo Any AOI element. Element Text lleva el texto visible del AOI en el momento del evento.

Compartido con Fijación: Las Coordenadas Relativas a la Página Incluyen Desplazamiento

Las coordenadas relativas a la página descritas arriba (para Click, PressDown, PressUp, Move) incluyen el desplazamiento interno del iframe, no solo lo que actualmente es visible en el viewport. Las coordenadas de fijación registradas en un AOI del sitio web funcionan de la misma manera. Si estás combinando datos del ratón y de fijación desde el mismo AOI durante el análisis, ambos utilizan este mismo espacio de coordenadas relativo a la página, así que se alinean directamente. No necesitas convertir uno para que coincida con el otro.

La Posición de Desplazamiento de la Página No es un Valor Separado

La lista de datos rastreados del guía principal menciona la posición de desplazamiento, pero no hay un valor independiente de "posición de desplazamiento actual" para registrar por sí solo. El desplazamiento se aplica solo de manera automática dentro de las coordenadas relativas a la página ya descritas arriba (Click, PressDown, PressUp, Move), no expuesto como su propia variable registrable. Si necesitas el comportamiento de desplazamiento en una subregión desplazable dentro de un AOI específicamente, esa es una configuración separada, Scrollable container en el propio AOI, cubierto en Seguimiento de una Subregión Desplazable, y sus datos resultantes solo están disponibles a través del disparador Eyetracking Gaze/Eyetracking Fixation, no Mouse Trigger.

Resolución de Problemas

El evento nunca se dispara. Confirma que la extensión Web Bridge está instalada y activa, nada alcanza un Mouse Trigger dentro de un marco de sitio web sin ella. Si estás utilizando objetivos específicos, confirma que el AOI que eligiste está realmente anclado, un AOI no anclado (selectorFound falso) no disparará eventos dirigidos aunque el disparador en sí esté configurado correctamente.

Se dispara para los elementos incorrectos, o demasiadas veces. Verifica qué modo de targeting está seleccionado. Any element in website frame se dispara en todas partes, incluso fuera de cualquier AOI, si eso no es lo que meant, cambia a Any AOI element o elige objetivos específicos en su lugar.

Las coordenadas grabadas se ven incorrectas o inconsistentes. Verifica qué tipo de interacción está utilizando el evento. Las coordenadas Hover/Leave son relativas al AOI, Click/PressDown/PressUp/Move son relativas a la página, consulta Elegir un Valor arriba.

Preguntas Frecuentes

Lectura Adicional

Labvanced Web Bridge | Soporte y Guía

La referencia completa: instalación, casos de uso, datos y privacidad, resolución de problemas y preguntas frecuentes.

Seleccionando y Ajustando AOIs del Sitio Web

Ancla, ajusta y verifica un AOI del sitio web antes de construir un evento en él.

Tutorial de Seguimiento de Fijación en el Marco de Sitios Web

La configuración completa del evento de seguimiento de fijación, incluyendo el diálogo de Configuración de Evento de Fijación.