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.

3 min de lecture

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 voulezAdresse
Un point de contact, ouvert directementhttps://play.lindenhall.example/lindenhall-autumn-workshops?c=<touchpoint-id>&embedded=1
Un espace précis dans une expériencehttps://play.lindenhall.example/lindenhall-autumn-workshops?s=<space-id>&embedded=1
La page d'accueil de la campagne, si elle en a unehttps://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ètreContrôleRemarques
embeddedLe 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.
cLe point de contact qui s'ouvreOmettez-le pour ouvrir la page d'accueil, si la campagne en a une
sL'espace qui s'ouvrePour les expériences qui ont des espaces
lLa langueOuvre 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.
vLa varianteOuvre une variante précise de l'expérience
fciLe client qui se connecteUniquement avec les comptes clients configurés : voir Transmettre un client connu à une expérience
loginLe statut de connexion au chargement de la page0 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.
frameoriginLa page où la connexion ramène le visiteurL'adresse complète de votre page. Nécessite embedded=1 et frameparam : voir Une page parente écrite à la main.
frameparamLe paramètre de votre page qui nomme l'expérienceDé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

Sur cette page