labvanced logoLabVanced
  • Research
    • Publications
    • Researcher Interviews
    • Use Cases
      • Developmental Psychology
      • Linguistics
      • Clinical & Digital Health
      • Educational Psychology
      • Cognitive & Neuro
      • Social & Personality
      • Arts Research
      • Sports & Movement
      • Marketing & Consumer Behavior
      • Economics
      • HCI / UX
      • Commercial / Industry Use
    • Labvanced Blog
    • Services
  • Technology
    • Feature Overview
    • Code-Free Study Building
    • Eye Tracking
    • Mouse Tracking
    • Generative AI Integration
    • Multi User Studies
    • More ...
      • Reaction Time/Precise Timing
      • Text Transcription
      • Heart Rate Detection (rPPG)
      • Emotion Detection
      • Questionnaires/Surveys
      • Experimental Control
      • Data Privacy & Security
      • Desktop App
      • Mobile App
  • Learn
    • Guide
    • Videos
    • Walkthroughs
    • FAQ
    • Release Notes
    • Documents
    • Classroom
  • Experiments
    • Cognitive Tests
    • Sample Studies
    • Public Experiment Library
  • Pricing
    • Licenses
    • Top-Up Recordings
    • Subject Recruitment
    • Study Building
    • Dedicated Support
    • Checkout
  • About
    • About Us
    • Contact
    • Downloads
    • Careers
    • Impressum
    • Disclaimer
    • Privacy & Security
    • Terms & Conditions
    • Third-Party Licenses
  • Appgo to app icon
  • Logingo to app icon
Learn
Guide
Vidéos
Guides étape par étape
FAQ
Archives des newsletters
Documents
Salle de classe
  • 中國人
  • Deutsch
  • Français
  • Español
  • English
  • 日本語
Guide
Vidéos
Guides étape par étape
FAQ
Archives des newsletters
Documents
Salle de classe
  • 中國人
  • Deutsch
  • Français
  • Español
  • English
  • 日本語
  • Guide
    • DÉBUTER

      • Éditeur de tâches
      • Cadres
        • Cadre Canvas
        • Cadre de Page
        • Cadre de Site Web
      • Chronologie des essais
      • Présentation des stimuli
      • Exactitude de la réponse
      • Objets
      • Événements
      • Variables
      • Assistant de tâche
      • Système d'essai
      • Conception de l'expérience
        • Création d'une étude
        • Modèles de Cadre de Données
        • Conception d'expérimentations multi-utilisateurs
        • Conception d'expérimentations longitudinales
    • Sujets en vedette

      • Randomisation & Équilibre
      • Suivi oculaire
        • Présentation des Stimuli dans une Tâche de Suivi oculaire
        • Comment Choisir les Paramètres de Calibration de Suivi Oculaire
        • Configuration du suivi oculaire dans une tâche
        • Enregistrement et exportation des données de regard
        • Utilisation des formes comme zones d'intérêt (AOI) pour le suivi oculaire
        • L'expérience de calibration du participant
      • Pont Web
        • Sélectionner les AOI de site Web | Ancrer, ajuster et vérifier le suivi des AOI
        • Suivi du comportement de la souris sur une AOI de site Web | Guide Web Bridge
      • Questionnaires
      • Application de bureau
      • Études échantillons
      • Recrutement de participants
      • Accès API
        • API REST
        • API Webhook
        • API WebSocket
      • Autres sujets

        • Temps de stimuli précis
        • Études multi-utilisateurs
        • Suivi de la Tête dans Labvanced | Guide
    • ONGLETS PRINCIPAUX DE L'APPLICATION

      • Aperçu : Onglets principaux
      • Tableau de bord
      • Mes études
      • Études partagées
      • Mes fichiers
      • Bibliothèque d'expériences
      • Mon compte
      • Licence & Services
    • ONGLETS D'ÉTUDE

      • Aperçu : Onglets spécifiques à l'étude
      • Conception de l'étude
        • Tâches
        • Blocs
        • Sessions
        • Groupes
      • Éditeur de tâches
        • Contrôles de tâche
        • Le Système des Essais
        • Types de cadres
        • Objets
        • Tables de Propriétés des Objets
        • Variables
        • Tableau des Variables Système
        • Le Système d'Événements
        • Fonctions de l'Éditeur de Texte
        • Options de suivi oculaire dans l'éditeur de tâches
        • Suivi de la tête dans une tâche
        • Études Multi-Utilisateurs
      • Paramètres
      • Variables
      • Média
      • Textes & Traduire
      • Lancer & Participer
      • Gestion des sujets
      • Vue de données et Exportation
        • Vue des données et sélection des variables & des tâches (ancienne version)
        • Accéder aux Enregistrements (Version ANCIENNE)
  • Vidéos
    • Aperçu des Vidéos
    • Premiers Pas dans Labvanced
    • Création de Tâches
    • Vidéos d'Éléments
    • Événements & Variables
    • Sujets Avancés
  • Tutoriaux
    • Introduction
    • Tâche Stroop
    • Tâche de Décision Lexicale
    • Tâche de Cues Visuels de Posner
    • Paradygme de Flicker de Cécité au Changement
    • Étude d'Œil-Tracking
    • Étude d'Œil-Tracking des Nourrissons
    • Étude de Capture d'Attention avec Suivi au Souris
    • Présentation Visuelle Sérielle Rapide
    • Étude ChatGPT
    • Démo de Suivi Occulaire : SVG en tant qu'AOI
    • Démo Multi-Utilisateur : Montrer les Curseurs des Sujets
    • Contrôleur de Gamepad / Joystick - Configuration de Base
    • Étude d'App Desktop avec Intégration EEG
    • Équilibrage de Groupes entre Sujets et Configuration des Variables
    • Construction d'une Étude Multi-Utilisateur
    • Tutoriel de Suivi Occulaire dans un Cadre de Site Web
    • Suivi Occulaire Conditionnel avec Webcam
    • Construction d'une Étude de Segmentation de Texte
  • FAQ
    • Fonctionnalités
    • Politique de Support & Directives
    • Sécurité & Confidentialité des Données
    • Licences
    • Précision de Labvanced
    • Utilisation Programmatique & API
    • Utiliser Labvanced Hors Ligne
    • Dépannage
    • Questions sur la Création d'Études
  • Archive de Newsletter
  • Documents
  • Salle de Classe
