Déclencheur de Message Post Reçu
Le déclencheur PostMessage Received s'active lorsque votre expérience Labvanced en cours reçoit un message entrant d'une source externe via l'API postMessage du navigateur. Utilisez-le pour connecter votre étude à une page web parente, une application personnalisée ou un site web externe intégré qui envoie des données directement à l'expérience.
Table des Matières
Aperçu
Le déclencheur PostMessage Received peut être trouvé sous API/External Trigger dans le menu de sélection de déclencheurs.
Cas d'utilisation courants
- Un site web intégré transférant les événements d'interaction utilisateur (clics, complétions de formulaires) vers Labvanced sous forme de postMessages structurés.
- Une application parente (par exemple, un LMS personnalisé ou un portail web institutionnel) envoyant un message pour faire avancer l'expérience ou transmettre des données de participants.
- Une intégration pilotée par JavaScript où un script externe déclenche un point spécifique dans la logique de l'expérience.
La Configuration Bilatérale
L'utilisation de postMessage entre Labvanced et une page externe (comme un iFrame ou une application parente) est un processus bilatéral. Labvanced gère un côté : ce déclencheur écoute les messages entrants. L'autre côté est la page externe, qui doit être programmée pour envoyer ces messages.
L'API postMessage est une fonctionnalité standard du navigateur. La page externe appelle window.parent.postMessage(data, targetOrigin) pour envoyer des données à Labvanced. Vous ou votre développeur devrez écrire ce code. Un outil de codage AI peut également vous aider à configurer cela rapidement si nécessaire.
Un schéma courant consiste pour la page externe à écouter ses propres événements utilisateurs (comme des clics, des soumissions de formulaire ou des inscriptions) et à transmettre chacun d'eux sous forme de postMessage vers Labvanced. Chaque type d'événement peut être étiqueté avec une étiquette (par exemple, click_event, signup_event) en utilisant le champ Key, afin que Labvanced puisse filtrer et répondre à chacun séparément avec son propre événement.
Comment ça fonctionne
Lorsque l'expérience est en cours, Labvanced écoute les postMessages entrants. Chaque fois qu'un message arrive, il vérifie deux choses :
- Domaine d'Origine : ce message provient-il d'une source autorisée ?
- Clé : ce message porte-t-il la valeur de clé attendue (si une est définie) ?
Si les deux conditions sont remplies, le déclencheur s'active et la charge utile du message devient disponible sous Message Content dans vos actions.
La page externe est responsable de l'envoi des messages. Elle le fait en appelant window.parent.postMessage(data, targetOrigin) dans son propre code. Le data qu'elle envoie peut être n'importe quoi : une chaîne brute, une valeur structurée ou une étiquette d'événement. Le champ Key dans Labvanced est comment vous associez une valeur spécifique de cette étiquette pour distinguer un type de message d'un autre.
Chaque type de message peut avoir son propre événement dédié dans Labvanced. Par exemple, un événement utilise Key: click_event pour s'activer lorsque la page externe signale un clic, et un autre utilise Key: signup_event pour s'activer lorsqu'il signale une soumission de formulaire.
Lors de la sélection de PostMessage Received, la boîte de dialogue suivante apparaîtra :
Options de Déclencheur
| Élément de Menu | Options de Déclencheur de Message Post Reçu |
|---|---|
Origin Domain | Spécifie quel domaine est autorisé à envoyer des messages à ce déclencheur. La valeur par défaut est *, qui accepte des messages de n'importe quelle origine. Pour restreindre le déclencheur à une source spécifique, remplacez * par l'URL d'origine complète (par exemple, https://yoursite.com). Cela est recommandé chaque fois que la source d'envoi est connue. |
Key | Entrez la valeur de clé spécifique que vous souhaitez que ce déclencheur corresponde (par exemple, click_event, signup_event). Le déclencheur ne s'activera que lorsqu'un message entrant portera cette valeur de clé exacte. Laissez le champ vide pour s'activer sur tout message entrant, quelle que soit son contenu. |
Note : La valeur du message entrant sera exportée comme Contenu du Message et peut être référencée dans les actions via le Menu de Sélection de Valeur.
Valeurs Spécifiques au Déclencheur pour Message Post Reçu
Après avoir sélectionné le déclencheur PostMessage Received, vous pouvez référencer les valeurs spécifiques au déclencheur suivantes dans les actions suivantes via le Value-Select Menu.
| Valeur | Description |
|---|---|
Message Content | La charge utile de données du postMessage reçu. C'est la valeur envoyée par la source externe et peut être stockée dans une variable, utilisée pour déclencher une logique, ou enregistrée comme partie de votre ensemble de données. |
Trigger Timestamp (Unixtime) | L'horodatage du moment où le déclencheur s'est activé, en temps Unix. |
Trigger Time (From Frame Onset) | Temps en millisecondes depuis le début du cadre actuel jusqu'à ce que le déclencheur s'active. |
Lectures Complémentaires et Matériaux Ouverts
- Envoyer une Action PostMessage : l'action associée pour envoyer un message de retour à une source externe.
- Menu de Sélection de Valeur : comment référencer des valeurs spécifiques au déclencheur dans vos actions.
- Aperçu des Événements : une introduction complète au système de logique déclencheur-action dans Labvanced.