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

      • Aufgaben-Editor
      • Frames
        • Canvas-Rahmen
        • Seitenrahmen
        • Website-Rahmen
      • Versuchstimeline
      • Stimuluspräsentation
      • Richtigkeit der Antwort
      • Objekte
      • Ereignisse
      • Variablen
      • Aufgaben-Assistent
      • Versuchssystem
      • Experimentdesign
        • Eine Studie erstellen
        • Datenrahmenmuster
        • Multi-User Experiment Design
        • Längsschnitt-Experimentdesign
    • HERVORGEHOBENE THEMEN

      • Randomisierung & Balance
      • Eye Tracking
        • Präsentation von Stimuli in einer Eye-Tracking-Aufgabe
        • So wählen Sie die Kalibrierungseinstellungen für die Augenverfolgung
        • 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, Anpassen und Überprüfen des AOI-Trackings
        • Verfolgen des Mausverhaltens auf einer Website-AOI | Web Bridge Anleitung
      • Fragebögen
      • Desktop-App
      • Beispielstudien
      • Teilnehmer Rekrutierung
      • API-Zugriff
        • REST API
        • Webhook-API
        • WebSocket API
      • Weitere Themen

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

      • Übersicht: Haupt-Register
      • Dashboard
      • Meine Studien
      • Geteilte Studien
      • Meine Dateien
      • Experimentbibliothek
      • Mein Konto
      • Lizenz & Dienstleistungen
    • STUDIEN REGISTER

      • Übersicht: Studien-spezifische Register
      • Studiengestaltung
        • Aufgaben
        • Blöcke
        • Sitzungen
        • Gruppen
      • Aufgaben-Editor
        • Task Controls
        • Das Versuchs-System
        • Frame-Typen
        • Objekte
        • Objekt Eigenschaften Tabellen
        • Variablen
        • Systemvariablen-Tabelle
        • Das Ereignissystem
        • Texteditor-Funktionen
        • Optionen für Augenverfolgung im Aufgabeneditor
        • Kopfverfolgung in einer Aufgabe
        • Multi-User-Studien
      • Einstellungen
      • Variablen
      • Medien
      • Texte & Übersetzen
      • Starten & Teilnehmen
      • Teilnehmer-Management
      • Datenausblick und Export
        • Datensicht und Variablen- & Aufgaben Auswahl (alte Version)
        • Zugriff auf Aufnahmen (ALTE Version)
  • Videos
    • Videoübersicht
    • Erste Schritte mit Labvanced
    • Aufgaben erstellen
    • Element-Videos
    • Ereignisse & Variablen
    • Fortgeschrittene Themen
  • Anleitungen
    • Einführung
    • Stroop-Aufgabe
    • Lexikalische Entscheidungsaufgabe
    • Posner Blickaufforderung Aufgabe
    • Change Blindness Flicker Paradigma
    • Augenverfolgungsbeispielstudie
    • Augenverfolgungsstudie mit Säuglingen
    • Aufmerksamkeitserfassung Studie mit Mausverfolgung
    • Schnelle serielle visuelle Präsentation
    • ChatGPT-Studie
    • Augenverfolgungsdemo: SVGs als AOIs
    • Multi-User-Demo: Zeigen Sie die Cursorn der Teilnehmer
    • Gamepad / Joystick-Controller - Grundlegende Einrichtung
    • Desktop-App-Studie mit EEG-Integration
    • Gruppenbalancierung und Variablen-Setup zwischen den Probanden
    • Bau einer Multi-User-Studie
    • Website-Rahmen Augenverfolgungsanleitung
    • Bedingte Webcam-Augenverfolgung
  • FAQ
    • Funktionen
    • Support-Richtlinien & -Leitlinien
    • Sicherheit & Datenschutz
    • Lizenzierung
    • Präzision von Labvanced
    • Programmgesteuerte Nutzung & API
    • Labvanced offline verwenden
    • Fehlerbehebung
    • Fragen zur Studienerstellung
  • Newsletter-Archiv
  • Dokumente
  • Klassenzimmer

Verfolgen des Mausverhaltens auf einer Website-AOI

