Configurer et personnaliser Cloudbeds Booking Engine Immersive Experience 2.0

Objectif Installer, intégrer et maintenir Immersive Experience 2.0 du Cloudbeds Booking Engine sur le site web de ton établissement.
Idéal pour Les administrateurs, gestionnaires, propriétaires de l’établissement, ainsi que le développeur web responsable de la mise en œuvre.
Utilise ceci lorsque Tu souhaites installer, configurer, personnaliser ou dépanner Immersive Experience 2.0 sur le site web de ton établissement.
Prérequis Accès aux Intégrations premium, domaine de ton site web, code de ton établissement, et accès au code HTML de ton site web.
Résultat attendu Immersive Experience 2.0 se charge sur un site web autorisé de l’établissement en utilisant le chargeur supporté et le mode d’intégration sélectionné.
Limitations Les constructeurs de sites basés sur des modèles ou sans code peuvent gérer les scripts personnalisés différemment. Ne place pas les étiquettes du composant web Immersive Experience 2.0 à l’intérieur d’iframes.

Introduction

Immersive Experience 2.0 du Cloudbeds Booking Engine intègre le parcours de réservation directement dans le site web de ton établissement sans utiliser de masquage basé sur iframe. Ton site web doit être autorisé via une Liste d’autorisation de domaines, et le script chargeur supporté doit être installé dans le code HTML du site avant que le composant web puisse s’afficher.

Utilise ce guide pour la mise en œuvre elle-même ainsi que pour les considérations techniques pouvant affecter le flux de réservation, notamment les plateformes de gestion du consentement (CMP), les créateurs de sites, le suivi, les paramètres de recherche et le style personnalisé. Pour un aperçu général du moteur de réservation, consulte Cloudbeds Booking Engine : Tout ce que tu dois savoir.

Table des matières

À propos d’Immersive Experience 2.0

Cloudbeds Booking Engine Immersive Experience 2.0 est un composant web qui permet aux clients de rechercher la disponibilité, de sélectionner des chambres et des tarifs, de saisir leurs informations et de finaliser le paiement directement depuis le site web de ton établissement. Il peut être mis en œuvre comme une expérience en pleine page ou s’ouvrir depuis un bouton Réserver maintenant.

Principaux avantages

Immersive Experience 2.0 introduit des fonctionnalités uniques conçues pour améliorer l’expérience de réservation de tes clients sur ton propre site web :

  • Taux de conversion plus élevés : moins de clics, des temps de chargement plus rapides et une expérience de marque cohérente génèrent plus de réservations.
  • Plus de personnalisation : crée une expérience client unique et mémorable sans les contraintes d’un iframe standard.
  • Croissance basée sur les données : accède aux métriques clés et aux analyses pour optimiser ton processus de réservation et augmenter les réservations directes.
  • Confiance accrue : le flux de réservation sécurisé et fluide renforce la confiance des clients, les encourageant à finaliser leur réservation.

Composants web vs. basés sur iframe

Contrairement aux systèmes basés sur iframe, ce composant web intégré offre :

  • Des temps de chargement plus rapides du site web
  • Une personnalisation de marque améliorée
  • Un flux de réservation unifié qui garantit que les clients restent sur le site depuis leur recherche initiale jusqu’au paiement

À quoi ça ressemble

Immersive Experience 2.0 propose deux options d’intégration flexibles pour s’adapter au design du site de ton établissement et au parcours utilisateur. Tu peux choisir d’intégrer une expérience en pleine page ou de créer et intégrer une expérience Immersive sous forme de pop-up.

  • L’intégration en pleine page fonctionne exactement comme son nom l’indique : elle place le moteur de réservation complet directement au sein d’une page de ton site web, offrant aux clients un parcours de réservation fluide et totalement immersif du début à la fin.

L’intégration en pleine page maintient le client sur le site de l’établissement pendant qu’il recherche des hébergements disponibles, consulte les tarifs et construit sa réservation.

Immersive Experience 2.0 intégration en pleine page montrant les résultats de recherche d’hébergements, les options de chambre et de tarif, le résumé de la réservation, et le bouton Réserver maintenant

Lors du check-out, les clients saisissent leurs coordonnées, des informations supplémentaires facultatives, des invités additionnels, ainsi que leurs préférences de communication sans quitter le flux de réservation intégré.