Un événement de déclenchement de souris se déclenchant sur une AOI de site Web à l'intérieur d'un cadre de site Web Labvanced

Suivi du comportement de la souris sur une AOI de site Web

À l'intérieur d'un cadre de site Web, les événements de souris et le regard sont enregistrés de la même manière sous-jacente : aucun ne peut cibler autre chose qu'un élément Website AOI, c'est le seul objet qu'un cadre de site Web peut contenir. Cette page couvre la création d'un événement Mouse Trigger sur une AOI de site Web, dans son intégralité. Pour le regard, consultez le Guide de suivi du regard dans le cadre du site Web, la configuration de son propre événement de déclenchement y est déjà abordée en détail et n'est pas répétée ici.

Pourquoi cela nécessite une configuration ici, contrairement à d'autres endroits dans Labvanced

En dehors d'un cadre de site Web, le suivi de souris fonctionne principalement : la propriété de suivi de souris continue d'un cadre enregistre le mouvement du curseur de manière passive, sans déclencheur requis. À l'intérieur de la page intégrée d'un cadre de site Web, ce suivi passif ne se déclenche jamais, le navigateur du participant ne transmet pas le mouvement de la souris à la page parente tant que le curseur est sur un iframe, quel que soit le paramètre Labvanced. Une Mouse Trigger, soutenue par l'extension Web Bridge de Labvanced, est le seul moyen d'obtenir des données de souris de l'intérieur du cadre. Si vous ne construisez pas un tel objet, une AOI de site Web n'enregistre rien concernant le comportement de la souris, silencieusement, de la même manière qu'une AOI sans ancrage n'enregistre rien sans que vous le remarquiez.

Les trois modes de ciblage

Ajoutez un événement Mouse Trigger et, à l'intérieur d'un cadre de site Web, sa section Targets: propose trois modes au lieu d'un seul sélecteur de cible :

ModeCe qu'il fait
Any element in website frameSe déclenche pour l'interaction choisie n'importe où sur la page intégrée, que cela se produise ou non sur une AOI enregistrée.
Any AOI elementSe déclenche chaque fois que l'interaction se produit sur une AOI de site Web enregistrée, sans avoir à les choisir individuellement.
Choisir des cibles spécifiques (par défaut, aucune case cochée)Se déclenche uniquement pour les AOI de site Web que vous avez explicitement ajoutées comme cibles.

C'est un choix plus riche que ce que le regard obtient sur le même cadre : les déclencheurs Eyetracking Gaze/Eyetracking Fixation n'offrent que deux modes, Only trigger when looking at specific elements décoché (se déclenche en continu, sans ciblage, chaque fois que de nouvelles données de regard existent) ou coché (limité à des cibles AOI spécifiques choisies). Il n'y a pas d'équivalent de regard à Any AOI element.