Innerhalb eines Website-Rahmens werden sowohl Mausereignisse als auch Blickbewegungen auf die gleiche grundlegende Weise aufgezeichnet: Keines von beidem kann etwas anderes als ein Website AOI-Element anvisieren, 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 die Blickbewegung siehe die Website-Rahmen-Blickverfolgungs-Anleitung, die Trigger-eigene Ereignis-Konfiguration wird dort bereits ausführlich behandelt und hier nicht wiederholt.

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

Außerhalb eines Website-Rahmens funktioniert die Mausverfolgung im Wesentlichen nur: 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 Mausbewegung an die übergeordnete Seite, während der Cursor über ein iframe schwebt, unabhängig von irgendeiner Labvanced-Einstellung. Ein Mouse Trigger, unterstützt durch die Labvanced Web Bridge-Erweiterung, 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, auf die gleiche Weise, wie eine nicht verankerte AOI nichts aufzeichnet, ohne dass Sie es bemerken.

Die drei Zielmodi

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

ModusWas es tut
Any element in website frameFeuert für die gewählte Interaktion überall auf der eingebetteten Seite, unabhängig davon, ob sie über einer registrierten AOI stattfindet oder nicht.
Any AOI elementFeuert immer dann, wenn die Interaktion über einer registrierten Website-AOI stattfindet, ohne sie einzeln auszuwählen.
Bestimmte Ziele auswählen (Standard, kein Kästchen aktiviert)Feuert nur für die Website-AOI(s), die Sie ausdrücklich als Ziel hinzugefügt haben.

Dies ist eine reichhaltigere Auswahl als die Blickbewegung im gleichen Rahmen: Die Eyetracking Gaze/Eyetracking Fixation-Trigger bieten nur zwei Modi, Only trigger when looking at specific elements deaktiviert (feuert kontinuierlich, ohne Ziel, wann immer neue Blickdaten vorhanden sind) oder aktiviert (auf bestimmte ausgewählte AOI-Ziele beschränkt). Es gibt kein Blickäquivalent zu Any AOI element.

Wenn AOIs sich überlappen, ändert der Zielmodus, was zählt. Bei Click, PressDown und PressUp mit spezifisch ausgewählten Zielen überprüft Labvanced jede AOI am Klickpunkt, nicht nur die oberste visuell, weshalb Ihr Ziel immer noch feuert, auch wenn sich eine andere AOI darüber stapelt. Die Any element in website frame- und Any AOI element-Modi sowie Hover/Leave/Move unabhängig vom Modus berücksichtigen immer nur das einzelne oberste Element an diesem Punkt.

Ereignis erstellen

  1. Fügen Sie ein neues Ereignis hinzu, wählen Sie Mouse Trigger aus.
  2. Setzen Sie Action: auf die Interaktion, die Sie wünschen: Click, PressDown, PressUp, Hover, Leave, oder Move. Für Click, PressDown und PressUp erscheint auch ein Button:-Dropdown, Left oder Right, um den Trigger auf eine Maus-Taste 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) aus, die Sie möchten.
  4. Fügen Sie eine Set / Record Variable-Aktion hinzu, um tatsächlich Daten zu erfassen; ein Ereignis ohne eine solche zeichnet nichts auf, genauso wie eine AOI ohne ein Eyetracking Gaze-Ereignis. Setzen Sie das Format der Variable auf Array. Für den Aufzeichnungstyp behält Final value nur das zuletzt aufgetretene Ereignis bei und Time series behält jedes bei. Wenn Sie Time series wählen, wird eine weitere Sampling method-Option angezeigt: record all (allow repeated duplicates) oder record changes only (no repeated duplicates).
  5. Wählen Sie im Wertauswahlmenü aus der Trigger (Mouse)-Kategorie aus; hier leben die spezifischen Werte für dieses Ereignis, die im nächsten Abschnitt beschrieben werden.

Trigger: Mouse Trigger → Action: Move → Targets: Any AOI element
Aktion: Set / Record Variable → Format: Array, Aufzeichnungstyp: 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-Koordinaten bei jeder Mausbewegung über eine registrierte AOI auf, ohne dass ein separates Ereignis pro AOI erforderlich ist.