Immersive Experience 2.0 étape des informations client montrant les champs du client principal, l’heure d’arrivée estimée, les informations supplémentaires, l’option invité supplémentaire, les préférences de communication, et le résumé de la réservation

Avant de finaliser la réservation, les clients peuvent consulter les conditions générales de l’établissement concernant le check-in, le check-out, l’annulation, et autres.

Immersive Experience 2.0 fenêtre modale des conditions générales montrant les politiques de check-in et check-out, les politiques d’annulation, les conditions, la case d’accord, et le bouton Confirmer et finaliser la réservation

  • L’option d’intégration en pop-up offre une alternative élégante et moderne. Lorsqu’un client clique sur le bouton « Réserver maintenant », un panneau latéral glisse en douceur depuis le bord de l’écran, proposant une expérience de réservation compacte mais entièrement fonctionnelle sans quitter la page en cours.

Dans cette mise en œuvre en pop-up, le client ouvre l’Immersive Experience depuis le bouton Réserver maintenant de l’établissement tandis que le site original reste visible derrière le panneau de réservation.

Site de l’établissement montrant le bouton Réserver maintenant et Immersive Experience 2.0 ouvert en panneau de réservation pop-up avec contrôle de date, client, code promo, filtre, et recherche

Le flux de réservation inclut :

  • Recherche de disponibilité
  • Sélection de la chambre
  • Affichage des tarifs
  • Opportunités de vente additionnelle
  • Saisie des informations client
  • Traitement sécurisé du paiement

 Dans le flux de réservation Immersive Experience 2.0 (fenêtre pop-up et page complète), les détails de recherche du client, y compris les dates, le nombre de clients, les codes promo, les chambres sélectionnées et la progression du check-out, sont automatiquement conservés jusqu’à 10 minutes d’inactivité. Si un client quitte brièvement le flux de réservation et revient dans ce délai, il reprendra exactement là où il s’était arrêté, offrant une expérience de réservation plus fluide et réduisant les risques d’abandon.

Tarification et disponibilité

L’accès à Immersive Experience 2.0 dépend de ton abonnement Cloudbeds. Si les Intégrations premium sont incluses dans ton forfait, tu peux accéder à Immersive Experience 2.0 depuis la section Premium de l’onglet Intégrations.

Si les Intégrations premium ne sont pas incluses dans ton forfait, la section Premium peut afficher une option Contacter les ventes. Clique sur Contacter les ventes pour demander plus d’informations sur la mise à niveau vers un forfait incluant les Intégrations premium.

 Les Intégrations premium incluent Immersive Experience 2.0 et les solutions associées de composants web. Les Intégrations de base restent disponibles pour des implémentations plus simples basées sur des widgets.

Méthodes de paiement personnalisées et prise en charge des passerelles

  • Recommandations pour le support des passerelles : Nous ne recommandons pas d’utiliser des passerelles de paiement non prises en charge dans Immersive Experience. Une fois que les passerelles ne sont plus sur un domaine Cloudbeds, nous n’avons aucun contrôle sur la sécurité ni la conformité PCI.
  • Limitations actuelles : Les modes de paiement personnalisés doivent être utilisés uniquement dans des environnements hébergés pour le moment.
  • Support futur : L’équipe Cloudbeds Payments travaille à fournir un support officiel pour ces passerelles via des connexions personnalisées dans l’interface utilisateur du PMS. Cette fonctionnalité est prévue pour une sortie en 2026. Les clients recevront des informations plus précises sur le calendrier à l’approche de la date de livraison.
  • Voie de support : Pour des conseils spécifiques à la mise en œuvre ou des questions concernant les modes de paiement personnalisés, contacte directement notre équipe Cloudbeds Payments. Ils gèrent l’ensemble du SDK de paiements et sont les mieux placés pour t’aider.

Installer Immersive Experience 2.0

Complète la configuration ci-dessous pour autoriser le domaine de ton site web, charger le script Immersive Experience supporté, et ajouter le composant moteur de réservation à ton site. Ces étapes s’appliquent aussi bien à l’implémentation en pleine page qu’au bouton Réserver maintenant.

 Toute valeur affichée comme {PARAMETER} est un espace réservé. Remplace-la par ta valeur réelle et supprime les accolades.

 Ne place pas les balises du composant web Immersive Experience 2.0 à l’intérieur d’une iframe. Cela peut causer des problèmes de défilement et nécessiterait d’autoriser chaque élément dans la chaîne d’iframe, ce qui n’est pas recommandé.