Si des AOI se chevauchent, le mode de ciblage change ce qui compte. Pour Click, PressDown, et PressUp avec des cibles spécifiques choisies, Labvanced vérifie chaque AOI au point de clic, pas seulement celle visuellement en haut, donc votre cible se déclenche toujours même si une AOI différente est empilée au-dessus d'elle. Les modes Any element in website frame et Any AOI element, et Hover/Leave/Move indépendamment du mode, prennent uniquement en compte le seul élément le plus en haut à ce point.

Construction de l'événement

  1. Ajoutez un nouvel événement, sélectionnez Mouse Trigger.
  2. Définissez Action: sur l'interaction que vous souhaitez : Click, PressDown, PressUp, Hover, Leave, ou Move. Pour Click, PressDown, et PressUp, un menu déroulant Button: apparaît également, Left ou Right, pour restreindre le déclencheur à un bouton de souris.
  3. Choisissez un mode de ciblage dans le tableau ci-dessus. Si vous laissez les deux cases décochées, cliquez sur Add Target et sélectionnez l(es) AOI de site Web que vous souhaitez.
  4. Ajoutez une action Set / Record Variable pour vraiment capturer des données, un événement sans cela n'enregistre rien, de la même manière qu'une AOI sans un événement Eyetracking Gaze attaché. Définissez le format de la variable sur Array. Pour le type d'enregistrement, Final value garde uniquement la dernière occurrence et Time series garde chaque occurrence. Choisir Time series révèle une option Sampling method supplémentaire : record all (allow repeated duplicates) ou record changes only (no repeated duplicates).
  5. Dans le menu de sélection de valeur, choisissez parmi la catégorie Trigger (Mouse), c'est là que se trouvent les valeurs spécifiques à cet événement, décrites dans la section suivante.

Déclencheur : Mouse Trigger → Action : Move → Targets : Any AOI element
Action : Set / Record Variable → Format : Array, Type d'enregistrement : Time series, Méthode d'échantillonnage : record all (allow repeated duplicates) → valeur : Mouse [Name, Info, X, Y] Array de Trigger (Mouse)

Cela enregistre le nom et l'étiquette de l'AOI aux côtés de ses coordonnées X/Y relatives à la page à chaque mouvement de souris sur toute AOI enregistrée, sans avoir besoin d'un événement séparé par AOI.

Choisir une valeur et l'espace de coordonnées qui l'accompagne

La catégorie Trigger (Mouse) propose :

ValeurCe qu'elle vous donne
MouseX / MouseYLa coordonnée X ou Y seule
Mouse [X,Y] ArrayLes deux coordonnées ensemble
Stimulus NameLe nom de l'objet AOI
Stimulus InfoL'étiquette Stimulus Info de l'AOI
Element TextLe texte visible de l'AOI au moment de l'événement
Mouse [Name, Info, X, Y] ArrayNom, Stimulus Info, et les deux coordonnées ensemble
Mouse [Name, Info, Text, X, Y] ArrayNom, Stimulus Info, texte visible, et les deux coordonnées ensemble

