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
    • Browse recording top-ups →
    • Browse AI token top-ups →
    • Overview
    • Study Building
    • Subject Recruitment
    • Dedicated Support
    Checkout
  • Contact
    • ES
      • 中國人
      • Deutsch
      • Français
      • Español
      • English
      • 日本語
    • Logout
    • 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 recording top-ups →

    Need more AI tokens for the AI assistant and study translations? Simply use one of these AI token top-up packages.

    Browse AI token top-ups →
    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
    • 日本語
    • Introducción
    • Guía
      • INTRODUCCIÓN

        • Editor de Tareas
        • Marcos
          • Marco de Canvas
          • Marco de Página
          • Marco de Sitio Web
          • Superposiciones y Diálogos | Labvanced
        • Cronograma de Pruebas
        • Presentación de Estímulos
        • Corrección de Respuestas
        • Objetos
        • Eventos
        • Variables
        • Asistente de Tareas
        • Asistente de IA
        • Sistema de Pruebas
        • Diseño de Experimentos
          • Crear un Estudio
          • Importando Plantillas en Labvanced
          • Patrones de Marco de Datos
          • Diseño de Experimentos Multiusuario
          • Diseño de Experimento Longitudinal
      • TEMAS DESTACADOS

        • Aleatorización y Equilibrio
        • Seguimiento Ocular
          • Presentación de Estímulos en una Tarea de Seguimiento Ocular
          • Cómo Elegir Configuraciones de Calibración para Seguimiento Ocular
          • Configuración del Seguimiento Ocular en una Tarea
          • Grabación y Exportación de Datos de Mirada
          • Usando Formas como Áreas de Interés (AOI) para Seguimiento Ocular
          • La Experiencia de Calibración del Participante
        • Puente Web
          • Selección de AOIs de Sitio Web | Anclar, Ajustar y Verificar el Seguimiento de AOI
          • Seguimiento del Comportamiento del Ratón en un AOI del Sitio Web | Guía del Puente Web
        • Cuestionarios
        • Aplicación de Escritorio
        • Estudios de Muestra
        • Reclutamiento de Participantes
        • Acceso a API
          • REST API
          • API de Webhook
          • WebSocket API
        • Otros Temas

          • Tempos de Estímulo Precisos
          • Estudios de Múltiples Usuarios
          • Seguimiento de Cabeza en Labvanced | Guía
      • TABS PRINCIPALES DE LA APLICACIÓN

        • Resumen: Pestañas Principales
        • Tablero
        • Mis Estudios
        • Estudios Compartidos
        • Mis Archivos
        • Biblioteca de Experimentos
        • Mi Cuenta
        • Licencia y Servicios
      • TABS DE ESTUDIO

        • Resumen: Pestañas Específicas del Estudio
        • Diseño del Estudio
          • Tareas
          • Bloques
          • Sesiones
          • Grupos
        • Editor de Tareas
          • Controles de Tarea
          • El Sistema de Pruebas
          • Tipos de Marcos
          • Objetos
          • Tablas de Propiedades de Objetos
          • Variables
          • Tabla de Variables del Sistema
          • El Sistema de Eventos
          • Funciones del Editor de Texto
          • Opciones de Seguimiento Ocular en el Editor de Tareas
          • Seguimiento de Cabeza en una Tarea
          • Estudios Multiusuario
        • Configuraciones
        • Variables
        • Medios
        • Textos y Traducción
        • Lanzar y Participar
        • Gestión de Sujetos
        • Vista de Datos y Exportación
    • Tutoriales en video
      • Descripción general del video
      • Introducción a Labvanced
      • Creando tareas
      • Videos de elementos
      • Eventos y variables
      • Temas avanzados
    • Guías
      • Introducción
      • Tarea de Stroop
      • Tarea de decisión léxica
      • Tarea de cuentagotas de Posner
      • Paradigma de parpadeo de ceguera al cambio
      • Estudio de seguimiento ocular
      • Estudio de seguimiento ocular en lactantes
      • Estudio de captura atencional con seguimiento de ratón
      • Presentación visual serial rápida
      • Estudio de ChatGPT
      • Demostración de seguimiento ocular: SVGs como AOIs
      • Demostración multiusuario: Mostrar los cursores de los sujetos
      • Gamepad / Controlador de joystick - Configuración básica
      • Estudio de aplicación de escritorio con integración de EEG
      • Balanceo de grupos entre sujetos y configuración de variables
      • Construyendo un estudio multiusuario
      • Guía de seguimiento ocular en marco de sitio web
      • Seguimiento ocular condicional con webcam
      • Construcción del estudio de segmentación de texto
      • Construyendo un estudio con IA
    • Preguntas frecuentes
      • Características
      • Política y directrices de soporte
      • Seguridad y privacidad de datos
      • Licencias
      • Precisión de Labvanced
      • Uso programático y API
      • Uso de Labvanced sin conexión
      • Solución de problemas
      • Preguntas sobre la creación de estudios

    API de Webhook

    Uso: ​El caso de uso principal de la API de Webhook de Almacenamiento de Datos Externos de Labvanced es transferir datos de participantes en “tiempo real” a un servidor externo / remoto, en lugar de alojar los datos grabados en los servidores de Labvanced.

    NOTA: ​Contrario a muchos casos de uso de API, lo que se describe aquí NO es cómo llamar a la API / endpoints de Labvanced (tal funcionalidad no existe por ahora), sino más bien cómo debe configurar/implementar su backend, de modo que nuestra plataforma pueda llamar automáticamente a los endpoints que usted ha implementado para enviar los datos de los participantes directamente a su backend/base de datos en lugar del nuestro.

    Disponibilidad: ​Esta funcionalidad está disponible únicamente para los titulares de licencias de laboratorio de Labvanced.

    1. Configuración de la API de Webhook

    Para utilizar la API de Webhook, primero se debe activar la opción de “almacenamiento de datos externos” en “Configuraciones del Estudio” del respectivo estudio de Labvanced en la sección de “Características del Experimento”.

    1.1 Parámetros:

    • Dirección IP: Ingrese su dirección IP estática donde su servidor externo está funcionando / disponible públicamente.
    • Puerto: El puerto que se debe usar para enviar los datos.
    • Ruta URL​: La ruta URL que se debe agregar después del puerto. Esto es particularmente útil para “espaciar” sus proyectos / datos entrantes, de modo que los datos de diferentes experimentos se envíen a una ruta URL diferente. La ruta URL es opcional, pero recomendamos encarecidamente usarla.

    2. Crear el Servidor / Script para Recibir los Datos de la API de Webhook

    Basado en su configuración en el paso 1, debe implementar un servidor que esté disponible en la dirección IP, puerto y ruta URL especificados. Una versión simplificada / ejemplo de tal servidor está disponible en nuestra página de Github aquí.

    2.1 Formato de datos: Los datos se envían en formato JSON para todas las rutas excepto para la ruta “/file_upload”. La ruta “/file_upload” (utilizada para subir archivos binarios como videos o audios grabados) está codificada como “multipart/form-data”, así que asegúrese de analizar los datos entrantes correctamente como JSON o multipart/form-data / datos binarios.

    2.2. Configuración de CORS: Al implementar su backend, debe implementar / permitir Compartición de Recursos de Origen Cruzado (CORS). En particular, debe establecer los siguientes encabezados: “Access-Control-Allow-Origin” (incluir ​https://www.labvanced.com/​), “Access-Control-Allow-Methods” (incluir POST y OPTIONS), “Access-Control-Allow-Headers” (incluir Content-Type).

    2.3 Tipos de solicitudes: ​Todos los tipos de solicitudes son solicitudes POST ya que se utilizan para enviar datos. En este punto, un valor de retorno solo es necesario para la ruta “/file_upload”. Todas las demás rutas no necesitan un valor de retorno especial.

    2.4 Tipos de solicitudes / rutas: ​Cada vez que un participante forma parte de un estudio, en total se enviarán 8 diferentes ​tipos​ de solicitudes POST a (su servidor externo). La ruta “/file_upload” solo se usará si su estudio incluye una acción para subir algunos datos binarios grabados (por ejemplo, audio o video). Cada tipo de solicitud POST tiene una ruta diferente (ruta URL), que se agregará a la ruta URL especificada en el paso 1. Además, cada tipo de solicitud tiene una estructura/carga diferente, lo cual debe tener en cuenta al analizar y almacenar los datos. Consulte los detalles en la sección 3.

    3. Definiciones de Endpoints / Rutas de la API de Webhook:

    A continuación, verá una explicación detallada de cada ruta / endpoint que se utiliza/llama cuando un participante toma parte en el experimento. Idealmente, sugerimos que implemente todos estos endpoints (excepto 3.1), y asegúrese de que todos los datos se analicen y almacenen adecuadamente en su base de datos.

    ¿Qué endpoints se utilizan, qué servidor se llama cuando?

    • El endpoint 3.1 “/startExpPlayer” se envía solo al servidor de Labvanced para cargar la definición del experimento / archivo JSON y estímulos asociados desde nuestro servidor.
    • Los endpoints 3.2, 3.3, 3.4, 3.7 y 3.8 se envían tanto al servidor de Labvanced (necesario para el equilibrio de grupos y el flujo general del experimento) como al servidor externo/su.
    • Los endpoints 3.5 y 3.6 solo se envían al servidor externo/su. Tenga en cuenta que todos los datos de prueba/participante se envían a través de la ruta 3.6, que por tanto es el endpoint más importante a implementar.
    • El endpoint 3.9 solo se envía al servidor externo/su y se llama cada vez que se ejecuta una “acción de carga” para subir datos binarios (audio o video).

    3.1 Carga del experimento

    • Ruta: /startExpPlayer
    • Tipo: POST
    • Llamado cuando: El participante visita una cierta URL de experimento en labvanced.com. Función principal en el servidor de Lavanced: Inicializa la carga del experimento.
    • Carga útil: JSON con los siguientes campos:
    Nombre del CampoDescripciónTipo de DatosRequerido
    expIdIdentificador único para el estudioEnteroSÍ
    isTestrunSi los datos se están grabando o noBooleanoNO
    subject_codeIdentificador del sujeto a través del parámetro URLCadenaNO
    tokenUn identificador único para participantes en estudios longitudinalesIdentificador de tokenNO
    askSubjDataSi se debe mostrar una encuesta inicial, utilizada para poner a los sujetos en diferentes gruposBooleanoSÍ

    NOTA: No es necesario implementarlo en servidores externos, ya que esto solo inicializa la carga del experimento desde el servidor de Labvanced al computador cliente.


    3.2 Selección de grupo y sesión

    • Ruta: /startFirstPlayerSession
    • Tipo: POST
    • Llamado cuando: La ruta 3.1 “/startExpPlayer” devuelve exitosamente desde el servidor de Labvanced.
    • Función principal en el servidor de Lavanced: Se utiliza para asignar números de grupo y sesión a un sujeto (equilibrio del lado del servidor).
    • Carga útil: JSON con los siguientes campos:
    Nombre del CampoDescripciónTipo de DatosRequerido
    expIdIdentificador único para el estudioEnteroSÍ
    expSessionNrIdentificador único para la sesión de grabación de este participante (contando hacia arriba)CadenaSÍ
    subject_codeIdentificador del sujeto basado en el parámetro URLCadenaNO
    tokenUn identificador único para participantes en estudios longitudinalesIdentificador de tokenNO
    survey_dataJSON del cuestionario previo al estudio, campos descritos a continuación.JSONNO
    survey_data.selectedGenderGénero seleccionado del participanteCadenaNO
    survey_data.selectedAgeEdad seleccionada del participanteEnteroNO
    survey_data.selectedCountryPaís/localización seleccionada del participanteCadenaNO
    survey_data.selectedLanguageLengua (primaria) seleccionada del participanteCadenaNO
    isTestrunSi los datos se están grabando o noBooleanoSÍ
    runOnlyGroupNrSolo se utiliza para ejecutar pruebas de un cierto número de grupo sin grabaciones de datosEntero / FalsoNO
    runOnlySessionNrSolo se utiliza para ejecutar pruebas de un cierto número de sesión sin grabaciones de datosEntero / FalsoNO
    groupNrNúmero de grupo para este sujetoEnteroSÍ
    sessionNrNúmero de sesión en un estudio longitudinalEnteroSÍ
    group_nameEl nombre del grupo para este sujetoCadenaSÍ
    session_nameEl nombre de la sesión para este sujetoCadenaSÍ
    experiment_nameEl nombre del experimento (no el nombre de publicación)CadenaSÍ

    3.3 ​Inicio del experimento

    • Ruta: /setPlayerSessionStartedTime
    • Tipo: POST
    • Llamado cuando: El participante presiona “Iniciar Experimento”.
    • Función en el servidor de Lavanced: Guarda el tiempo de inicio, la sesión y el nombre del grupo del experimento y comienza el experimento.
    • Carga útil: JSON con los siguientes campos:
    Nombre del CampoDescripciónTipo de DatosRequerido
    expIdIdentificador único para el estudioEnteroSÍ
    expSessionNrIdentificador único para la sesión de grabación de este participante (contando hacia arriba)CadenaSÍ
    start_timeHora de inicio del experimentoMarca de tiempo UNIXSÍ
    sessionNrNúmero de sesión en un estudio longitudinalEnteroSÍ
    groupNrNúmero de grupo para este sujetoEnteroSÍ
    tokenUn identificador único para participantes en estudios longitudinalesIdentificador de tokenNO

    3.4 Agregar información de metadatos

    • Ruta: /addMetaInfo
    • Tipo: POST
    • Llamado cuando: El participante presiona “Iniciar Experimento”.
    • Función en el servidor de Lavanced: Guarda la información meta en el servidor.
    • Carga útil: JSON con los siguientes campos:
    Nombre del CampoDescripciónTipo de DatosRequerido
    expIdIdentificador único para el estudioEnteroSÍ
    expSessionNrIdentificador único para la sesión de grabación de este participante (contando hacia arriba)CadenaSÍ
    var_dataEl JSON que contiene la información metaJSONSÍ
    var_data.browserSpecEl navegador utilizado por el sujetoCadenaNO
    var_data.versionSpecLa versión del navegador utilizado por el sujetoCadenaNO
    var_data.systemSpecEl tipo de dispositivo / SO utilizado por el sujetoCadenaNO
    var_data.agentSpecLa cadena completa del agente de usuarioCadenaNO
    var_data.fullscreenIndica si el estudio siempre está en pantalla completaBooleanoNO
    var_data.timeDelayMeanLa precisión media de la callback de JavaScript en milisegundosFlotanteNO
    var_data.timeDelayStdLa desviación estándar de la precisión de la callback de JavaScript en milisegundosFlotanteNO
    var_data.crowdsourcingCodeEl código de crowdsourcing / finalización para los sujetosCadenaNO
    var_data.crowdsourcinSubjIdLa ID del trabajador de crowdsourcing / sujetoCadenaNO
    var_data.subjCounterGlobalUn contador global de sujetos para el número de sujetos en el estudioEnteroNO
    var_data.subjCounterPer GroupUn contador de sujetos por grupo en el estudioArray de EnterosNO
    var_data.roleIdLa ID de rol única para estudios de múltiples usuarios del sujetoEnteroNO
    var_data.multiUserGroupIdLa ID de grupo única global para estudios de múltiples usuariosUuidNO
    var_data.displayedLanguageEl idioma de visualización seleccionado para estudios multilingüesCadenaNO
    var_data.pixelDensityPerMMLa densidad de píxeles de la pantallaFlotanteNO
    var_data.screenHeightLa altura de la pantalla en píxelesEnteroNO
    var_data.screenWidthEl ancho de la pantalla en píxelesEnteroNO
    var_data.windowHeightLa altura de la ventana / viewport en píxelesEnteroNO
    var_data.windowWidthEl ancho de la ventana/viewport en píxelesEnteroNO

    3.5 Grabar información sobre una tarea

    • Ruta: /recordStartTask
    • Tipo: POST
    • Llamado cuando: Inicia una nueva tarea en el flujo del experimento.
    • Función en el servidor de Lavanced: No se llama cuando se activan las solicitudes de API externas.
    • Carga útil: JSON con los siguientes campos:
    Nombre del CampoDescripciónTipo de DatosRequerido
    expIdIdentificador único para el estudioEnteroSÍ
    expSessionNrIdentificador único para la sesión de grabación de este participante (contando hacia arriba)CadenaSÍ
    blockNrNúmero de bloque actual (contador ascendente)EnteroSÍ
    blockIdID única del bloque actualUuidSÍ
    blockNameNombre del bloqueCadenaSÍ
    taskNrNúmero de tarea actual (contador ascendente)EnteroSÍ
    taskIdID de la tarea actual como se define en el editor (igual entre sujetos)UuidSÍ
    recTaskIdID generada por el servidor para la tarea de grabación actual (diferente entre sujetos)EnteroSÍ
    taskNameNombre de la tarea actualCadenaSÍ
    start_timeHora de inicio de la tareaMarca de tiempo UNIXSÍ

    3.6 Grabar datos de prueba

    • Ruta: /recordTrial
    • Tipo: POST
    • Llamado cuando: Se termina una prueba O se ejecuta una acción de grabación personalizada.
    • Función en el servidor de Lavanced: No se llama cuando se activan las solicitudes de API externas.
    • Carga útil: JSON con los siguientes campos:
    Nombre del CampoDescripciónTipo de DatosRequerido
    expIdIdentificador único para el estudioEnteroSÍ
    expSessionNrIdentificador único para la sesión de grabación de este participante (contando hacia arriba)CadenaSÍ
    recTaskIdID generada por el servidor para la tarea de grabación actual (diferente entre sujetos)EnteroSÍ
    taskIdID de la tarea actual como se define en el editor (igual entre sujetos)UuidSÍ
    trailNrNúmero de pruebaEnteroSÍ
    recDataLos datos principales / todas las variables creadas por el usuario por prueba se almacenan aquíJSONSÍ

    NOTA: Los datos exactos que se registran por prueba dependen del experimento específico y de la tarea. Una visión general para cada estudio está disponible en la pestaña "Variables" del experimento específico (ver captura de pantalla). Tenga en cuenta también que los nombres de las variables de la API externa se utilizarán como clave en la estructura JSON. Por lo tanto, asegúrese de que los nombres de las variables sean únicos. De lo contrario, sobrescribirá los datos. El sistema de Labvanced normalmente obliga al usuario a utilizar nombres de variable únicos.

    Resumen de la pestaña Variables en Labvanced

    3.7 Terminar el experimento con éxito

    • Ruta: /finishExpSession
    • Tipo: POST
    • Llamado cuando: El experimento se finaliza con éxito.
    • Función en el servidor de Lavanced: Termina el estudio y marca el conjunto de datos como completado (importante para el equilibrio).
    • Carga útil: JSON con los siguientes campos:
    Nombre del CampoDescripciónTipo de DatosRequerido
    expIdIdentificador único para el estudioEnteroSÍ
    expSessionNrIdentificador único para la sesión de grabación de este participante (contando hacia arriba)CadenaSÍ
    end_timeHora en que finalizó el experimentoMarca de tiempo UNIXSÍ
    var_dataIgual que los datos var en la ruta “/addMetaInfo” (información actualizada)JSONSÍ
    nextStartTimePróxima hora de inicio (solo para estudios longitudinales)Marca de tiempo UNIXNO
    nextEndTimePróxima hora de finalización (solo para estudios longitudinales)Marca de tiempo UNIXNO
    reminderTimeTiempo hasta la próxima hora de inicio (solo para estudios longitudinales)Cadena de tiempoNO
    selectedEmailCorreo electrónico para enviar recordatorio de participación (solo para estudios longitudinales)Dirección de correo electrónicoNO
    emailReminderCuándo enviar el recordatorio (solo para estudios longitudinales)CadenaNO

    3.8 Terminar el experimento con fallo

    • Ruta: /errExpSession
    • Tipo: POST
    • Llamado cuando: El experimento es abortado con un error.
    • Función en el servidor de Lavanced: Aborta el estudio y marca el conjunto de datos como incompleto.
    • Carga útil: JSON con los siguientes campos:
    Nombre del CampoDescripciónTipo de DatosRequerido
    expIdIdentificador único para el estudioEnteroSÍ
    expSessionNrIdentificador único para la sesión de grabación de este participante (contando hacia arriba)CadenaSÍ
    err_msgEl mensaje de errorCadenaSÍ

    3.9 Subir datos binarios (audio o video)

    • Ruta: /file_upload
    • Tipo: POST
    • Llamado cuando: Se ejecuta una acción de carga en el sistema de eventos asociada con algún objeto de grabación de audio o video. Función en el servidor de Lavanced: No se llama cuando se activan las solicitudes de API externas.
    • NOTA: El servidor debe enviar valores de retorno para esta ruta (explicado a continuación). Si esto no se hace, el desencadenador “onUploadComplete” no se ejecuta y el experimento no puede propagarse correctamente. También tenga en cuenta que los datos en esta ruta están codificados como “multipart/form-data” ya que incluye tanto datos binarios como no binarios.
    • Carga útil: JSON con los siguientes campos:
    Nombre del CampoDescripciónTipo de DatosRequerido
    expSessionNrIdentificador único para la sesión de grabación de este participante (contando hacia arriba)CadenaSÍ
    newFileNameEl nombre de archivo sugerido para almacenar el archivo. El nombre del archivo incluye el nombre de variable asociada, y el número actual, bloque, tarea y prueba.CadenaSÍ
    myFileEl archivo real / datos binariosBinarioSÍ

    Respuesta Requerida:

    Nombre del CampoDescripciónTipo de DatosRequerido
    file_guidIdentificador Único Global (guid) para el archivo grabado. Este debe ser generado del lado del servidor y será guardado en la variable asociada con el archivo para que luego sea fácil entender de qué archivo provino qué objeto de grabación.UuidSÍ
    file_nameEl nombre de archivo resultante que el servidor utilizó para guardar el archivo. Este puede ser (pero no tiene que ser) el mismo nombre de archivo sugerido por el cliente en la solicitud. Esto también se almacenará en la variable asociada.CadenaSÍ
    Prev
    REST API
    Next
    WebSocket API