Étape 1 : Confirmer l’accès aux Intégrations premium

 Important : L’accès aux Intégrations premium dépend de ton abonnement Cloudbeds.

  • Si les Intégrations premium sont incluses dans ton forfait, tu peux accéder aux options Immersive Experience 2.0 depuis moteur de réservation > Intégrations > Premium.
  • Si les Intégrations premium ne sont pas incluses dans ton forfait, la section Premium peut afficher une option Contacter les ventes. Clique sur Contacter les ventes pour demander plus d’informations sur la mise à niveau vers un forfait incluant les Intégrations premium.
  • Si tu es client de Cloudbeds Websites, tu peux contacter l’équipe Cloudbeds Websites pour obtenir des conseils sur la mise en œuvre et les demandes d’activation.

Étape 2 : Ajoute ton domaine aux domaines autorisés

Ajoute le domaine où tu vas installer Immersive Experience 2.0 dans la section Domaines autorisés de l’Intégration premium sélectionnée. Tu peux ajouter jusqu’à 5 domaines.

  1. Depuis ton Menu Compte Account Menu.jpg, sélectionne Paramètres Settings icon.png
  2. Clique sur moteur de réservation Booking Engine icon.png
  3. Clique sur l’onglet Intégrations.
  4. Dans la section Premium, sélectionne l’option Immersive Experience que tu souhaites installer.
  5. Dans la carte Domaines autorisés, clique sur Ajouter un domaine.
  6. Saisis le domaine où Immersive Experience sera installé, puis enregistre tes modifications.

 Les domaines principaux comme les sous-domaines sont pris en charge, par exemple mon-hotel.com et reservation.mon-hotel.com.

Onglet Intégrations du moteur de réservation montrant la section Premium et la carte Domaines autorisés utilisée pour ajouter un domaine de site web autorisé

 Domaines en liste d’autorisation : comment vérifier le format correct du domaine

Parfois, le domaine d’un site web peut être configuré de manière à nécessiter l’inclusion du www. Pour couvrir les deux possibilités, vérifie le format de domaine utilisé par ton site avant de l’ajouter.

  1. Ouvre ton site web et regarde l’URL dans ton navigateur.
  2. Vérifie si l’URL inclut www. Par exemple, elle peut afficher https://www.tondomaine.com ou https://tondomaine.com.

Une fois que tu sais quel format ton site utilise, saisis le domaine correspondant dans le champ Domaines en liste d’autorisation. Par exemple, si ton site s’affiche avec www, ajoute ton domaine en liste d’autorisation sous la forme www.tondomaine.com.

 Pourquoi les domaines doivent être en liste d’autorisation

L’Expérience Immersive est un composant web, pas une iframe. Elle s’exécute sur ton site et effectue des requêtes API vers les services Cloudbeds depuis ton domaine. La mise en liste d’autorisation indique à Cloudbeds quels origines sont autorisées afin que ces requêtes inter-domaines soient acceptées.

Étape 3 : Ajouter le script de l’Expérience Immersive

Ajoute le script suivant dans l’élément <head> du document HTML de ton site :

<script
  data-entry="immersive"
  src="https://static1.cloudbeds.com/booking-engine/latest/loader.js"
  nonce="+imGC13HmyB6zTZ1eTnZMw=="
  integrity="sha384-hd98w88pqnDT+lRLwyII/mRmbacols+VWYZF3HKdxnIlTYO+cF38GA1/I/+V8U4a"
  crossorigin="anonymous"
  type="text/plain"
  data-categories="essential"
></script>

 Si ton site utilise une plateforme de gestion du consentement (CMP), complète la configuration CMP avant de publier la mise en œuvre. Les exigences CMP varient selon le fournisseur.

Étape 4 : Intégrer le moteur de réservation

Tu peux afficher l’Expérience Immersive de deux façons :

  • Mode standard (intégration pleine page) : Aussi appelé « intégration pleine page », c’est le mode par défaut où l’application du moteur de réservation est entièrement intégrée dans le site hôte. Pour l’intégrer, inclue le fragment suivant dans le HTML à l’endroit où il doit s’afficher :
