URLs et paramètres d'intégration
Construisez l'adresse que charge votre page, et contrôlez quelle expérience apparaît, dans quelle langue et quelle variante.
Construisez l'adresse chargée par votre page pour qu'elle ouvre exactement l'expérience voulue. Cette page s'adresse à qui écrit le code d'intégration.
Toute intégration part d'une adresse d'expérience dans OmniLab Studio et y ajoute des paramètres. L'adresse ne change jamais d'elle-même — si vous changez l'expérience affichée par une page, c'est cette adresse que vous modifiez.
L'adresse à charger
| Ce que vous voulez | Adresse |
|---|---|
| Une page de campagne proposant plusieurs expériences | https://experience.example.com/<campaign-public-link>?embedded=1 |
| Une expérience précise, ouverte directement | https://experience.example.com/<campaign-public-link>?c=<touchpoint-id>&embedded=1 |
| Un espace précis dans une expérience | https://experience.example.com/<campaign-public-link>?s=<space-id>&embedded=1 |
Incluez embedded=1 quand vous écrivez l'iframe vous-même. Ce paramètre indique à OmniLab qu'il s'exécute dans la page de quelqu'un d'autre, ce qui change sa mise en page et sa navigation. L'omettre produit une expérience qui se comporte comme si elle possédait toute la fenêtre.
Si vous utilisez le tag JavaScript, ne le mettez pas — le tag ajoute embedded=1 lui-même au moment de construire l'iframe.
Paramètres
| Paramètre | Contrôle | Remarques |
|---|---|---|
embedded | Le mode intégré | À mettre à 1 pour toute intégration |
c | Le point de contact qui s'ouvre | Omettez-le pour arriver sur la page de campagne |
s | L'espace qui s'ouvre | Pour les expériences qui ont des espaces |
l | La langue | Verrouille l'expérience sur une langue au lieu de suivre le visiteur |
v | La variante | Verrouille une variante précise de l'expérience |
fci | Le client qui se connecte | Uniquement avec les comptes clients configurés — voir Transmettre un client connu à une expérience |
Renseignez l quand la page environnante est déjà dans une langue et que vous ne voulez pas que l'expérience la contredise.
D'où viennent les identifiants
Le lien de campagne, l'identifiant de point de contact, celui d'espace et celui de variante viennent tous de la campagne dans OmniLab Studio. Voir URLs de points de contact et slugs.
Testez d'abord l'adresse seule
Ouvrez l'adresse dans un onglet de navigateur normal avant de la mettre dans une page. Si elle ne fonctionne pas seule, elle ne fonctionnera pas intégrée, et vous passerez le temps de débogage au mauvais endroit.
Pour aller plus loin
À propos de l'intégration site web
Donnez à une expérience OmniLab sa propre page sur votre site, encadrée par votre header et votre footer, et choisissez comment la page la charge.
Ce que votre page doit gérer
Les quatre choses dont votre page est responsable une fois une expérience OmniLab intégrée : hauteur, drawers, headers et permissions.