Disparador de Mensaje Recibido
El disparador Mensaje Recibido se activa cuando tu experimento de Labvanced en ejecución recibe un mensaje entrante de una fuente externa a través de la API postMessage del navegador. Úsalo para conectar tu estudio a una página web principal, una aplicación personalizada o un sitio web externo incrustado que envía datos directamente al experimento.
Tabla de Contenidos
Descripción General
El disparador Mensaje Recibido se puede encontrar listado bajo API/Disparador Externo en el menú de selección de disparadores.
Casos de uso comunes
- Un sitio web incrustado que reenvía eventos de interacción del usuario (clics, completaciones de formularios) a Labvanced como postMessages estructurados.
- Una aplicación principal (por ejemplo, un LMS personalizado o un portal web institucional) que envía un mensaje para avanzar en el experimento o pasar datos del participante.
- Una integración impulsada por JavaScript donde un script externo activa un punto específico en la lógica del experimento.
La Configuración Bidireccional
El uso de postMessage entre Labvanced y una página externa (como un iFrame o una aplicación principal) es un proceso bidireccional. Labvanced maneja un lado: este disparador escucha los mensajes entrantes. El otro lado es la página externa, que debe ser programada para enviar esos mensajes.
La API postMessage es una característica estándar del navegador. La página externa llama a window.parent.postMessage(data, targetOrigin) para enviar datos a Labvanced. Tú o tu desarrollador necesitarán escribir ese código. Una herramienta de codificación de IA también puede ayudarte a configurarlo proporcionando el contexto y generándolo rápidamente si es necesario.
Un patrón común es que la página externa escuche sus propios eventos de usuario (como clics, envíos de formularios o registros) y luego reenvíe cada uno como un postMessage a Labvanced. Cada tipo de evento puede ser etiquetado con una etiqueta (por ejemplo, click_event, signup_event) utilizando el campo Key, para que Labvanced pueda filtrar y responder a cada uno por separado con su propio evento.
Cómo Funciona
Cuando el experimento está en ejecución, Labvanced escucha los postMessages entrantes. Cada vez que llega un mensaje, verifica dos cosas:
- Dominio de Origen: ¿viene este mensaje de una fuente permitida?
- Key: ¿lleva este mensaje el valor de clave esperado (si se establece uno)?
Si se cumplen ambas condiciones, se activa el disparador y el contenido del mensaje se vuelve disponible como Message Content en tus acciones.
La página externa es responsable de enviar los mensajes. Lo hace llamando a window.parent.postMessage(data, targetOrigin) en su propio código. Los data que envía pueden ser cualquier cosa: una cadena simple, un valor estructurado o una etiqueta de evento. El campo Key en Labvanced es cómo coincides con un valor específico de esa etiqueta para distinguir un tipo de mensaje de otro.
Cada tipo de mensaje puede tener su propio evento dedicado en Labvanced. Por ejemplo, un evento utiliza Key: click_event para activarse cuando la página externa informa un clic, y otro utiliza Key: signup_event para activarse cuando informa un envío de formulario.
Al seleccionar Mensaje Recibido, aparecerá el siguiente diálogo:
Opciones de Disparador
| Elemento del Menú | Opciones del Disparador de Mensaje Recibido |
|---|---|
Dominio de Origen | Especifica qué dominio está permitido para enviar mensajes a este disparador. El valor predeterminado es *, que acepta mensajes de cualquier origen. Para restringir el disparador a una fuente específica, reemplaza * con la URL completa de origen (por ejemplo, https://tusitio.com). Esto se recomienda siempre que se conozca la fuente de envío. |
Key | Ingresa el valor de clave específico con el que deseas que coincida este disparador (por ejemplo, click_event, signup_event). El disparador solo se activará cuando un mensaje entrante lleve ese valor de clave exacto. Deja el campo vacío para activarse en cualquier mensaje entrante, independientemente del contenido. |
Nota: El valor del mensaje entrante se exportará como Message Content y se puede referenciar en las acciones a través del Menú de Selección de Valor.
Valores Específicos del Disparador para Mensaje Recibido
Después de seleccionar el disparador Mensaje Recibido, puedes referenciar los siguientes valores específicos del disparador en acciones posteriores a través del Menú de Selección de Valor.
| Valor | Descripción |
|---|---|
Message Content | La carga de datos del postMessage recibido. Este es el valor enviado por la fuente externa y puede almacenarse en una variable, utilizarse para impulsar la lógica o registrarse como parte de tu conjunto de datos. |
Trigger Timestamp (Unixtime) | La marca de tiempo de cuándo se activó el disparador, en Unixtime. |
Trigger Time (From Frame Onset) | Tiempo en milisegundos desde el inicio del marco actual hasta cuándo se activó el disparador. |
Lecturas Adicionales y Materiales Abiertos
- Enviar Acción postMessage: la acción emparejada para enviar un mensaje de vuelta a una fuente externa.
- Menú de Selección de Valor: cómo referenciar valores específicos del disparador en tus acciones.
- Descripción General de Eventos: una introducción completa al sistema de lógica de disparadores y acciones en Labvanced.