<cb-immersive-experience mode="standard" property-code="{PROPERTY_CODE}" />
  • Mode popup (bouton Réserver maintenant) : Ce mode affiche l’application du moteur de réservation sous forme de popup avec une position fixe et une superposition. Pour ajouter un bouton Réserver maintenant qui ouvre l’Expérience Immersive dans une popup :
<cb-book-now-button property-code="{PROPERTY_CODE}" />

  Si tu omets l’attribut mode, le composant utilise par défaut le mode standard.

 Trouve ton code établissement

Va dans le menu Compte > paramètres > moteur de réservation > l’onglet Résumé. Ton code est la valeur alphanumérique de 6 caractères à la fin du lien de ton moteur de réservation :

https://hotels.cloudbeds.com/reservation/{PROPERTY_CODE}

Dans l’exemple ci-dessous, la partie surlignée est le code établissement que tu dois utiliser dans ton intégration (remplace les accolades et la valeur dans ton extrait).

Onglet Résumé du moteur de réservation montrant le code établissement à la fin du lien de réservation du moteur de réservation

Si ton site web utilise une plateforme de gestion du consentement (CMP), configure l’expérience immersive pour que les ressources Cloudbeds nécessaires soient considérées comme essentielles et ne soient pas bloquées avant le chargement du processus de réservation. Suis la configuration spécifique à ton fournisseur avant de publier les modifications du site.

Utilise le paramètre spécifique au fournisseur qui correspond à ton CMP :

  • Cookiebot : data-cookieconsent="ignore"
  • OneTrust : data-ignore-consent="true"
  • Quantcast : data-quantcast-ignore="true"
  • Termly : ajoute la carte de blocage personnalisée ci-dessous avant le script Termly, de préférence près du début du HTML.
<script data-termly-config>
 window.TERMLY_CUSTOM_BLOCKING_MAP = {
  "cloudbeds.com": "essential",
  "clientstream.launchdarkly.com": "essential",
  "clientsdk.launchdarkly.com": "essential",
  "tile.openstreetmap.org": "essential",
  "tokenex.com": "essential",
  "stripe.com": "essential",
  "stripe.network": "essential",
  "braintreegateway.com": "essential",
  "dlocal.com": "essential",
  "authorize.net": "essential",
  "pagosonline.net": "essential",
  "paypal.com": "essential",
  "adyen.com": "essential"
 };
</script>

Classe le chargeur de l’expérience immersive comme nécessaire ou essentiel dans la configuration de ton CMP. Utilise le point d’entrée actuel du chargeur ci-dessous. L’utilisation directe de cb-immersive-experience.js est obsolète.

<script
  data-entry="immersive"
  src="https://static1.cloudbeds.com/booking-engine/latest/loader.js"
  nonce="+imGC13HmyB6zTZ1eTnZMw=="
  integrity="sha384-hd98w88pqnDT+lRLwyII/mRmbacols+VWYZF3HKdxnIlTYO+cF38GA1/I/+V8U4a"
  crossorigin="anonymous"
  type="text/plain"
  data-categories="essential"
></script>

 Accepter le consentement ne débloque pas un script qui a déjà tenté de se charger. Après avoir accepté le consentement, les clients doivent actualiser la page pour que les ressources de map, image et paiement précédemment bloquées apparaissent.

Considérations de configuration et dépannage

Les sections ci-dessous mettent en avant des comportements et des détails de mise en œuvre utiles à connaître avant la mise en production.

Compatibilité avec les créateurs de sites

  L’Expérience immersive a été testée avec des sites web créés sur mesure. Les créateurs de sites basés sur des modèles ou sans code peuvent gérer les scripts personnalisés différemment, ce qui pourrait affecter la fonctionnalité.

  • Injection dans le head : Vérifie que tu peux ajouter le <script> de l’Expérience immersive dans la balise <head> de la page.
  • Liste d’autorisation : Assure-toi que tes domaines en production (et ceux de prévisualisation/staging) sont ajoutés dans la carte Domaines en liste d’autorisation pour que les requêtes API soient acceptées. Tu peux ajouter jusqu’à 5 domaines.
  • CSS/JS personnalisé : Les styles ou scripts ajoutés dans la section de personnalisation du moteur de réservation ne s’appliquent pas automatiquement à l’Expérience immersive ; ajoute-les directement dans le HTML de ton site.
  • Page de paiement : L’étape de paiement peut varier selon le mode de paiement sélectionné.
  • Si le client choisit Apple Pay, Google Pay ou une autre option de paiement tierce, il sera redirigé vers la page tierce correspondante pour finaliser le paiement.
  • Une fois la transaction réussie, il sera redirigé vers la page de confirmation de l’Expérience immersive.
  • Liens profonds et paramètres : Les paramètres de recherche sont lus uniquement au chargement initial. Si tu modifies l’URL après le chargement de l’app, recharge la page pour les appliquer.

