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
Anleitung
Videos
Anleitungen
Häufige Fragen
Newsletter-Archiv
Dokumente
Klassenzimmer
  • 中國人
  • Deutsch
  • Français
  • Español
  • English
  • 日本語
Anleitung
Videos
Anleitungen
Häufige Fragen
Newsletter-Archiv
Dokumente
Klassenzimmer
  • 中國人
  • Deutsch
  • Français
  • Español
  • English
  • 日本語
  • Leitfaden
    • ERSTE SCHRITTE

      • Aufgabeneditor
      • Rahmen
        • Canvas-Frame
        • Seitenrahmen
        • Website-Rahmen
      • Versuchstimeline
      • Stimulus-Präsentation
      • Richtigkeit der Antwort
      • Objekte
      • Ereignisse
      • Variablen
      • Aufgabenassistent
      • Versuchssystem
      • Experimentdesign
        • Eine Studie erstellen
        • Datenrahmenmuster
        • Design von Multi-User-Experimenten
    • HERVORGEHOBENE THEMEN

      • Randomisierung & Balance
      • Augenverfolgung
        • Präsentation von Stimuli in einer Eye Tracking-Aufgabe
        • Wie man die Einstellungen zur Kalibrierung des Eye Trackings auswählt
        • Einrichtung der Augenverfolgung in einer Aufgabe
        • Aufzeichnen und Exportieren von Blickdaten
        • Verwendung von Formen als Interessensgebiete (AOI) für Eye Tracking
        • Die Teilnehmerkalibrierungserfahrung
      • Web Brücke
        • Auswahl von Website-AOIs | Anker, Anpassung und Überprüfung des AOI-Trackings
        • Verfolgung des Mausverhaltens auf einer Website AOI | Web Bridge Anleitung
      • Fragebögen
      • Desktop-App
      • Beispielstudien
      • Teilnehmerrekrutierung
      • API-Zugriff
        • REST API
        • Webhook-API
        • WebSocket API
      • Andere Themen

        • Präzise Stimuluszeiten
        • Multi-User-Studien
        • Kopfverfolgung in Labvanced | Anleitung
    • HAUPTABLAE

      • Übersicht: Haupt-Registerkarten
      • Dashboard
      • Meine Studien
      • Geteilte Studien
      • Meine Dateien
      • Experiment-Bibliothek
      • Mein Konto
      • Lizenz & Dienstleistungen
    • STUDIENTER

      • Übersicht: Studien-spezifische Registerkarten
      • Studien-Design
        • Aufgaben
        • Blöcke
        • Sitzungen
        • Gruppen
      • Aufgabeneditor
        • Task Controls
        • Das Versuchs-System
        • Frame-Typen
        • Objekte
        • Objekt Eigenschaften Tabellen
        • Variablen
        • Systemvariablen-Tabellen
        • Das Ereignissystem
        • Texteditor-Funktionen
        • Optionen für das Eye Tracking im Task-Editor
        • Kopfverfolgung in einer Aufgabe
        • Multi-User-Studien
      • Einstellungen
      • Variablen
      • Medien
      • Texte & Übersetzen
      • Starten & Teilnehmen
      • Teilnehmerverwaltung
      • Datensicht und Export
        • Datensicht und Variablen- & Aufgaben Auswahl (alte Version)
        • Zugriff auf Aufnahmen (ALTE Version)
  • Videos
    • Videoübersicht
    • Erste Schritte in Labvanced
    • Aufgaben erstellen
    • Element Videos
    • Ereignisse & Variablen
    • Fortgeschrittene Themen
  • Anleitungen
    • Einführung
    • Stroop-Aufgabe
    • Lexikalische Entscheidungsaufgabe
    • Posner-Blicklenkungsaufgabe
    • Change Blindness Flicker Paradigma
    • Augenverfolgungsstudie
    • Studie zur Augenverfolgung bei Säuglingen
    • Studie zur Aufmerksamkeitslenkung mit Mausverfolgung
    • Schnelle serielle visuelle Präsentation
    • ChatGPT-Studie
    • Augenverfolgungsdemo: SVGs als AOIs
    • Multi-User-Demo: Zeige die Cursors der Teilnehmer
    • Gamepad / Joystick Controller - Grundeinstellung
    • Desktop-App-Studie mit EEG-Integration
    • Gruppenbalancierung und Variablen-Setup bei Zwischenstichproben
    • Aufbau einer Multi-User-Studie
    • Website-Frame Augenverfolgungs-Anleitung
    • Bedingte Webcam-Augenverfolgung
  • FAQ
    • Funktionen
    • Support-Richtlinie & Richtlinien
    • Sicherheit & Datenschutz
    • Lizenzierung
    • Genauigkeit von Labvanced
    • Programmgesteuerter Einsatz & API
    • Labvanced offline nutzen
    • Fehlerbehebung
    • Fragen zur Studieneerstellung
  • Newsletter-Archiv
  • Dokumente
  • Klassenzimmer

