URLs et paramètres d'intégration
Construisez l'adresse que charge votre page, et choisissez l'expérience affichée, sa langue et sa variante.
Cette page s'adresse à la personne qui écrit le code d'intégration. Toute intégration part d'une adresse copiée depuis Studio, à laquelle s'ajoutent des paramètres. Pour changer l'expérience affichée par une page, il suffit de modifier cette adresse.
L'adresse à charger
Ici, l'hôte de l'expérience est play.lindenhall.example, et le lien de la campagne est lindenhall-autumn-workshops :
| Ce que vous voulez | Adresse |
|---|---|
| Un point de contact, ouvert directement | https://play.lindenhall.example/lindenhall-autumn-workshops?c=<touchpoint-id>&embedded=1 |
| Un espace précis dans une expérience | https://play.lindenhall.example/lindenhall-autumn-workshops?s=<space-id>&embedded=1 |
| La page d'accueil de la campagne, si elle en a une | https://play.lindenhall.example/lindenhall-autumn-workshops?embedded=1 |
Sans page d'accueil, le lien de la campagne n'a rien à ouvrir : utilisez donc un lien de point de contact.
Incluez embedded=1 quand vous écrivez l'iframe vous-même. Il indique à l'expérience qu'elle se trouve dans votre page, ce qui change le fonctionnement de sa hauteur, de ses panneaux et de la connexion : voir Ce que votre page doit gérer. Sans lui, l'expérience se comporte comme si elle occupait toute la fenêtre. Le tag JavaScript ajoute embedded=1 pour vous.
Paramètres
| Paramètre | Contrôle | Remarques |
|---|---|---|
embedded | Le mode intégré | 1 quand la page autour de l'iframe la dimensionne et fait défiler jusqu'aux panneaux, comme le fait le tag JavaScript. Omettez-le dans une WebView, ou dans une iframe fixée à l'écran. |
c | Le point de contact qui s'ouvre | Omettez-le pour ouvrir la page d'accueil, si la campagne en a une |
s | L'espace qui s'ouvre | Pour les expériences qui ont des espaces |
l | La langue | Ouvre l'expérience dans cette langue, si la campagne la propose. Sans l : le dernier choix du visiteur, sinon la langue par défaut de la campagne. Avec un l que la campagne ne propose pas : la langue par défaut de la campagne. |
v | La variante | Ouvre 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 |
login | Le statut de connexion au chargement de la page | 0 démarre l'expérience sans connexion, même pour un participant qui s'est connecté auparavant. 1 fait passer le visiteur par la connexion avant tout affichage. Aucun des deux ne s'applique au retour de la connexion. Le tag JavaScript le définit : voir Statut de connexion. |
frameorigin | La page où la connexion ramène le visiteur | L'adresse complète de votre page. Nécessite embedded=1 et frameparam : voir Une page parente écrite à la main. |
frameparam | Le paramètre de votre page qui nomme l'expérience | Définissez-le sur id : le retour de la connexion utilise toujours id. |
Renseignez l quand la page autour de l'expérience est déjà dans une langue, pour éviter que les deux ne divergent.
D'où viennent les identifiants
Le lien de la campagne, l'ID du point de contact, l'ID d'espace et l'ID de variante viennent tous de la campagne dans Studio. Voir URLs de points de contact et slugs pour savoir où chacun apparaît.
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 chercheriez le problème au mauvais endroit.
Étapes suivantes
À propos de l'intégration site web
Consacrez une page de votre site à une expérience OmniLab, et choisissez comment cette page la charge.
Ce que votre page doit gérer
Ce dont votre page est responsable une fois une expérience intégrée : hauteur, panneaux, headers, connexion, politique de sécurité et permissions.