Portails

Le moteur de réservation affiche plusieurs éléments en position fixe à l'écran, par exemple :

  • Fenêtres modales
  • Info-bulles
  • Calendrier
  • Vérificateur de tarifs
  • Bannière du panier d'achat (sur mobile)
  • Sélecteurs de langue et de devise

Ces éléments sont affichés à l'intérieur d’un portail, ce qui signifie qu’au lieu de suivre la structure de l’arbre DOM, ils sont enveloppés par un élément avec la classe statique .cb-portal et ajoutés à la fin du body. Les portails ont différentes valeurs de z-index selon la couche correspondante dans notre contexte d’empilement.

La plupart des sites web ont eux-mêmes des contextes d’empilement, et selon la façon dont ils sont définis sur l’axe z imaginaire, ils peuvent entrer en conflit ou non avec les contextes d’empilement de l’expérience immersive.

Par exemple, s’ils ne sont pas correctement définis, le vérificateur de tarifs de l’expérience immersive pourrait s’afficher au-dessus du menu de navigation mobile appartenant au site de l’établissement, ou un élément flottant du site de l’établissement pourrait apparaître au-dessus du bouton « Réserver maintenant » dans la bannière du panier d’achat sur mobile, le bloquant ainsi et empêchant l’utilisateur de poursuivre le processus de réservation.

À l’heure actuelle, nous avons 4 types de portails : modal, popover, sticky et tooltip. Le type de portail utilisé dans chaque cas dépend du type d’élément concerné. Ainsi, toutes les fenêtres modales utiliseront un portail modal, le calendrier popover et les sélecteurs de langue et de devise utilisent un portail popover, tandis que la bannière du panier d’achat sur mobile et le vérificateur de tarifs utilisent un portail sticky, pour ne citer que quelques exemples.

Selon le type de portail, voici les valeurs que l’expérience immersive utilise pour la propriété CSS z-index :

  • Modal : 1400
  • Popover : 1500
  • Sticky : 1100
  • Tooltip : 1800

Résolution des problèmes de chevauchement

Lorsque tu rencontres des problèmes avec des éléments affichés par l’expérience immersive qui chevauchent d’autres éléments du site parent, nous te recommandons de chercher le portail (élément avec la classe statique .cb-portal) qui le contient et d’ajuster la valeur de z-index en conséquence, ou d’ajuster la valeur de z-index de l’élément du site parent.

Les valeurs de z-index pour les différents types de portails rendus par l'Expérience Immersive seront personnalisables simplement en redéfinissant les variables CSS utilisées à cet effet, comme montré dans l'exemple ci-dessous :

<style>
/* Portée à la racine du moteur de réservation lors de la redéfinition */
.cb-bookingengine-root {
  --booking-engine-zIndices-sticky: 1100;
  --booking-engine-zIndices-modal: 1400;
  --booking-engine-zIndices-popover: 1500;
  --booking-engine-zIndices-tooltip: 1800;
}
</style>

 Le vérificateur de tarifs est inclus dans tous les forfaits Cloudbeds Booking Engine sauf les plans hérités. Les établissements avec des forfaits actifs peuvent l’activer sans coût supplémentaire.

 

Paramètres de recherche et suivi

Immersive Experience peut lire les paramètres de recherche pris en charge lors du chargement initial de l’application et peut fonctionner avec les outils d’analytique et de publicité basés sur le site web. Utilise les sections de référence ci-dessous lorsque tu as besoin de transmettre des valeurs de recherche, configurer le suivi ou comprendre les paramètres de Google Hotel Ads.

Paramètres de recherche

L'expérience immersive prend en charge les mêmes paramètres de recherche que la version hébergée. Les paramètres sont lus uniquement au chargement initial et ne se mettent pas à jour dynamiquement.

