Déclencheur de Message Post Reçu
Le déclencheur Message Post Reçu 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 dans l'expérience.
Table des matières
Aperçu
Le déclencheur Message Post Reçu peut être trouvé sous API/Déclencheur Externe dans le menu de sélection des déclencheurs.
Cas d'utilisation courants
- Un site Web intégré transférant des é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 sur les 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 Bidirectionnelle
Utiliser postMessage entre Labvanced et une page externe (comme un iFrame ou une application parente) est un processus bidirectionnel. 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 ceci en fournissant le contexte et en générant rapidement si nécessaire.
Un motif courant est que la page externe écoute ses propres événements utilisateur (comme les clics, les soumissions de formulaires ou les inscriptions) et transfère ensuite chacun comme un postMessage à Labvanced. Chaque type d'événement peut être étiqueté avec un label (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 d'exécution, 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 ?
- Key : ce message porte-t-il la valeur clé attendue (si une est définie) ?
Si les deux conditions sont remplies, le déclencheur s'active et le contenu du message devient disponible comme 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. Les data qu'elle envoie peuvent être n'importe quoi : une chaîne de caractères, une valeur structurée, ou une étiquette d'événement. Le champ Key dans Labvanced est comment vous faites correspondre 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 rapporte un clic, et un autre utilise Key: signup_event pour s'activer lorsqu'il rapporte une soumission de formulaire.
Lors de la sélection de Message Post Reçu, le dialogue suivant apparaîtra :
Options du Déclencheur
| Élément du Menu | Options du Déclencheur de Message Post Reçu |
|---|---|
Domaine d'origine | Spécifie quel domaine est autorisé à envoyer des messages à ce déclencheur. La valeur par défaut est *, qui accepte les 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://votresite.com). Cela est recommandé chaque fois que la source d'envoi est connue. |
Key | Entrez la valeur 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 porte cette valeur clé exacte. Laissez le champ vide pour s'activer sur tout message entrant, quelle que soit son contenu. |
Remarque: La valeur du message entrant sera exportée comme Message Content 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 Message Post Reçu, vous pouvez référencer les valeurs spécifiques au déclencheur suivantes dans les actions suivantes via le Menu de Sélection de Valeur.
| 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 piloter la 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 Unixtime. |
Trigger Time (From Frame Onset) | Temps en millisecondes depuis le début de la trame actuelle jusqu'à ce que le déclencheur soit activé. |
Lectures Complémentaires et Matériaux Ouverts
- Envoyer Action PostMessage : l'action associée pour envoyer un message à 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 de déclenchement et d'action dans Labvanced.