| 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
- Installer Immersive Experience 2.0
- Consentement aux cookies et configuration CMP
- Considérations de configuration et dépannage
- Paramètres de recherche et suivi
- Personnaliser Immersive Experience 2.0
À 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.
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é.
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.
- 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.
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.
- Depuis ton Menu Compte
, sélectionne Paramètres
- Clique sur moteur de réservation
- Clique sur l’onglet Intégrations.
- Dans la section Premium, sélectionne l’option Immersive Experience que tu souhaites installer.
- Dans la carte Domaines autorisés, clique sur Ajouter un domaine.
- 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.
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.
- Ouvre ton site web et regarde l’URL dans ton navigateur.
- 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).
Consentement aux cookies et configuration du CMP
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.
Commentaires
Vous devez vous connecter pour laisser un commentaire.