Disparador de Mensaje PostRecibido

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 padre, una aplicación personalizada o un sitio web externo incrustado que envía datos directamente al experimento.

Descripción General

El disparador PostMessage Received se puede encontrar listado bajo el API/External Trigger en el menú de selección de disparadores.

Seleccionando el disparador de Mensaje PostRecibido de la categoría API/Disparador Externo en el editor de eventos de Labvanced.

Ubicando el disparador Mensaje PostRecibido bajo API/Disparador Externo en el editor de eventos.

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 padre (por ejemplo, un LMS personalizado o un portal web institucional) enviando un mensaje para avanzar el experimento o pasar datos de participantes.
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 padre) 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 tendrán que escribir ese código. Una herramienta de codificación AI también puede ayudarte a configurarlo dándole 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) usando 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 funcionamiento, 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 ha establecido uno)?

Si se cumplen ambas condiciones, el disparador se activa y el contenido del mensaje se convierte en 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. 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 la forma en que 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 informa un clic, y otro usa Key: signup_event para activarse cuando informa un envío de formulario.

Al seleccionar PostMessage Received, aparecerá el siguiente diálogo:

El diálogo de configuración del disparador de Mensaje PostRecibido en Labvanced, mostrando los campos de Dominio de Origen y Clave.

Opciones de configuración para el disparador de Mensaje PostRecibido. El valor del mensaje entrante se exportará como Contenido del Mensaje.

Opciones del Disparador

Elemento del Menú	Opciones del Disparador de Mensaje PostRecibido
`Origin Domain`	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 de origen completa (por ejemplo, `https://yoursite.com`). Esto se recomienda siempre que se conozca la fuente de envío.
`Key`	Ingresa el valor de clave específico 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 activar con cualquier mensaje entrante, independientemente del contenido.

Nota: El valor del mensaje entrante se exportará como Contenido del Mensaje y puede ser referenciado en las acciones a través del Menú de Selección de Valores.

Valores Específicos del Disparador para Mensaje PostRecibido

Después de seleccionar el disparador PostMessage Received, puedes referenciar los siguientes valores específicos del disparador en acciones posteriores a través de Value-Select Menu.

Valor	Descripción
`Message Content`	La carga útil de datos del postMessage recibido. Este es el valor enviado por la fuente externa y puede ser almacenado en una variable, utilizado para impulsar la lógica o registrado como parte de tu conjunto de datos.
`Trigger Timestamp (Unixtime)`	La marca de tiempo de cuando se activó el disparador, en tiempo Unix.
`Trigger Time (From Frame Onset)`	Tiempo en milisegundos desde el inicio del cuadro actual hasta cuando se activó el disparador.

Lectura Adicional y Materiales Abiertos

Acción Enviar PostMessage: la acción emparejada para enviar un mensaje de vuelta a una fuente externa.
Menú de Selección de Valores: 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.