Verfolgung des Mausverhaltens auf einer Website AOI

Innerhalb eines Website-Rahmens werden sowohl Mausklicks als auch Blicke auf die gleiche grundlegende Weise aufgezeichnet: Nichts kann gezielt werden, außer einem Website AOI Element, das ist das einzige Objekt, das ein Website-Rahmen enthalten kann. Diese Seite behandelt den vollständigen Aufbau eines Mouse Trigger Ereignisses auf einer Website AOI. Für Blicke siehe das Website Frame Eye Tracking Walkthrough, die eigenen Ereigniseinstellungen für diesen Trigger sind dort bereits detailliert beschrieben und werden hier nicht wiederholt.

Warum dies hier eingerichtet werden muss, im Gegensatz zu anderen Bereichen in Labvanced

Außerhalb eines Website-Rahmens funktioniert die Mausverfolgung größtenteils einfach: Die kontinuierliche Mausverfolgungseigenschaft eines Rahmens zeichnet die Cursorbewegung passiv auf, ohne dass ein Trigger erforderlich ist. Innerhalb der eingebetteten Seite eines Website-Rahmens feuert diese passive Verfolgung niemals, der Browser des Teilnehmers liefert keine Mausbewegungen an die übergeordnete Seite, während der Cursor über ein iframe schwebt, unabhängig von einer Labvanced-Einstellung. Ein Mouse Trigger, der durch die Labvanced Web Bridge-Erweiterung unterstützt wird, ist der einzige Weg, um überhaupt Mausdaten aus dem Rahmen zu erhalten. Wenn Sie keinen erstellen, zeichnet eine Website AOI nichts über das Mausverhalten auf, still und leise, genau wie eine nicht verankerte AOI ohne Ihr Wissen nichts aufzeichnet.

Die drei Zielmodi

Fügen Sie ein Mouse Trigger Ereignis hinzu und in einem Website-Rahmen bietet der Targets: Abschnitt drei Modi anstelle eines einzelnen Zielauswählers:

ModusWas es tut
Any element in website frameWird für die ausgewählte Interaktion überall auf der eingebetteten Seite ausgelöst, unabhängig davon, ob sie über einer registrierten AOI erfolgt.
Any AOI elementWird ausgelöst, wann immer die Interaktion über einer registrierten Website AOI erfolgt, ohne sie einzeln auszuwählen.
Wählen Sie spezifische Ziele (Standard, kein Kontrollkästchen aktiviert)Wird nur für die Website AOI(s) ausgelöst, die Sie ausdrücklich als Ziel hinzugefügt haben.

Dies ist eine umfangreichere Wahl als das, was Blicke im gleichen Rahmen erhalten: Die Eyetracking Gaze/Eyetracking Fixation Trigger bieten nur zwei Modi, Only trigger when looking at specific elements deaktiviert (wird kontinuierlich und ohne Ziel aktiviert, wann immer neue Blickdaten vorhanden sind) oder aktiviert (auf spezifische ausgewählte AOI-Ziele beschränkt). Es gibt kein Blickäquivalent von Any AOI element.

Wenn AOIs überlappen, ändert der Zielmodus, was zählt. Für Click, PressDown und PressUp mit spezifisch ausgewählten Zielen prüft Labvanced jede AOI am Klickpunkt, nicht nur die, die visuell oben ist, sodass Ihr Ziel weiterhin feuert, selbst wenn eine andere AOI darüber gestapelt ist. Any element in website frame und Any AOI element Modi, sowie Hover/Leave/Move unabhängig vom Modus, berücksichtigen an diesem Punkt immer nur das einzelne oberste Element.