Nom Type Description Exemple
adults Nombre Le nombre d’adultes pour la réservation, utilisé lors de la recherche d’hébergements disponibles. adults=2
allotment_block_code Chaîne de caractères Le code du bloc de contingent à utiliser pour récupérer les hébergements pour les dates sélectionnées. allotment_block_code=b123456
checkin AAAA-MM-JJ La date sélectionnée pour le check-in. checkin=2025-12-01
checkout AAAA-MM-JJ La date sélectionnée pour le check-out. Si checkin est fourni mais pas checkout, la date par défaut est le lendemain. checkout=2025-12-01
currency Code devise ISO-4217 à 3 lettres Devise sélectionnée. Si aucune n’est fournie, le moteur de réservation utilise la devise par défaut de l’établissement. currency=brl
enfants Nombre Le nombre d'enfants pour la réservation, utilisé lors de la recherche d’hébergements disponibles. enfants=1
promo Chaîne de caractères Code promo à utiliser lors de la récupération des hébergements pour les dates sélectionnées. promo=superpromo
rate_plan Chaîne de caractères séparée par des points-virgules Pour filtrer les résultats d’hébergement selon les plans tarifaires, correspond au « Nom du plan tarifaire privé » dans le PMS. rate_plan=3DAYSTAY;LOWSEASON
rid Chaîne numérique séparée par des points-virgules Liste des ID de chambres pour filtrer les résultats d’hébergement. rid=27434;23421
room_type Chaîne de 3 lettres séparées par des points-virgules Correspond à l’« Abréviation d’hébergement » dans le PMS et sert à filtrer les résultats d’hébergement. Si aucun check-in et check-out ne sont fournis, le moteur de réservation sélectionne automatiquement demain et le jour suivant. room_type=PRI;SHA
utm_source Chaîne de caractères Utilisé pour connaître la source de la campagne marketing (ex : Google, TripAdvisor, Trivago) utm_source=Google

Suivi et analytique

L’Expérience immersive prend en charge les mêmes paramètres de recherche que la version hébergée. Ces paramètres sont lus depuis l’emplacement de la fenêtre uniquement lors du chargement initial de l’Application, ce qui signifie que les modifications dynamiques des paramètres de recherche n’auront aucun impact sur l’Expérience immersive une fois celle-ci chargée.

De plus, l’Expérience immersive ne met pas à jour l’URL de la fenêtre comme le fait la version hébergée après certaines actions de l’utilisateur (par exemple, la sélection des dates d’arrivée et de départ).

  • Google Analytics 4 / GTM : L’ID de balise Google ou l’ID du conteneur GTM doit être initialisé sur le Site web de l’établissement.
  • Google Ads : Le suivi des conversions nécessite une configuration manuelle sur le Site web de l’établissement.
  • Meta Pixel : Le script Meta Pixel doit être ajouté dans la balise HTML <head> pour l’initialisation.

Pour plus de détails sur la configuration, consulte la documentation de chaque plateforme de suivi.

Ajoute manuellement les scripts Google Tag Manager (GTM) ou Google Analytics 4 (GA4) dans la balise <head> de ton HTML pour activer le suivi.

Paramètres de recherche Google Hotel Ads

Ces paramètres sont ajoutés par Google Hotel Ads et le moteur de réservation les envoie au serveur dans la requête lors d’une réservation :

Paramètre
gha_advance_booking_window
gha_campaign_id
gha_google_site
gha_is_ad_click
gha_is_click_type_hotel
gha_is_click_type_room
gha_is_hotel_campaign
gha_is_promoted
gha_length
gha_payment_id
gha_price_displayed_total
gha_promo_code
gha_user_country
gha_user_currency
gha_user_device
gha_user_language
gha_user_list_id

Personnalise Immersive Experience 2.0

Adapte Immersive Experience en utilisant les attributs des composants, ainsi que ton propre CSS/JS sur ton site web.

 Les codes personnalisés peuvent nécessiter un entretien au fil du temps

  • Au fur et à mesure que le moteur de réservation évolue, les personnalisations appliquées par toi-même peuvent cesser de fonctionner ou nécessiter des mises à jour.
  • Dans la mesure du possible, teste les modifications sur une copie de test ou de brouillon de ton site avant de les mettre en ligne.

Attributs des composants pour cb-immersive-experience et cb-book-now-button

Ces attributs sont partagés par les modes standard et fenêtre contextuelle (voir Intégrer le moteur de réservation).

