labvanced logoLabVanced
Contact
    • Remote Physiological Measurements
    • Eye Tracking
    • Head & Face-Tracking
    • Emotion Detection
    • Heart Rate Detection (rPPG)
    • Generative AI
    • Audio Transcription
    • EEG & Hardware Integrations
    • Decision Making
    • Reaction Times
    • Keyboard Inputs
    • Mouse Tracking
    • Mobile / Touch
    • Questionnaires
    • Gamepad / Joystick Integration
    • Audio Recordings
    • Audio Transcription
    • Video Recordings
    • Screen Recordings
    • Photos / Snapshots
    • Video Conferencing
    • Canvas Drawings
    • Build with AI
    • Build with Spreadsheets
    • Using the Experiment Editor
    • Coding
    • Creating Questionnaires
    • Balancing & Randomization
    • UX & Website Testing
    • Single Session Studies
    • Factorial Designs
    • Longitudinal & Multi-session Studies
    • Individual & Case Studies
    • Real-time Multi-user Studies
    • Interviews & Video Calls
    • Surveys & Questionnaires
    • Experience Sampling & Diaries
    • Classroom & Group Testing
    • Interventions & Clinical Trials
    • In the Browser
    • Mobile App
    • Desktop App
    • WebBridge Chrome Extension
    • Stroop Test
    • Flanker Task
    • N-back Task
    • Implicit Association Test
    • Trail Making Test
    • Digit Span
    • Corsi Block Tapping
    • Tower of London
    • Balloon Analog Risk Task
    • Preferential Looking
    • Browse more →
    • DASS-21
    • GAD-7
    • Rosenberg Self-Esteem Scale
    • PHQ-9
    • Ten-Item Personality Inventory
    • Big Five Personality Test
    • Adult ADHD Self-Report Scale
    • Browse more →
    • Building a Multi-user Study
    • Webcam Eye Tracking with AOIs
    • Website Frame Eye Tracking
    • Conditional Eye Tracking Opt-in
    • ChatGPT Study
    • Desktop App Study with EEG
    • Between-subjects Group Balancing
    • Building a Reading Study
    • Stroop Task
    • Lexical Decision Task
    • Browse more →
    Public Experiment Library
    • Arts Research
    • Clinical Psychology & Neuropsychology Medicine
    • Cognitive Psychology
    • Developmental Psychology
    • Behavioral Economics & Decision Science
    • Educational Research & Psychology
    • HCI & Human Factors
    • Linguistics & Language Sciences
    • Consumer & Marketing Research
    • Social & Personality Psychology
    • Sport & Movement Science
    • UX & Website Testing
    • Executive Functions
    • Language & Reading
    • Decision-Making & Reasoning
    • Attention
    • Overview
    • HCI & Human Factors
    • UX & Website Testing
    • Consumer & Marketing Research
    • White-Label App
    • PageGazer
    • Webcam vs. Lab Eye Tracking in InfantsAnna Banki & Gabriela Markova
    • Eye Tracking for Influencer MarketingDr. Alexander Edeling
    • Eye Tracking Infant Word ComprehensionDr. Giulia Calignano
    • Sentence Reading and Grammar JudgmentsDr. Jonathan Mirault
    • Regulating Emotions with MusicDr. Katrin Starcke
    • Game-Based Grammar Learning in ChildrenDr. Mireia Marimon
    • Gaze Cueing and AutismMax Soares Miehstein
    • Personality and Hearing in NoiseDr. Malte Wöstmann
    • All interviews →
    • Lab Notes
    • How to Cite Labvanced
    • Labvanced Platform Paper (2017)
    • Webcam Eye Tracking Validation (2024)
    • Webcam Eye Tracking Studies
    • Cognitive Psychology Studies
    • Developmental Psychology Studies
    • Linguistics Studies
    • See all publications →
    • Getting Started
    • Guide
    • Video Tutorials
    • Walkthroughs
    • Live Chat
    • Webinars & Onboarding Calls
    • AI Assistant
    • FAQ
    • Importing Templates Guide
    • Test Templates
    • Live Eye Tracking Metrics
    • Mouse Tracking Demo
    • ChatGPT Demo
    • Audio Recording Object Demo
    • Adding Image Stimuli Demo
    • Score & Feedback Demo
    • Browse all technical demos →
    • Timing Precision
    • Stimuli Presentation
    • Headphone Checks
    • Bot Checks
    • Participant Management
    • Comparisons
    • Research Blog
    • Prolific Integration
    • CloudResearch Integration
    • Sona Systems Integration
    • BeSample Integration
    • Panelabs Integration
    • Clickworker Integration
    • Labvanced Webhook API
    • Labvanced REST API
    • About Us
    • Newsletter Archive
    • Terms & Conditions
    • Data Security & Data Privacy
    • Technical & Organisational Measures
    • Accessibility
    • W-8BEN-E Form
    • Data Processing Agreement Template
    LinkedInYouTubeDiscord
    • Individual
    • Lab
    • Department / Consortium
    • Teaching
    • Campus
    • Commercial
    Top-Ups
    • Overview
    • Study Building
    • Subject Recruitment
    • Dedicated Support
    Checkout
  • Contact
    • DE
      • 中國人
      • Deutsch
      • Français
      • Español
      • English
      • 日本語
    • Appgo to app icon
    • Loginlogin icon
    Platform
    Labvanced makes it easy to implement the most advanced study design and reliably collect your data.
    Biosignals & AI
    Remote Physiological MeasurementsEye TrackingHead & Face-TrackingEmotion DetectionHeart Rate Detection (rPPG)Generative AIAudio TranscriptionEEG & Hardware Integrations
    Behavioral Recordings
    Decision MakingReaction TimesKeyboard InputsMouse TrackingMobile / TouchQuestionnairesGamepad / Joystick Integration
    Media Recordings
    Audio RecordingsAudio TranscriptionVideo RecordingsScreen RecordingsPhotos / SnapshotsVideo ConferencingCanvas Drawings
    Implementation Techniques
    Build with AIBuild with SpreadsheetsUsing the Experiment EditorCodingCreating QuestionnairesBalancing & RandomizationUX & Website Testing
    Study Formats

    Your study can take whatever format your research needs. Here are a few popular examples.

    Single Session StudiesFactorial DesignsLongitudinal & Multi-session StudiesIndividual & Case StudiesReal-time Multi-user StudiesInterviews & Video CallsSurveys & QuestionnairesExperience Sampling & DiariesClassroom & Group TestingInterventions & Clinical Trials
    Where Studies Run

    Run your study online in the browser, on mobile or tablet with the mobile app, or in-lab with the desktop app.

    In the BrowserMobile AppDesktop AppWebBridge Chrome Extension
    Tests
    Explore cognitive tests, questionnaires, walkthroughs, and our public experiment library: a starting point for your next study.
    Popular Cognitive Tests
    Stroop TestFlanker TaskN-back TaskImplicit Association TestTrail Making TestDigit SpanCorsi Block TappingTower of LondonBalloon Analog Risk TaskPreferential Looking
    Browse more →
    Questionnaires & Scales
    DASS-21GAD-7Rosenberg Self-Esteem ScalePHQ-9Ten-Item Personality InventoryBig Five Personality TestAdult ADHD Self-Report Scale
    Browse more →
    Public Experiment Library

    Take a look at what other researchers in the community are doing through our extensive, open catalog of shared studies.

    Open the public library →
    Walkthroughs

    Step-by-step builds of complete studies, from a blank project to a running experiment, that you can follow along or adapt.

    Building a Multi-user StudyWebcam Eye Tracking with AOIsWebsite Frame Eye TrackingConditional Eye Tracking Opt-inChatGPT StudyDesktop App Study with EEGBetween-subjects Group BalancingBuilding a Reading StudyStroop TaskLexical Decision Task
    Browse more →
    Research
    One platform for students, academics, and industry researchers studying human behavior.
    Harvard UniversityStanford UniversityCambridge UniversityUCLNYUMax Planck InstituteUCLATU Munich

    Trusted by researchers at 1,500+ universities worldwide

    Academic Research
    Arts ResearchClinical Psychology & Neuropsychology MedicineCognitive PsychologyDevelopmental PsychologyBehavioral Economics & Decision ScienceEducational Research & PsychologyHCI & Human FactorsLinguistics & Language SciencesConsumer & Marketing ResearchSocial & Personality PsychologySport & Movement ScienceUX & Website Testing
    Research Areas
    Executive FunctionsLanguage & ReadingDecision-Making & ReasoningAttention
    Industry / Commercial
    OverviewHCI & Human FactorsUX & Website TestingConsumer & Marketing ResearchWhite-Label AppPageGazer
    Researcher Interviews

    Conversations with researchers about the studies they ran with Labvanced, what worked, and what they learned.

    Webcam vs. Lab Eye Tracking in InfantsAnna Banki & Gabriela MarkovaEye Tracking for Influencer MarketingDr. Alexander EdelingEye Tracking Infant Word ComprehensionDr. Giulia CalignanoSentence Reading and Grammar JudgmentsDr. Jonathan MiraultRegulating Emotions with MusicDr. Katrin StarckeGame-Based Grammar Learning in ChildrenDr. Mireia MarimonGaze Cueing and AutismMax Soares MiehsteinPersonality and Hearing in NoiseDr. Malte Wöstmann
    All interviews →
    Our Research
    Lab NotesHow to Cite Labvanced
    Peer Reviewed Studies

    A selection of peer-reviewed work built on Labvanced: our own platform and validation papers, and studies by the research community grouped by area. Hundreds more are listed on the full publications page.

    Labvanced Platform Paper (2017)Webcam Eye Tracking Validation (2024)Webcam Eye Tracking StudiesCognitive Psychology StudiesDevelopmental Psychology StudiesLinguistics Studies
    See all publications →
    Resources
    Valuable resources to help you learn the platform, stay updated, and more.
    Documentation
    Getting StartedGuideVideo TutorialsWalkthroughs
    Support
    Live ChatWebinars & Onboarding CallsAI AssistantFAQ
    Templates & Demos

    These are a few popular examples. Browse our guide and a selection of technical demos to get started with implementation.

    Importing Templates GuideTest TemplatesLive Eye Tracking MetricsMouse Tracking DemoChatGPT DemoAudio Recording Object DemoAdding Image Stimuli DemoScore & Feedback Demo
    Browse all technical demos →
    Methodology
    Timing PrecisionStimuli PresentationHeadphone ChecksBot ChecksParticipant ManagementComparisonsResearch Blog
    Integrations & APIs
    Prolific IntegrationCloudResearch IntegrationSona Systems IntegrationBeSample IntegrationPanelabs IntegrationClickworker IntegrationLabvanced Webhook APILabvanced REST API
    Company & Legal
    About UsNewsletter ArchiveTerms & ConditionsData Security & Data PrivacyTechnical & Organisational MeasuresAccessibilityW-8BEN-E FormData Processing Agreement Template
    LinkedInYouTubeDiscord
    Pricing
    Our licenses and additional services at a glance.
    Licenses
    IndividualLabDepartment / ConsortiumTeachingCampusCommercial
    Top-Ups

    Need more recordings for your lab or your own research? Simply use one of these recording top-up packages.

    Browse top-up packages →
    Additional Services

    Hire Labvanced’s expert team to quickly bring your project to the level of rigor it needs.

    OverviewStudy BuildingSubject RecruitmentDedicated Support
    Checkout

    Ready to purchase a license or top-up? Head straight to checkout.

    Go to checkout →
    • 中國人
    • Deutsch
    • Français
    • Español
    • English
    • 日本語
    • Erste Schritte
    • Leitfaden
      • ERSTE SCHRITTE

        • Aufgabeneditor
        • Rahmen
          • Canvas Frame
          • Seitenrahmen
          • Website-Rahmen
        • Versuchszeitlinie
        • Stimuluspräsentation
        • Richtigkeitsbewertung der Antwort
        • Objekte
        • Ereignisse
        • Variablen
        • Aufgabenassistent
        • Versuchssystem
        • Experimentdesign
          • Eine Studie erstellen
          • Vorlagen in Labvanced importieren
          • Datenrahmen-Muster
          • Multi-User Experimentdesign
          • Längsschnitt-Experimentdesign
      • HERVORGEHOBENE THEMEN

        • Randomisierung & Balance
        • Eye Tracking
          • Präsentation von Stimuli in einer Augenverfolgungsaufgabe
          • Wie man die Einstellungen zur Augenverfolgung Kalibrierung wählt
          • Einrichtung der Augenverfolgung in einer Aufgabe
          • Aufnahme und Export von Blickdaten
          • Verwendung von Formen als Interessensgebiete (AOI) für das Eye Tracking
          • Die Erfahrung der Kalibrierung für Teilnehmer
        • Web-Brücke
          • Auswählen von Website-AOIs | Ankern, Anpassen und Überprüfen der AOI-Verfolgung
          • Verfolgen des Mausverhaltens auf einer Website AOI | Web Bridge Anleitung
        • Fragebögen
        • Desktop-App
        • Beispielstudien
        • Teilnehmerrekrutierung
        • API-Zugang
          • REST API
          • Webhook-API
          • WebSocket API
        • Weitere Themen

          • Präzise Stimuluszeiten
          • Mehrbenutzerstudien
          • Kopfverfolgung in Labvanced | Anleitung
      • HAUPT-APP-TABS

        • Übersicht: Haupt-Tabs
        • Dashboard
        • Meine Studien
        • Geteilte Studien
        • Meine Dateien
        • Experimentbibliothek
        • Mein Konto
        • Lizenz & Dienstleistungen
      • STUDIENTABS

        • Übersicht: Studien-spezifische Tabs
        • Studiengestaltung
          • Aufgaben
          • Blöcke
          • Sitzungen
          • Gruppen
        • Aufgabeneditor
          • Aufgabensteuerungen
          • Das Versuchs-System
          • Frame-Typen
          • Objekte
          • Objekt-Eigenschaftstabellen
          • Variablen
          • Systemvariablen Tabelle
          • Das Ereignissystem
          • Texteditor-Funktionen
          • Optionen für Eye Tracking im Aufgabeneditor
          • Gesichtserkennung in einer Aufgabe
          • Multi-User-Studien
        • Einstellungen
        • Variablen
        • Medien
        • Texte & Übersetzen
        • Starten & Teilnehmen
        • Teilnehmermanagement
        • Datensicht und Export
    • Video-Tutorials
      • Video-Übersicht
      • Erste Schritte in Labvanced
      • Aufgaben erstellen
      • Elementvideos
      • Ereignisse & Variablen
      • Fortgeschrittene Themen
    • Anleitungen
      • Einführung
      • Stroop-Aufgabe
      • Lexikalische Entscheidungsaufgabe
      • Posner-Blickrichtungs-Aufgabe
      • Change Blindness Flicker Paradigma
      • Eye-Tracking Beispielstudie
      • Baby-Eye-Tracking-Studie
      • Aufmerksamkeitserfassung Studie mit Mausverfolgung
      • Schnelle serielle visuelle Präsentation
      • ChatGPT-Studie
      • Eye-Tracking-Demo: SVGs als AOIs
      • Multi-User-Demo: Zeigen Sie die Cursors der Probanden
      • Gamepad / Joystick-Controller - Grundlegende Einrichtung
      • Desktop-App-Studie mit EEG-Integration
      • Gruppenbalancierung zwischen Probanden und Variablensetup
      • Erstellen einer Multi-User-Studie
      • Website-Frame Eye Tracking Anleitung
      • Bedingtes Webcam Eye Tracking
      • Textsegmentierungsstudie erstellen
      • Eine Studie mit KI erstellen
    • FAQ
      • Funktionen
      • Support-Richtlinien & Leitlinien
      • Sicherheit & Datenschutz
      • Lizenzierung
      • Präzision von Labvanced
      • Programmgesteuerter Gebrauch & API
      • Labvanced offline verwenden
      • Fehlerbehebung
      • Fragen zur Studienerstellung

    Webhook-API

    Verwendung: ​Der Hauptanwendungsfall für die Labvanced Webhook-API zur externen Datenspeicherung besteht darin, Teilnehmerdaten in “Echtzeit” an einen externen / entfernten Server zu übertragen, anstatt die aufgezeichneten Daten auf den Labvanced-Servern zu hosten.

    BITTE BEACHTEN: ​Im Gegensatz zu vielen API-Anwendungsszenarien beschreibt dieser Abschnitt NICHT, wie man die Labvanced-API / Endpunkte aufruft (eine solche Funktionalität existiert derzeit nicht), sondern wie Sie Ihr Backend konfigurieren/implementieren müssen, sodass unsere Plattform automatisch die Endpunkte aufruft, die Sie implementiert haben, um die Teilnehmerdaten direkt an Ihr Backend/Datenbank anstelle unseres zu senden.

    Verfügbarkeit: ​Diese Funktionalität ist nur für Inhaber einer Labvanced-Lizenz verfügbar.

    1. Einrichtung der Webhook-API

    Um die Webhook-API zu nutzen, muss zunächst die Option “externer Datenspeicher” in den “Studieneinstellungen” der jeweiligen Labvanced-Studie im Abschnitt “Experimentfeatures” aktiviert werden.

    1.1 Parameter:

    • IP-Adresse: Geben Sie Ihre statische IP-Adresse an, unter der Ihr externer Server läuft / öffentlich verfügbar ist.
    • Port: Der Port, der zum Senden der Daten verwendet werden soll.
    • URL-Pfad​: Der URL-Pfad, der nach dem Port angehängt werden soll. Dies ist besonders nützlich, um Ihre Projekte / eingehenden Daten zu “namensbereichen”, sodass Daten aus verschiedenen Experimenten an einen anderen URL-Pfad gesendet werden. Der URL-Pfad ist optional, aber wir empfehlen dringend, ihn zu verwenden.

    2. Erstellen Sie den Server / das Skript zum Empfang der Daten von der Webhook-API

    Basierend auf Ihren Einstellungen in Schritt 1 müssen Sie einen Server implementieren, der unter der angegebenen IP-Adresse, dem Port und dem URL-Pfad verfügbar ist. Eine vereinfachte Version / ein Beispiel eines solchen Servers ist auf unserer Github-Seite hier verfügbar.

    2.1 Datenformat: D​aten werden im JSON-Format für alle Routen außer der Route “/file_upload” gesendet. Die Route “/file_upload” (die zum Hochladen von Binärdateien wie aufgezeichneten Videos oder Audio verwendet wird) ist als “multipart/form-data” kodiert, stellen Sie daher sicher, dass Sie die eingehenden Daten korrekt als JSON oder multipart/form-data / Binärdaten analysieren.

    2.2. CORS-Einstellungen: Bei der Implementierung Ihres Backends müssen Sie Cross Origin Resource Sharing (CORS) implementieren / zulassen. Insbesondere müssen Sie die folgenden Header festlegen: “Access-Control-Allow-Origin” (einschließlich ​https://www.labvanced.com/​), “Access-Control-Allow-Methods” (einschließlich POST und OPTIONS), “Access-Control-Allow-Headers” (einschließlich Content-Type).

    2.3 Anfragearten: ​Alle Anfragearten sind POST-Anfragen, da sie verwendet werden, um Daten zu senden. An diesem Punkt ist ein Rückgabewert nur für die Route “/file_upload” erforderlich. Alle anderen Routen benötigen keinen speziellen Rückgabewert.

    2.4 Arten von Anfragen / Routen: ​Jedes Mal, wenn ein Teilnehmer an einer Studie teilnimmt, werden insgesamt 8 verschiedene ​Typen​ von POST-Anfragen an den (externen/Ihren) Server gesendet. Die Route “/file_upload” wird nur verwendet, wenn Ihre Studie eine Aktion zum Hochladen einiger aufgezeichneter Binärdaten (z. B. Audio oder Video) enthält. Jeder Typ von POST-Anfrage hat eine andere Route (URL-Pfad), die an den angegebenen URL-Pfad in Schritt 1 angehängt wird. Auch jeder Typ von Anfrage hat eine andere Struktur / Payload, die bei der Analyse und Speicherung der Daten berücksichtigt werden sollte. Einzelheiten finden Sie im Abschnitt 3.

    3. Definitionen / Routen der Webhook-API-Endpunkte:

    Im Folgenden finden Sie eine detaillierte Erklärung jeder Route / jedes Endpunkts, der verwendet / aufgerufen wird, wenn ein Teilnehmer am Experiment teilnimmt. Idealerweise empfehlen wir, dass Sie all diese Endpunkte (außer 3.1) implementieren und sicherstellen, dass alle Daten angemessen analysiert und in Ihrer Datenbank gespeichert werden.

    Welche Endpunkte werden verwendet, welcher Server wird wann aufgerufen?

    • Der Endpunkt 3.1 “/startExpPlayer” wird nur an den Labvanced-Server gesendet, um die Experimentdefinition / JSON-Datei und die zugehörigen Stimuli von unserem Server zu laden.
    • Die Endpunkte 3.2, 3.3, 3.4, 3.7 und 3.8 werden sowohl an den Labvanced-Server (benötigt für die Gruppenbalancierung und den allgemeinen Experimentablauf) als auch an den externen / Ihren Server gesendet.
    • Die Endpunkte 3.5 und 3.6 werden nur an den externen / Ihren Server gesendet. Bitte beachten Sie, dass alle Versuchs- / Teilnehmerdaten über die Route 3.6 gesendet werden, die daher der wichtigste Endpunkt zum Implementieren ist.
    • Der Endpunkt 3.9 wird nur an den externen / Ihren Server gesendet und bei jeder Ausführung einer “Upload-Aktion” aufgerufen, um binäre (Audio- oder Video-)Daten hochzuladen.

    3.1 Laden des Experiments

    • Route: /startExpPlayer
    • Typ: POST
    • Aufgerufen wenn: Der Teilnehmer eine bestimmte Experiment-URL auf labvanced.com besucht. Hauptfunktion auf dem Lavanced-Server: Initialisiert das Laden des Experiments.
    • Payload: JSON mit den folgenden Feldern:
    FeldnameBeschreibungDatentypErforderlich
    expIdEindeutiger Identifikator für die StudieGanzzahlJA
    isTestrunOb die Daten aufgezeichnet werden oder nichtBoolescher WertNEIN
    subject_codeKennung des Subjekts über URL-ParameterZeichenfolgeNEIN
    tokenEin eindeutiger Identifikator für Teilnehmer in LängsschnittstudienToken-IdentifikatorNEIN
    askSubjDataOb eine erste Umfrage angezeigt werden soll, die verwendet wird, um Subjekte in verschiedene Gruppen einzuteilenBoolescher WertJA

    HINWEIS: Muss nicht auf externen Servern implementiert werden, da dies nur das Laden des Experiments vom Labvanced-Server zum Client-Computer initialisiert


    3.2 Gruppen- und Sitzungswahl

    • Route: /startFirstPlayerSession
    • Typ: POST
    • Aufgerufen wenn: Route 3.1 “ /startExpPlayer” vom Labvanced-Server erfolgreich zurückgegeben wird.
    • Hauptfunktion auf dem Labvanced-Server: Wird verwendet, um Gruppen- und Sitzungsnummern einem Subjekt zuzuweisen (serverseitiges Balancing).
    • Payload: JSON mit den folgenden Feldern:
    FeldnameBeschreibungDatentypErforderlich
    expIdEindeutiger Identifikator für die StudieGanzzahlJA
    expSessionNrEindeutiger Identifikator für die Aufzeichnungssitzung für diesen Teilnehmer (zählt aufwärts)ZeichenfolgeJA
    subject_codeKennung des Subjekts über URL-ParameterZeichenfolgeNEIN
    tokenEin eindeutiger Identifikator für Teilnehmer in LängsschnittstudienToken-IdentifikatorNEIN
    survey_dataJSON des Fragebogens vor der Studie, die Felder unten beschrieben werden.JSONNEIN
    survey_data.selectedGenderAusgewähltes Geschlecht des TeilnehmersZeichenfolgeNEIN
    survey_data.selectedAgeAusgewähltes Alter des TeilnehmersGanzzahlNEIN
    survey_data.selectedCountryAusgewähltes Land / Standort des TeilnehmersZeichenfolgeNEIN
    survey_data.selectedLanguageAusgewählte (erste) Sprache des TeilnehmersZeichenfolgeNEIN
    isTestrunOb Daten aufgezeichnet werden oder nichtBoolescher WertJA
    runOnlyGroupNrWird nur verwendet, um eine bestimmte Gruppennummer ohne Datenaufzeichnungen zu testenGanzzahl / FalschNEIN
    runOnlySessionNrWird nur verwendet, um eine bestimmte Sitzungsnummer ohne Datenaufzeichnungen zu testenGanzzahl / FalschNEIN
    groupNrGruppennummer für dieses SubjektGanzzahlJA
    sessionNrSitzungsnummer in einer LängsschnittstudieGanzzahlJA
    group_nameDer Name der Gruppe für dieses SubjektZeichenfolgeJA
    session_nameDer Name der Sitzung für dieses SubjektZeichenfolgeJA
    experiment_nameDer Name des Experiments (nicht der Veröffentlichungsname)ZeichenfolgeJA

    3.3 ​Beginn des Experiments

    • Route: /setPlayerSessionStartedTime
    • Typ: POST
    • Aufgerufen wenn: Der Teilnehmer auf “Experiment starten” drückt.
    • Funktion auf dem Labvanced-Server: Speichert die Startzeit, die Sitzung und den Gruppennamen des Experiments und startet das Experiment.
    • Payload: JSON mit den folgenden Feldern:
    FeldnameBeschreibungDatentypErforderlich
    expIdEindeutiger Identifikator für die StudieGanzzahlJA
    expSessionNrEindeutiger Identifikator für die Aufzeichnungssitzung für diesen Teilnehmer (zählt aufwärts)ZeichenfolgeJA
    start_timeStartzeit des ExperimentsUNIX-ZeitstempelJA
    sessionNrSitzungsnummer in einer LängsschnittstudieGanzzahlJA
    groupNrGruppennummer für dieses SubjektGanzzahlJA
    tokenEin eindeutiger Identifikator für Teilnehmer in LängsschnittstudienToken-IdentifikatorNEIN

    3.4 Fügen Sie Metadateninformationen hinzu

    • Route: /addMetaInfo
    • Typ: POST
    • Aufgerufen wenn: Der Teilnehmer auf “Experiment starten” drückt.
    • Funktion auf dem Labvanced-Server: Speichert die Metainformationen auf dem Server.
    • Payload: JSON mit den folgenden Feldern:
    FeldnameBeschreibungDatentypErforderlich
    expIdEindeutiger Identifikator für die StudieGanzzahlJA
    expSessionNrEindeutiger Identifikator für die Aufzeichnungssitzung für diesen Teilnehmer (zählt aufwärts)ZeichenfolgeJA
    var_dataDas JSON, das die Metainformationen enthältJSONJA
    var_data.browserSpecDer Browser, der vom Subjekt verwendet wirdZeichenfolgeNEIN
    var_data.versionSpecDie vom Subjekt verwendete BrowserversionZeichenfolgeNEIN
    var_data.systemSpecDer Gerätetyp / die Betriebssystem, die vom Subjekt verwendet werdenZeichenfolgeNEIN
    var_data.agentSpecDer vollständige User-Agent-StringZeichenfolgeNEIN
    var_data.fullscreenGibt an, ob die Studie immer im Vollbildmodus istBoolescher WertNEIN
    var_data.timeDelayMeanDer Durchschnittswert für die Präzision des JavaScript-Callbacks in MillisekundenFloatNEIN
    var_data.timeDelayStdDie Standardabweichung der Präzision des JavaScript-Callbacks in MillisekundenFloatNEIN
    var_data.crowdsourcingCodeDer Crowdsourcing- / Abschlusscode für SubjekteZeichenfolgeNEIN
    var_data.crowdsourcinSubjIdDie Crowdsourcing- / Arbeiter-ID des SubjektsZeichenfolgeNEIN
    var_data.subjCounterGlobalEin globaler Subjektezähler für die Anzahl der Subjekte in der StudieGanzzahlNEIN
    var_data.subjCounterPer GroupEin Subjektezähler pro Gruppe in der StudieArray von GanzzahlenNEIN
    var_data.roleIdDie eindeutige Rollen-ID für Mehrbenutzerstudien des SubjektsGanzzahlNEIN
    var_data.multiUserGroupIdDie global eindeutige Mehrbenutzergruppen-ID für MehrbenutzerstudienUuidNEIN
    var_data.displayedLanguageDie ausgewählte Anzeigesprache für mehrsprachige StudienZeichenfolgeNEIN
    var_data.pixelDensityPerMMDie Pixeldichte des BildschirmsFloatNEIN
    var_data.screenHeightDie Höhe des Bildschirms in PixelnGanzzahlNEIN
    var_data.screenWidthDie Breite des Bildschirms in PixelnGanzzahlNEIN
    var_data.windowHeightDie Fenster-/Viewport-Höhe in PixelnGanzzahlNEIN
    var_data.windowWidthDie Fenster-/Viewport-Breite in PixelnGanzzahlNEIN

    3.5 Informationen über eine Aufgabe aufzeichnen

    • Route: /recordStartTask
    • Typ: POST
    • Aufgerufen wenn: Eine neue Aufgabe im Experimentablauf beginnt.
    • Funktion auf dem Labvanced-Server: Wird nicht aufgerufen, wenn externe API-Anfragen aktiviert sind.
    • Payload: JSON mit den folgenden Feldern:
    FeldnameBeschreibungDatentypErforderlich
    expIdEindeutiger Identifikator für die StudieGanzzahlJA
    expSessionNrEindeutiger Identifikator für die Aufzeichnungssitzung für diesen Teilnehmer (zählt aufwärts)ZeichenfolgeJA
    blockNrAktuelle Blocknummer (zunehmender Zähler)GanzzahlJA
    blockIdEindeutige ID des aktuellen BlocksUuidJA
    blockNameName des BlocksZeichenfolgeJA
    taskNrAktuelle Aufgabennummer (zunehmender Zähler)GanzzahlJA
    taskIdID der aktuellen Aufgabe, wie im Editor definiert (zwischen den Subjekten gleich)UuidJA
    recTaskIdServergenerierte ID für die aktuelle Aufnahmeaufgabe (unterschiedlich zwischen den Subjekten)GanzzahlJA
    taskNameName der aktuellen AufgabeZeichenfolgeJA
    start_timeStartzeit der AufgabeUNIX-ZeitstempelJA

    3.6 Trialdaten aufzeichnen

    • Route: /recordTrial
    • Typ: POST
    • Aufgerufen wenn: Ein Versuch abgeschlossen ist ODER eine benutzerdefinierte Aufzeichnungsaktion ausgeführt wird.
    • Funktion auf dem Labvanced-Server: Wird nicht aufgerufen, wenn externe API-Anfragen aktiviert sind.
    • Payload: JSON mit den folgenden Feldern:
    FeldnameBeschreibungDatentypErforderlich
    expIdEindeutiger Identifikator für die StudieGanzzahlJA
    expSessionNrEindeutiger Identifikator für die Aufzeichnungssitzung für diesen Teilnehmer (zählt aufwärts)ZeichenfolgeJA
    recTaskIdServergenerierte ID für die aktuelle Aufnahmeaufgabe (unterschiedlich zwischen den Subjekten)GanzzahlJA
    taskIdID der aktuellen Aufgabe, wie im Editor definiert (zwischen den Subjekten gleich)UuidJA
    trailNrVersuchnummerGanzzahlJA
    recDataDie Hauptdaten / alle benutzerdefinierten Variablen pro Versuch werden hier gespeichertJSONJA

    HINWEIS: Die genauen Daten, die pro Versuch aufgezeichnet werden, hängen vom spezifischen Experiment und der Aufgabe ab. Eine Übersicht für jede Studie finden Sie unter dem Tab "Variablen" des spezifischen Experiments (siehe Screenshot). Bitte beachten Sie auch, dass die externen API-Variablennamen als Schlüssel in der JSON-Struktur verwendet werden. Stellen Sie daher sicher, dass die Variablennamen eindeutig sind. Andernfalls würden Sie die Daten überschreiben. Das Labvanced-System zwingt in der Regel den Benutzer dazu, eindeutige Variablennamen zu verwenden.

    Übersicht über den Tab "Variablen" in Labvanced

    3.7 Experiment erfolgreich beenden

    • Route: /finishExpSession
    • Typ: POST
    • Aufgerufen wenn: Das Experiment erfolgreich abgeschlossen ist.
    • Funktion auf dem Labvanced-Server: Beendet die Studie und markiert den Datensatz als abgeschlossen (wichtig für das Balancing).
    • Payload: JSON mit den folgenden Feldern:
    FeldnameBeschreibungDatentypErforderlich
    expIdEindeutiger Identifikator für die StudieGanzzahlJA
    expSessionNrEindeutiger Identifikator für die Aufzeichnungssitzung für diesen Teilnehmer (zählt aufwärts)ZeichenfolgeJA
    end_timeZeitpunkt, zu dem das Experiment beendet wurdeUNIX-ZeitstempelJA
    var_dataWie die var-Daten in der Route “/​addMetaInfo​” (aktualisierte Informationen)JSONJA
    nextStartTimeNächste Startzeit (nur für Längsschnittstudien)UNIX-ZeitstempelNEIN
    nextEndTimeNächste Endzeit (nur für Längsschnittstudien)UNIX-ZeitstempelNEIN
    reminderTimeZeit bis zur nächsten Startzeit (nur für Längsschnittstudien)ZeitzeichenfolgeNEIN
    selectedEmailE-Mail zum Senden einer Teilnahmeerinnerung (nur für Längsschnittstudien)E-Mail-AdresseNEIN
    emailReminderWann die Erinnerung gesendet werden soll (nur für Längsschnittstudien)ZeichenfolgeNEIN

    3.8 Experiment mit Fehler beenden

    • Route: /errExpSession
    • Typ: POST
    • Aufgerufen wenn: Das Experiment mit einem Fehler abgebrochen wird.
    • Funktion auf dem Labvanced-Server: Bricht die Studie ab und markiert den Datensatz als unvollständig.
    • Payload: JSON mit den folgenden Feldern:
    FeldnameBeschreibungDatentypErforderlich
    expIdEindeutiger Identifikator für die StudieGanzzahlJA
    expSessionNrEindeutiger Identifikator für die Aufzeichnungssitzung für diesen Teilnehmer (zählt aufwärts)ZeichenfolgeJA
    err_msgDie FehlermeldungZeichenfolgeJA

    3.9 Hochladen von Binär- (Audio- oder Video-)Daten

    • Route: /file_upload
    • Typ: POST
    • Aufgerufen wenn: Eine Upload-Aktion im Ereignissystem ausgeführt wird, die mit einem Audio- oder Videoaufzeichnungsobjekt verbunden ist. Funktion auf dem Labvanced-Server: Wird nicht aufgerufen, wenn externe API-Anfragen aktiviert sind.
    • HINWEIS: Der Server muss Rückgabewerte für diese Route senden (siehe unten). Wenn dies nicht erfolgt, wird der “onUploadComplete”-Trigger nicht ausgeführt und das Experiment kann sich nicht korrekt propagieren. Beachten Sie auch, dass die Daten in dieser Route als “multipart/form-data” kodiert sind, da sie sowohl binäre als auch nicht-binäre Daten enthalten.
    • Payload: JSON mit den folgenden Feldern:
    FeldnameBeschreibungDatentypErforderlich
    expSessionNrEindeutiger Identifikator für die Aufzeichnungssitzung für diesen Teilnehmer (zählt aufwärts)ZeichenfolgeJA
    newFileNameDer vorgeschlagene Dateiname zum Speichern der Datei. Der Dateiname enthält den zugehörigen Variablennamen sowie die aktuelle Block-, Aufgaben- und Versuchnummer.ZeichenfolgeJA
    myFileDie tatsächliche Datei / BinärdatenBinärJA

    Erforderliche Antwort:

    FeldnameBeschreibungDatentypErforderlich
    file_guidGlobaler eindeutiger Identifikator (guid) für die aufgezeichnete Datei. Dieser muss serverseitig generiert werden und wird in der Variablen gespeichert, die mit der Datei verknüpft ist, sodass später leicht nachzuvollzogen werden kann, welche Datei von welchem Aufnahmeobjekt stammt.UuidJA
    file_nameDer resultierende Dateiname, den der Server zum Speichern der Datei verwendet hat. Dies kann (muss aber nicht) der gleiche Dateiname sein, den der Client in der Anfrage vorgeschlagen hat. Dies wird ebenfalls in der zugehörigen Variablen gespeichert.ZeichenfolgeJA
    Prev
    REST API
    Next
    WebSocket API