Aufbau des Ereignisses

  1. Fügen Sie ein neues Ereignis hinzu, wählen Sie Mouse Trigger.
  2. Setzen Sie Action: auf die gewünschte Interaktion: Click, PressDown, PressUp, Hover, Leave oder Move. Für Click, PressDown und PressUp erscheint ebenfalls ein Button: Dropdown, Left oder Right, um den Trigger auf eine Maustaste zu beschränken.
  3. Wählen Sie einen Zielmodus aus der obigen Tabelle. Wenn Sie beide Kontrollkästchen deaktiviert lassen, klicken Sie auf Add Target und wählen Sie die Website AOI(s), die Sie möchten.
  4. Fügen Sie eine Set / Record Variable Aktion hinzu, um Daten tatsächlich zu erfassen, ein Ereignis ohne eine solche erfasst nichts, genau wie eine AOI ohne ein Eyetracking Gaze Ereignis, das angehängt ist. Setzen Sie das Format der Variablen auf Array. Für den Aufzeichnungs Typ hält Final value nur das aktuellste Vorkommen und Time series hält jedes. Die Auswahl von Time series macht eine weitere Sampling method Option deutlich: record all (allow repeated duplicates) oder record changes only (no repeated duplicates).
  5. Wählen Sie im Wertauswahlmenü aus der Trigger (Mouse) Kategorie, dies ist der Ort, an dem die spezifischen Werte für dieses Ereignis leben, die im nächsten Abschnitt beschrieben sind.

Trigger: Mouse Trigger → Action: Move → Targets: Any AOI element
Aktion: Set / Record Variable → Format: Array, Aufzeichnungs Typ: Time series, Sampling Methode: record all (allow repeated duplicates) → Wert: Mouse [Name, Info, X, Y] Array von Trigger (Mouse)

Dies zeichnet den Namen und das Label der AOI zusammen mit ihren seitenrelativen X/Y bei jeder Mausbewegung über jede registrierte AOI auf, ohne ein separates Ereignis pro AOI zu benötigen.

Wählen eines Wertes und den mit ihm verbundenen Koordinatenraum

Die Trigger (Mouse) Kategorie bietet:

WertWas es Ihnen gibt
MouseX / MouseYDie X- oder Y-Koordinate allein
Mouse [X,Y] ArrayBeide Koordinaten zusammen
Stimulus NameDen Objekt Namen der AOI
Stimulus InfoDas Stimulus Info Label der AOI
Element TextDen sichtbaren Text der AOI zum Zeitpunkt des Ereignisses
Mouse [Name, Info, X, Y] ArrayName, Stimulus Info, und beide Koordinaten zusammen
Mouse [Name, Info, Text, X, Y] ArrayName, Stimulus Info, sichtbaren Text und beide Koordinaten zusammen

MouseX/MouseY (und die daraus gebauten Arrays) bedeuten nicht das gleiche über jeden Interaktionstyp:

  • Click, PressDown, PressUp, Move berichten über seitenrelative Koordinaten, die Position im voll scrollbaren Bereich der eingebetteten Seite, einschließlich dessen, was der Teilnehmer bereits gescrollt hat.
  • Hover, Leave berichten stattdessen über elementrelative Koordinaten, die Position innerhalb der AOI selbst, nicht der Seite.

Beide sind identisch gekennzeichnet (MouseX, MouseY) im Wertauswähler, nichts in der Benutzeroberfläche unterscheidet sie darüber hinaus, welcher Interaktionstyp das Ereignis aufgebaut wird. Das Mischen von Daten aus einem Hover Ereignis und einem Move Ereignis in derselben exportierten Spalte wird zwei unterschiedliche Koordinatenräume ohne jegliche Warnung vermischen. Entscheiden Sie im Voraus, welchen Interaktionstyp Sie tatsächlich benötigen, bevor Sie die Aufzeichnungsaktion an die Verkabelung anschließen.

Stimulus Name und Stimulus Info identifizieren, auf welcher AOI das Ereignis ausgelöst wurde, dasselbe Stimulus Info Label, das in Einen AOI für Ihre exportierten Daten benennen behandelt wird und nützlich ist, wenn Sie von mehr als einer AOI oder aus Any AOI element Modus aufzeichnen. Element Text trägt den sichtbaren Text der AOI zum Zeitpunkt des Ereignisses.

Geteilt mit Blicke: Seitenrelative Koordinaten schließen Scrollen ein

Die oben beschriebenen seitenrelativen Koordinaten (für Click, PressDown, PressUp, Move) schließen den internen Scrollversatz des iframes ein, nicht nur das, was derzeit im Ansichtsfenster sichtbar ist. Die Blickkoordinaten, die auf einer Website AOI aufgezeichnet werden, funktionieren auf die gleiche Weise. Wenn Sie Maus- und Blickdaten von derselben AOI während der Analyse kombinieren, verwenden beide diesen gleichen seitenrelativen Koordinatenraum, sodass sie sich direkt anordnen. Sie müssen eine der beiden nicht umwandeln, um zu passen.

Die Position des Seiten-Scrolls ist kein separater Wert