Les attributs suivants sont tous facultatifs (sauf le property-code) et sont pris en charge à la fois par les composants web cb-immersive-experience et cb-book-now-button.

Nom Type Obligatoire Valeur par défaut Description
devise (*) Code devise ISO-4217 à 3 lettres Non Devise par défaut de l’établissement La devise utilisée pour le chargement initial de l’expérience immersive.
disable-css-title-reset yes | no Non no yes doit être utilisé si l’établissement souhaite définir ses propres règles CSS pour les titres dans l’interface (h1… h6).
hide-custom-header yes | no Non no Pour masquer l’en-tête personnalisé défini dans le PMS.
hide-custom-footer yes | no Non no Pour masquer le pied de page personnalisé défini dans le PMS.
masquer-info-établissement oui | non Non non Pour masquer la section Info Établissement sur toutes les pages.
ignorer-paramètres-recherche (*) oui | non Non non Par défaut, l’Expérience Immersive lit les paramètres de requête dans l’URL du site web hôte et les utilise lors du chargement initial de l’application. Elle supporte les mêmes paramètres que le moteur de réservation hébergé.
lang (*) détection-auto | code langue ISO 639-1 à 2 lettres Non Langue par défaut de l’établissement. La langue à utiliser lors du chargement initial de l’Expérience Immersive. Si aucune n’est fournie, l’Expérience Immersive vérifiera l’attribut lang du HTML ; s’il n’est pas défini non plus, la langue par défaut de l’établissement sera utilisée. Si la valeur détection-auto est fournie, l’Expérience Immersive se chargera dans la langue du navigateur de l’utilisateur.
mode standard | fenêtre contextuelle Non standard Le mode dans lequel l’Expérience Immersive doit être affichée. Le mode fenêtre contextuelle doit être utilisé lorsque l’Expérience Immersive est affichée dans un conteneur avec une hauteur fixe ou une hauteur maximale.
code-établissement (*) Code alphanumérique de 6 caractères qui identifie ton établissement. Oui Sans objet Le code alphanumérique de 6 caractères qui représente l’établissement. C’est le même code utilisé dans l’URL du moteur de réservation : https://hotels.cloudbeds.com/reservation/{PROPERTY_CODE}.

  Les attributs marqués pour le chargement initial sont lus une seule fois au démarrage de l’application. Les modifier ensuite dans ton établissement n’affectera pas une expérience immersive déjà chargée.

Attributs personnalisés du bouton Réserver maintenant

Ces options s’appliquent au composant cb-book-now-button (voir la section Intégrer le moteur de réservation) et te permettent de styliser le bouton ainsi que de contrôler le libellé et les dimensions de la fenêtre contextuelle.

Attribut Description
class-name Classe CSS pour styliser le bouton.
close-label Libellé personnalisé pour le bouton de fermeture.
height Hauteur de la fenêtre contextuelle.
width Largeur de la fenêtre contextuelle.

Exemple du bouton Réserver maintenant avec libellé, taille et classe CSS :

<cb-book-now-button
  property-code="{PROPERTY_CODE}"
  class-name="cb-book-now-button"
  label="Réserver maintenant"
  height="90vh"
  width="90vw"
/>

Ajouter du CSS et du JavaScript personnalisés pour l’expérience immersive

Le CSS ou JavaScript personnalisé ajouté dans les champs de personnalisation du moteur de réservation ne s’applique pas automatiquement à l’expérience immersive. Ils doivent être ajoutés manuellement au document HTML.

Ajoute l’attribut data-cb-immersive-experience-root aux balises style et script pour éviter les conflits.

Exemple de CSS personnalisé :

<style data-cb-immersive-experience-root>
  :is(#cb-bookingengine, .cb-bookingengine-root) {
    h1 {
      font-family: serif;
      font-size: 24px;
    }
  }
</style>

Prochaine étape

Après avoir installé et testé Immersive Experience 2.0 sur ton domaine autorisé, consulte le guide de l’onglet Intégrations du Cloudbeds Booking Engine lorsque tu dois comparer ou configurer d’autres options d’intégration.

Cet article vous a-t-il été utile ?
Utilisateurs qui ont trouvé cela utile : 0 sur 0

Commentaires

0 commentaire

Vous devez vous connecter pour laisser un commentaire.