Auswahl eines Wertes und des zugehörigen Koordinatenraums

Die Trigger (Mouse)-Kategorie bietet:

WertWas es Ihnen gibt
MouseX / MouseYDie X- oder Y-Koordinate allein
Mouse [X,Y] ArrayBeide Koordinaten zusammen
Stimulus NameDen Objektname 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, sichtbarer Text und beide Koordinaten zusammen

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

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

Beide sind identisch beschriftet (MouseX, MouseY) im Wertauswähler; nichts in der Benutzeroberfläche unterscheidet sie darüber hinaus, auf welchem Interaktionstyp das Ereignis basiert. Das Mischen von Daten aus einem Hover-Ereignis und einem Move-Ereignis in der gleichen exportierten Spalte wird zwei unterschiedliche Koordinatenräume ohne jede Warnung mischen. Entscheiden Sie im Voraus, welchen Interaktionstyp Sie tatsächlich benötigen, bevor Sie die Aufzeichnungsaktion verdrahten.

Stimulus Name und Stimulus Info identifizieren, auf welcher AOI das Ereignis ausgelöst wurde, das gleiche Stimulus Info-Label, das in Benennung einer AOI für Ihre exportierten Daten behandelt wird, nützlich, wenn Sie von mehr als einer AOI oder im Any AOI element-Modus aufzeichnen. Element Text enthält den sichtbaren Text der AOI im Moment des Ereignisses.

Gemeinsam mit dem Blick: Seitenrelative Koordinaten beinhalten Scrollen

Die oben beschriebenen seitenrelativen Koordinaten (für Click, PressDown, PressUp, Move) beinhalten den internen Scrolloffset des iframes, nicht nur das, was derzeit im Ansichtsfenster sichtbar ist. Blickkoordinaten, die auf einer Website-AOI aufgezeichnet wurden, funktionieren auf die gleiche Weise. Wenn Sie Maus- und Blickdaten von derselben AOI während der Analyse kombinieren, verwenden beide denselben seitenrelativen Koordinatenraum, sodass sie sich direkt ausrichten. Sie müssen nicht einen konvertieren, um mit dem anderen übereinzustimmen.

Die Seiten-Scrollposition ist kein separater Wert

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

Fehlerbehebung

Das Ereignis feuert niemals. Bestätigen Sie, dass die Web Bridge-Erweiterung installiert und aktiv ist; nichts erreicht eine Mouse Trigger innerhalb eines Website-Rahmens ohne sie. Wenn Sie spezifische Ziele verwenden, stellen Sie sicher, dass die ausgewählte AOI tatsächlich verankert ist. Eine nicht verankerte AOI (selectorFound falsch) feuert keine gezielten Ereignisse, 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 von AOIs, wenn das nicht Ihre Absicht 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 das Standardverhalten des Browsers, nicht eine Einschränkung von Labvanced. Nur der eigene Ereignisstrom der Web Bridge-Erweiterung, über einen Maus-Trigger, kann die 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 stattfindet, sodass er auch ohne eine hinzugefügte AOI funktioniert.
Warum sind meine Hover-Koordinaten so viel kleiner als meine Klick-Koordinaten auf derselben AOI?
Sie messen nicht dasselbe. Hover/Leave berichten über Koordinaten, die sich auf das AOI-Element selbst beziehen, während Klick/PressDown/PressUp/Move über Koordinaten berichten, die sich auf die gesamte Seite beziehen. Beide verwenden dieselben MouseX/MouseY-Wertnamen, daher ist das alleine aus dem Wertauswähler nicht sichtbar.
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 stattfindet, erfordert aber nicht, dass Sie auswählen, welches; jedes davon funktioniert.

Weiterführende Literatur

Labvanced Web Bridge | Unterstützung & Anleitung

Die vollständige Referenz: Installation, Anwendungsfälle, Daten und Datenschutz, Fehlerbehebung und FAQs.

Auswahl und Anpassung von Website-AOIs

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

Website-Rahmen-Blickverfolgungs-Anleitung

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

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