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

Dentro de un Marco de Sitio Web, tanto los eventos de ratón como el seguimiento de la mirada se registran de la misma manera subyacente: ninguno puede apuntar a nada excepto a un elemento Website AOI, ese es el único objeto que un Marco de Sitio Web puede contener. Esta página cubre la construcción de un evento Mouse Trigger en un AOI de Sitio Web, en su totalidad. Para el seguimiento de la mirada, consulta el Tutorial de Seguimiento de la Mirada en un Marco de Sitio Web, la configuración del evento disparador ya se cubre allí en detalle y no se repite aquí.

Por Qué Esto Necesita Configuración Aquí, A Diferencia de Otros Lugares en Labvanced

Fuera de un Marco de Sitio Web, el seguimiento del ratón simplemente funciona: la propiedad de seguimiento continuo del ratón de un marco registra el movimiento del cursor de forma pasiva, sin necesidad de un disparador. Dentro de la página incrustada de un Marco de Sitio Web, ese seguimiento pasivo nunca se activa, 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 Puente Web de Labvanced, es la única forma de obtener algún dato del ratón desde dentro del marco. Si no construyes uno, un AOI de Sitio Web no registra nada sobre el comportamiento del ratón, en silencio, de la misma manera en que un AOI no anclado no registra nada sin que te des cuenta.

Los Tres Modos de Targeteo

Añade 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 del seguimiento de la mirada en el mismo marco: los disparadores Eyetracking Gaze/Eyetracking Fixation solo ofrecen dos modos, Only trigger when looking at specific elements sin marcar (se activa continuamente, sin objetivo, cada vez que exista un nuevo dato de mirada) o marcada (limitada a objetivos específicos elegidos). No hay un equivalente de mirada para Any AOI element.

Si los AOI se superponen, el modo de targeteo modifica 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, así que tu objetivo todavía se activa incluso si hay un AOI diferente apilado sobre él. 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 superior en ese momento.

Construcción del 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 Button:, Left o Right, para restringir el disparador a un botón del ratón.
3. Elige un modo de targeteo de la tabla anterior. Si dejas ambas casillas sin marcar, haz clic en Add Target y selecciona los AOI de Sitio Web que desees.
4. Agrega una acción Set / Record Variable para capturar datos, un evento sin ella no registra nada, igual que un AOI sin un evento Eyetracking Gaze adjunto. Establece el Formato de la variable a 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 para 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 con 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 en todos los tipos de interacción:

• Click, PressDown, PressUp, Move informan de coordenadas relativas a la página, la posición en el área desplazable total de la página incrustada, incluyendo cualquier cosa que el participante haya desplazado más allá.
• Hover, Leave informan de coordenadas relativas al elemento en su lugar, la posición dentro del propio AOI, no en la página.

Ambas están etiquetadas 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án dos espacios de coordenadas diferentes sin ninguna advertencia. Decide de antemano qué tipo de interacción realmente necesitas antes de configurar la acción de grabación.

Stimulus Name y Stimulus Info identifican en qué AOI se activó el evento, la misma etiqueta Stimulus Info cubierta en Nombrando un AOI para Tus Datos Exportados, útil una vez que estés registrando 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 la Mirada: Las Coordenadas Relativas a la Página Incluyen Desplazamiento

Las coordenadas relativas a la página descritas anteriormente (para Click, PressDown, PressUp, Move) incluyen el desplazamiento de desplazamiento interno del iframe, no solo lo que actualmente es visible en la ventana gráfica. Las coordenadas de la mirada registradas en un AOI de Sitio Web funcionan de la misma manera. Si estás combinando datos de ratón y de mirada desde el mismo AOI durante el análisis, ambos usan este mismo espacio de coordenadas relativas 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 de la guía principal menciona la posición de desplazamiento, pero no hay un valor "posición de desplazamiento actual" independiente para registrar por sí solo. El desplazamiento de desplazamiento solo se aplica automáticamente dentro de las coordenadas relativas a la página ya descritas anteriormente (Click, PressDown, PressUp, Move), no se expone como una variable grabable propia. Si necesitas el comportamiento de desplazamiento en una subregión desplazable dentro de un AOI específicamente, eso es una configuración separada, Scrollable container en el propio AOI, cubierta en Rastreo 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.

Solución de Problemas

El evento nunca se activa. Confirma que la extensión del Puente Web está instalada y activa, nada llega a un Mouse Trigger dentro de un Marco de Sitio Web sin ello. Si estás usando objetivos específicos, confirma que el AOI que seleccionaste esté realmente anclado, un AOI no anclado (selectorFound falso) no activará eventos dirigidos aunque el disparador en sí esté configurado correctamente.

Se activa para los elementos incorrectos o demasiado a menudo. Verifica qué modo de targeteo está seleccionado. Any element in website frame se activa en todas partes, incluyendo fuera de cualquier AOI, si eso no era lo que querías, cambia a Any AOI element o selecciona objetivos específicos en su lugar.

Las coordenadas registradas se ven incorrectas o inconsistentes. Verifica qué tipo de interacción usa 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