URLs de borne

Comprenez à quoi sert une URL de borne, comment le code-barres scanné y est transmis, et ce qu'il faut donner à votre équipe technique.

3 min de lecture

Paramétrez l'adresse web qu'une borne charge pour que l'appareil ouvre toujours la bonne expérience OmniLab — et, quand un visiteur scanne sa carte, qu'il l'ouvre en tant que ce visiteur. Cette page s'adresse à la personne qui configure la borne et au développeur qui la raccorde.

Une URL de borne est l'adresse que vous chargez dans un écran borne, une tablette ou un appareil géré pour afficher une expérience OmniLab. Plutôt qu'un visiteur choisisse où aller, l'appareil ouvre toujours la même adresse — pointant directement vers une campagne, un point de contact ou un espace précis.

Bien paramétrer l'URL est important : si les visiteurs doivent arriver sur une activité précise, l'URL doit pointer vers ce point de contact. Si l'appareil doit afficher différentes expériences dans le temps, l'URL peut utiliser un paramètre qui contrôle laquelle se charge.

Ce que l'URL contrôle

  • Quelle expérience se charge — une page d'accueil de campagne complète, un point de contact précis ou un espace ciblé.
  • Si l'expérience fonctionne en mode intégré — les écrans bornes utilisent généralement un contexte intégré pour qu'OmniLab adapte son layout à l'écran.
  • La langue et la variante — vous pouvez verrouiller la borne sur une langue ou une variante d'expérience spécifique via l'URL.
  • Qui est le visiteur — quand un membre fidélité scanne sa carte, la borne ajoute son identifiant à l'adresse pour qu'OmniLab ouvre l'expérience en tant que ce membre.

La forme d'une adresse de borne

Une adresse de borne est votre adresse de campagne habituelle, avec un paramètre supplémentaire ajouté par la borne au moment du scan :

https://<votre-sous-domaine>.topage.co/<lien-campagne>?fci=<valeur-scannée>

Votre sous-domaine et votre lien de campagne viennent d'OmniLab Studio et ne changent jamais. La valeur scannée est ajoutée par la borne à chaque scan. Voir Sous-domaine et domaine personnalisé et URLs de points de contact et slugs.

Transmettre un membre fidélité à l'expérience

Le paramètre fci porte l'identifiant d'un client que vous connaissez déjà — la valeur imprimée sur sa carte de fidélité. Quand la borne l'ajoute à l'adresse, OmniLab connecte le visiteur auprès de votre système d'identité client et l'emmène directement dans l'expérience, sans formulaire à remplir.

Deux conditions doivent être réunies :

  • Votre système d'identité client est connecté à OmniLab. Sans cette connexion, OmniLab n'a rien contre quoi vérifier l'identifiant. Voir Comptes clients.
  • La valeur scannée correspond à l'identifiant que votre système détient pour ce client. Si elle ne correspond à aucun client connu, le visiteur voit un message lui indiquant que le compte est introuvable, et ne peut pas continuer.

Testez le cas de la carte inconnue

La vérification d'identité est volontairement stricte : une valeur non reconnue bloque la session au lieu de basculer sur une session anonyme. Scannez une carte censée ne pas fonctionner pendant les tests, pour savoir exactement ce que voit un visiteur dont la carte est mal saisie, expirée ou issue d'un autre programme.

Si vous voulez au contraire que de nouveaux visiteurs s'inscrivent sur la borne, utilisez une adresse de campagne normale sans paramètre fci et placez un formulaire d'acquisition sur le point de contact. Le visiteur le remplit sur le clavier de la borne, puis joue. Voir Paramétrer un formulaire d'acquisition et les recommandations clavier dans Exigences borne.

Ce qu'il faut donner à votre équipe technique

Votre développeur a besoin de l'URL de campagne OmniLab depuis OmniLab Studio, d'une note indiquant si la borne doit arriver sur une page de campagne ou aller directement vers une expérience précise, et — si vous utilisez des cartes de fidélité — du format de la valeur que produira le lecteur.

Transmettez ceci à votre développeur : Intégration borne (approfondissement technique)

Ce guide couvre les patterns d'URL en détail, les paramètres de requête utilisés dans les déploiements borne et les exigences techniques du wrapper pour l'intégration appareil et navigateur.

Pour aller plus loin

Sur cette page