
Disparador de Mensaje PostMessage Recibido
El disparador PostMessage Received 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 integrado que envíe datos directamente al experimento.
Tabla de Contenidos
Descripción General
El disparador PostMessage Received se puede encontrar listado bajo el API/External Trigger en el menú de selección de disparadores.

Casos de Uso Comunes
- Un sitio web integrado 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) envía un mensaje para avanzar 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
Usar 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 estar 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 configurar esto al darle el contexto y generarlo 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 etiquetarse 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, comprueba dos cosas:
- Dominio de Origen: ¿viene este mensaje de una fuente permitida?
- Clave: ¿lleva este mensaje el valor de clave esperado (si se establece uno)?
Si ambas condiciones se cumplen, se activa el disparador y la carga del mensaje se vuelve disponible como Message Content en tus acciones.
La página externa es responsable de enviar los mensajes. Esto lo hace llamando a window.parent.postMessage(data, targetOrigin) en su propio código. El data que envía puede ser cualquier cosa: una cadena simple, un valor estructurado o una etiqueta de evento. El campo Key en Labvanced es cómo emparejas 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 usa Key: click_event para activarse cuando la página externa reporta un clic, y otro usa Key: signup_event para activarse cuando reporta un envío de formulario.
Al seleccionar PostMessage Received, aparecerá el siguiente diálogo:

Opciones del Disparador
| Elemento del Menú | Opciones del Disparador de Mensaje PostMessage Recibido |
|---|---|
Origin Domain | Especifica qué dominio está permitido 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://yoursite.com). Se recomienda esto siempre que la fuente de envío sea conocida. |
Key | Ingresa el valor de clave específico que este disparador debe coincidir (por ejemplo, click_event, signup_event). El disparador solo se activará cuando un mensaje entrante contenga ese valor de clave exacto. Deja el campo vacío para activar en cualquier mensaje entrante, independientemente del contenido. |
Nota: El valor del mensaje entrante se exportará como Contenido del Mensaje y puede referenciarse en acciones a través del Menú de Selección de Valor.
Valores Específicos del Disparador para Mensaje PostMessage Recibido
Después de seleccionar el disparador PostMessage Received, puedes referenciar los siguientes valores específicos del disparador en acciones subsecuentes a través del Value-Select Menu.
| 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, usarse para impulsar la lógica o registrarse como parte de tu conjunto de datos. |
Trigger Timestamp (Unixtime) | La hora en que se activó el disparador, en tiempo Unix. |
Trigger Time (From Frame Onset) | Tiempo en milisegundos desde el inicio del cuadro actual hasta que se activó el disparador. |
Lectura Adicional
Acción de Enviar PostMessage
La acción emparejada para enviar un mensaje de regreso 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 disparador y acción en Labvanced.