Die Liste der verfolgten Daten im Hauptleitfaden erwähnt die Scrollposition, aber es gibt keinen eigenständigen "aktuelle Scrollposition" Wert, der eigenständig aufgezeichnet werden kann. Der Scrollversatz wird nur automatisch auf die bereits beschriebenen seitenrelativen Koordinaten angewendet (Click, PressDown, PressUp, Move), nicht als eigene aufzeichnungsfähige Variable exponiert. Wenn Sie scrollendes Verhalten in einem scrollbaren Unterbereich innerhalb einer AOI benötigen, ist das eine separate Einstellung, Scrollable container auf der AOI selbst, die in Verfolgen eines scrollbaren Unterbereichs behandelt wird, und die resultierenden Daten sind nur über den Eyetracking Gaze/Eyetracking Fixation Trigger verfügbar, nicht Mouse Trigger.

Fehlersuche

Das Ereignis feuert niemals. Bestätigen Sie, dass die Web Bridge-Erweiterung installiert und aktiv ist, nichts erreicht einen Mouse Trigger innerhalb eines Website-Rahmens ohne sie. Wenn Sie spezifische Ziele verwenden, bestätigen Sie, dass die ausgewählte AOI tatsächlich verankert ist, eine nicht verankerte AOI (selectorFound falsch) wird zielgerichtete Ereignisse nicht auslösen, auch wenn der Trigger selbst korrekt konfiguriert ist.

Es feuert für die falschen Elemente oder zu oft. Überprüfen Sie, welcher Zielmodus ausgewählt ist. Any element in website frame feuert überall, einschließlich außerhalb einer AOI, wenn das nicht gemeint war, wechseln Sie zu Any AOI element oder wählen Sie stattdessen spezifische Ziele aus.

Aufgezeichnete Koordinaten sehen falsch oder inkonsistent aus. Überprüfen Sie, welchen Interaktionstyp das Ereignis verwendet. Hover/Leave Koordinaten sind relativ zur AOI, Click/PressDown/PressUp/Move sind relativ zur Seite, siehe Wählen eines Wertes oben.

Häufig gestellte Fragen

Warum funktioniert die reguläre Mausverfolgungseinstellung des Rahmens nicht innerhalb eines Website-Rahmens?
Weil der Browser des Teilnehmers niemals Mausbewegungen an die übergeordnete Seite liefert, während der Cursor über einem iframe schwebt, dies ist standardmäßiges Verhalten des Browsers und keine Labvanced-Beschränkung. Nur der eigene Ereignisstream der Web Bridge-Erweiterung, über einen Maus-Trigger, kann Mausaktivität innerhalb der eingebetteten Seite sehen.
Muss ich eine Website AOI hinzufügen, bevor ich Mausbewegungen verfolgen kann?
Nur wenn Sie spezifische Elemente anvisieren oder den Jedes AOI-Element Modus verwenden möchten. Der Jedes Element im Website-Rahmen Modus feuert unabhängig davon, ob die Interaktion über einer registrierten AOI erfolgt, sodass er auch ohne eine hinzugefügte AOI funktioniert.
Warum sind meine Hover-Koordinaten so viel kleiner als meine Klickkoordinaten auf derselben AOI?
Sie messen nicht dasselbe. Hover/Leave berichten über Koordinaten relativ zum AOI-Element selbst, während Click/PressDown/PressUp/Move Koordinaten relativ zur gesamten Seite berichten. Beide verwenden die gleichen MouseX/MouseY Wertnamen, sodass dies nicht nur aus dem Wertauswähler ersichtlich ist.
Was ist der Unterschied zwischen Jedes Element im Website-Rahmen und Jedes AOI-Element?
Jedes Element im Website-Rahmen feuert für die Interaktion überall auf der eingebetteten Seite, AOI oder nicht. Jedes AOI-Element feuert nur, wenn die Interaktion über einer registrierten Website AOI erfolgt, erfordert jedoch nicht, dass Sie auswählen, welches, jedes von ihnen funktioniert.

Weitere Informationen

Labvanced Web Bridge | Support & Anleitung

Die vollständige Referenz: Installation, Anwendungsfälle, Daten und Datenschutz, Fehlersuche und FAQ.

Auswählen und Anpassen von Website AOIs

Verankern, anpassen und überprüfen Sie eine Website AOI, bevor Sie ein Ereignis darauf aufbauen.

Website Frame Eye Tracking Walkthrough

Die vollständige Einrichtung des Blickverfolgungsereignisses, einschließlich des Dialogfelds zur Einrichtung des Blickverfolgungsereignisses.

Prev
Auswahl von Website-AOIs | Anker, Anpassung und Überprüfung des AOI-Trackings