MouseX/MouseY (et les tableaux construits à partir d'eux) ne signifient pas la même chose selon le type d'interaction :

  • Click, PressDown, PressUp, Move rapportent des coordonnées relatives à la page, la position sur l'aire de défilement complète de la page intégrée, incluant tout ce que le participant a fait défiler.
  • Hover, Leave rapportent des coordonnées relatives à l'élément à la place, la position à l'intérieur de l'AOI elle-même, pas celle de la page.

Les deux sont étiquetés de manière identique (MouseX, MouseY) dans le sélecteur de valeur, rien dans l'interface ne les distingue au-delà du type d'interaction sur lequel l'événement est construit. Mélanger des données d'un événement Hover et d'un événement Move dans la même colonne exportée mélangera deux espaces de coordonnées différents sans aucun avertissement. Décidez à l'avance quel type d'interaction vous avez réellement besoin avant de raccorder l'action d'enregistrement.

Stimulus Name et Stimulus Info identifient quelle AOI l'événement s'est déclenché, la même étiquette Stimulus Info abordée dans Nommer une AOI pour vos données exportées, utile une fois que vous enregistrez à partir de plus d'une AOI ou à partir du mode Any AOI element. Element Text transporte le texte visible de l'AOI au moment de l'événement.

Partagé avec le regard : les coordonnées relatives à la page incluent le défilement

Les coordonnées relatives à la page décrites ci-dessus (pour Click, PressDown, PressUp, Move) incluent le décalage de défilement interne de l'iframe, pas seulement ce qui est actuellement visible dans le viewport. Les coordonnées de regard enregistrées sur une AOI de site Web fonctionnent de la même manière. Si vous combinez des données de souris et de regard provenant de la même AOI lors de l'analyse, les deux utilisent le même espace de coordonnées relatif à la page, donc elles s'alignent directement. Vous n'avez pas besoin de convertir l'une pour correspondre à l'autre.

La position de défilement de la page n'est pas une valeur distincte

La liste des données suivies du guide principal mentionne la position de défilement, mais il n'y a pas de valeur distincte "position de défilement actuelle" à enregistrer seule. Le décalage de défilement n'est appliqué qu'automatiquement à l'intérieur des coordonnées relatives à la page déjà décrites ci-dessus (Click, PressDown, PressUp, Move), pas exposé comme sa propre variable enregistrable. Si vous avez besoin du comportement de défilement sur une sous-région défilante au sein d'une AOI spécifiquement, c'est un paramètre séparé, Scrollable container sur l'AOI elle-même, couvert dans Suivi d'une sous-région défilante, et ses données résultantes ne sont disponibles que par le déclencheur Eyetracking Gaze/Eyetracking Fixation, pas Mouse Trigger.

Dépannage

L'événement ne se déclenche jamais. Vérifiez si l'extension Web Bridge est installée et active, rien n'atteint un Mouse Trigger à l'intérieur d'un cadre de site Web sans cela. Si vous utilisez des cibles spécifiques, vérifiez que l'AOI que vous avez choisie est réellement ancrée, une AOI non ancrée (selectorFound faux) ne déclenchera pas d'événements ciblés même si le déclencheur lui-même est correctement configuré.

Il se déclenche pour les mauvais éléments, ou trop souvent. Vérifiez quel mode de ciblage est sélectionné. Any element in website frame se déclenche partout, y compris en dehors de toute AOI, si ce n'est pas ce que vous vouliez dire, passez à Any AOI element ou choisissez des cibles spécifiques à la place.

Les coordonnées enregistrées semblent erronées ou incohérentes. Vérifiez quel type d'interaction l'événement utilise. Les coordonnées Hover/Leave sont relatives à l'AOI, Click/PressDown/PressUp/Move sont relatives à la page, voir Choisir une valeur ci-dessus.

Questions Fréquemment Posées

Pourquoi le paramètre de suivi de souris régulier du cadre ne fonctionne-t-il pas à l'intérieur d'un cadre de site Web ?
Parce que le navigateur du participant ne transmet jamais le mouvement de la souris à la page parente tant que le curseur est sur un iframe, c'est un comportement standard du navigateur, pas une limitation de Labvanced. Seul le flux d'événements propre à l'extension Web Bridge, via un Déclencheur de souris, peut voir l'activité de la souris à l'intérieur de la page intégrée.
Dois-je ajouter une AOI de site Web avant de pouvoir suivre le mouvement de la souris ?
Seulement si vous souhaitez cibler des éléments spécifiques ou utiliser le mode N'importe quel élément AOI. Le mode N'importe quel élément dans le cadre du site web se déclenche indépendamment de la manière dont l'interaction se produit sur une AOI de site Web enregistrée, donc il fonctionne même sans AOI ajoutée.
Pourquoi mes coordonnées de survol sont-elles tellement plus petites que mes coordonnées de clic sur la même AOI ?
Elles ne mesurent pas la même chose. Survol/Quitter rapportent des coordonnées relatives à l'élément AOI lui-même, tandis que Clic/AppuyerVersLeBas/Relâcher/Déplacer rapportent des coordonnées relatives à l'ensemble de la page. Les deux utilisent les mêmes noms de valeur MouseX/MouseY, donc cela n'est pas visible depuis le sélecteur de valeurs seul.
Quelle est la différence entre N'importe quel élément dans le cadre du site Web et N'importe quel élément AOI ?
N'importe quel élément dans le cadre du site Web se déclenche pour l'interaction n'importe où sur la page intégrée, AOI ou non. N'importe quel élément AOI ne se déclenche que lorsque l'interaction se produit sur une AOI de site Web enregistrée, mais ne nécessite pas que vous choisissiez laquelle, n'importe laquelle d'entre elles fera l'affaire.

Lectures Complémentaires

Labvanced Web Bridge | Support & Guide

Labvanced Web Bridge | Support & Guide

La référence complète : installation, cas d'utilisation, données et confidentialité, dépannage et FAQ.

Sélectionner et ajuster les AOIs de site Web

Sélectionner et ajuster les AOIs de site Web

Ancrez, ajustez et vérifiez une AOI de site Web avant de construire un événement dessus.

Guide de suivi du regard dans le cadre du site Web

Guide de suivi du regard dans le cadre du site Web

La configuration complète de l'événement de suivi du regard, y compris la boîte de dialogue de configuration de l'événement de suivi des yeux.

Prev
Sélectionner les AOI de site Web | Ancrer, ajuster et vérifier le suivi des AOI