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

Dentro de un Marco de Sitio Web, tanto los eventos del ratón como 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 una AOI de sitio web, en su totalidad. Para la mirada, consulta la Guía de Seguimiento de la Mirada en Marcos de Sitio Web, la configuración del evento de activación ya se cubre allí en detalle y no se repite aquí.

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

Fuera de un Marco de Sitio Web, el seguimiento del ratón generalmente solo funciona: la propiedad de seguimiento continuo del ratón de un marco registra el movimiento del cursor pasivamente, sin necesidad de un activador. 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 Web Bridge de Labvanced, es la única manera de obtener datos del ratón desde dentro del marco. Si no construyes uno, una AOI de sitio web no registra nada sobre el comportamiento del ratón, en silencio, de la misma manera que una AOI no anclada no registra nada sin que te des cuenta.

Los Tres Modos de Selección

Agrega un evento Mouse Trigger y, dentro de un Marco de Sitio Web, su sección Targets: ofrece tres modos en lugar de un solo selector de objetivos:

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

Si las AOIs se superponen, el modo de selección 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 la que está visualmente en la parte superior, así que tu objetivo aún se activa incluso si hay una AOI diferente apilada sobre ella allí. Los modos Any element in website frame y Any AOI element, y Hover/Leave/Move sin importar el modo, solo consideran el único elemento más superior en ese punto.

Construyendo el Evento

1. Agrega un nuevo evento, selecciona Mouse Trigger.
2. Establece Action: en la interacción que deseas: Click, PressDown, PressUp, Hover, Leave, o Move. Para Click, PressDown, y PressUp, también aparece un menú desplegable Button:, Left o Right, para restringir el activador a un botón del ratón.
3. Escoge un modo de selección de la tabla anterior. Si dejas ambas casillas sin marcar, haz clic en Add Target y selecciona la(s) AOI de sitio web que deseas.
4. Agrega una acción Set / Record Variable para capturar datos, un evento sin una no registra nada, lo mismo que una 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 de 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 se encuentran los valores específicos de este evento, descritos en la siguiente sección.

Activador: 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 de la AOI junto a su X/Y relativa a la página en cada movimiento del ratón sobre cualquier AOI registrada, sin necesidad de un evento separado por AOI.

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

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 coordenadas relativas a la página, la posición en el área desplazable completa de la página incrustada, incluyendo cualquier cosa que el participante haya desplazado.
• Hover, Leave informan coordenadas relativas al elemento en su lugar, la posición dentro de la AOI misma, no de la página.

Ambas están etiquetadas de manera idéntica (MouseX, MouseY) en el selector de valores, nada en la interfaz las 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 activó el evento, la misma etiqueta Stimulus Info cubierta en Nombrando una AOI para Tus Datos Exportados, útil una vez que estás grabando desde más de una AOI o desde el modo Any AOI element. Element Text lleva el texto visible de la AOI en el momento del evento.

Compartido con la Mirada: Las Coordenadas Relativas a la Página Incluyen el Desplazamiento

Las coordenadas relativas a la página descritas anteriormente (para Click, PressDown, PressUp, Move) incluyen el desplazamiento interno del iframe, no solo lo que es actualmente visible en el viewport. Las coordenadas de la mirada registradas en una AOI de sitio web funcionan de la misma manera. Si estás combinando datos de ratón y mirada desde la misma AOI durante el análisis, ambos utilizan este mismo espacio de coordenadas relativas a la página, por lo 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 independiente de "posición de desplazamiento actual" 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 su propia variable grabable. Si necesitas el comportamiento de desplazamiento en una subregión desplazable dentro de una AOI específicamente, esa es una configuración separada, Scrollable container en la AOI misma, cubierta en Seguimiento de una Subregión Desplazable, y sus datos resultantes están disponibles solo a través del activador Eyetracking Gaze/Eyetracking Fixation, no Mouse Trigger.

Solución de Problemas

El evento nunca se activa. Confirma que la extensión Web Bridge está instalada y activa, nada llega a un Mouse Trigger dentro de un Marco de Sitio Web sin ella. Si estás utilizando objetivos específicos, confirma que la AOI que seleccionaste está realmente anclada, una AOI no anclada (selectorFound falsa) no activará eventos dirigidos aunque el activador en sí esté configurado correctamente.

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

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

Preguntas Frecuentes

Lectura Adicional