Cloudbeds Booking Engine Immersive Experience 2.0 einrichten und anpassen

Zweck Einrichten, Einbetten und Pflegen der Cloudbeds Booking Engine Immersive Experience 2.0 auf der Website Ihrer Unterkunft.
Am besten geeignet für Administratoren, Manager, Inhaber der Unterkunft sowie den für die Implementierung verantwortlichen Website-Entwickler.
Verwendung Wenn Sie Immersive Experience 2.0 auf der Website Ihrer Unterkunft installieren, konfigurieren, anpassen oder Fehler beheben möchten.
Voraussetzungen Zugang zu Premium-Einbettungen, Ihre Website-Domain, Ihr Unterkunftscode und Zugriff auf den HTML-Code Ihrer Website.
Erwartetes Ergebnis Immersive Experience 2.0 wird auf einer autorisierten Unterkunfts-Website mit dem unterstützten Loader und dem ausgewählten Einbettungsmodus geladen.
Beschränkungen Vorlagenbasierte oder No-Code-Website-Builder können benutzerdefinierte Skripte unterschiedlich handhaben. Platzieren Sie die Webkomponenten-Tags von Immersive Experience 2.0 nicht innerhalb von iframes.

Einführung

Die Cloudbeds Booking Engine Immersive Experience 2.0 bettet den Buchungsprozess direkt in die Website Ihrer Unterkunft ein, ohne iframe-basierte Maskierung zu verwenden. Ihre Website muss über eine Zulassungsliste autorisiert sein, und das unterstützte Loader-Skript muss im HTML der Website installiert sein, bevor die Webkomponente gerendert werden kann.

Verwenden Sie diese Anleitung für die Implementierung selbst sowie für technische Überlegungen, die den Buchungsablauf beeinflussen können, einschließlich Consent Management Platforms (CMPs), Website-Builder, Tracking, Suchparameter und benutzerdefinierte Gestaltung. Für einen allgemeinen Überblick über die Buchungsmaschine siehe Cloudbeds Buchungsmaschine: Alles, was Sie wissen müssen.

Inhaltsverzeichnis

Über Immersive Experience 2.0

Die Cloudbeds Buchungsmaschine Immersive Experience 2.0 ist eine webbasierte Komponente, mit der Gäste die Verfügbarkeit suchen, Zimmer und Raten auswählen, Gästedaten eingeben und die Zahlung direkt über die Website Ihrer Unterkunft abschließen können. Sie kann als Vollseiten-Erlebnis implementiert oder über einen Jetzt buchen-Button geöffnet werden.

Wesentliche Vorteile

Die Immersive Experience 2.0 bietet einzigartige Funktionen, die das Buchungserlebnis Ihrer Gäste auf Ihrer eigenen Website verbessern:

  • Höhere Konversionsraten: Weniger Klicks, schnellere Ladezeiten und ein einheitliches Markenerlebnis führen zu mehr Buchungen.
  • Mehr Anpassungsmöglichkeiten: Gestalten Sie ein einzigartiges und unvergessliches Gästeerlebnis ohne die Einschränkungen eines Standard-iframes.
  • Datengetriebenes Wachstum: Greifen Sie auf wichtige Kennzahlen und Einblicke zu, um Ihren Buchungsprozess zu optimieren und Direktbuchungen zu steigern.
  • Mehr Vertrauen: Der sichere, nahtlose Buchungsablauf stärkt das Vertrauen der Gäste und motiviert sie, die Reservierung abzuschließen.

Webbasierte vs. iframe-basierte Komponenten

Im Gegensatz zu iframe-basierten Systemen bietet diese integrierte webbasierte Komponente:

  • Schnellere Ladezeiten der Website
  • Erweiterte Markenanpassung
  • Einheitlicher Buchungsablauf, der sicherstellt, dass Gäste von der ersten Suche bis zum Abschluss der Zahlung auf der Website bleiben

So sieht es aus

Die Immersive Experience 2.0 bietet zwei flexible Einbettungsoptionen, die zum Design und Nutzerfluss der Website Ihrer Unterkunft passen. Sie können wählen, ob Sie eine Vollseiten-Immersive Experience einbetten oder eine Pop-up-Immersive Experience erstellen und einbetten möchten.

  • Das Full-Page-Embed funktioniert genau so, wie der Name sagt: Es platziert die komplette Buchungsmaschine direkt auf einer Seite deiner Website und bietet den Gästen eine durchgängige, vollständig immersive Buchungserfahrung von Anfang bis Ende.

Das Full-Page-Embed hält den Gast auf der Website der Unterkunft, während er verfügbare Zimmer sucht, Raten überprüft und seine Reservierung zusammenstellt.

Immersive Experience 2.0 Full-Page-Embed zeigt Suchergebnisse für Zimmer, Zimmer- und Ratenoptionen, Reservierungsübersicht und Jetzt buchen-Button

Während des Check-outs geben Gäste ihre Kontaktdaten, optionale Zusatzinformationen, weitere Gäste und Kommunikationspräferenzen ein, ohne den eingebetteten Buchungsprozess zu verlassen.

Immersive Experience 2.0 Gastinformationsschritt mit Feldern für Hauptgast, geschätzter Ankunftszeit, Zusatzinformationen, Option für weitere Gäste, Kommunikationspräferenzen und Reservierungsübersicht

Vor Abschluss der Buchung können Gäste die Check-in-, Check-out-, Stornierungs- und weitere Allgemeine Geschäftsbedingungen der Unterkunft überprüfen.

Immersive Experience 2.0 Modal für Allgemeine Geschäftsbedingungen mit Check-in- und Check-out-Richtlinien, Stornobedingungen, Bedingungen, Zustimmungs-Kontrollkästchen und Button zur Bestätigung und Abschluss der Buchung

  • Die Pop-up-Embed-Option bietet eine elegante und moderne Alternative. Wenn ein Gast auf den Button „Jetzt buchen“ klickt, schiebt sich ein Seitenpanel sanft vom Bildschirmrand herein und bietet eine kompakte, aber voll funktionsfähige Buchungserfahrung, ohne die aktuelle Seite zu verlassen.

Bei der Pop-up-Implementierung öffnet der Gast die Immersive Experience über den „Jetzt buchen“-Button der Unterkunft, während die ursprüngliche Website hinter dem Buchungsfenster sichtbar bleibt.

Website der Unterkunft mit Jetzt buchen-Button und Immersive Experience 2.0 als Pop-up-Buchungsfenster mit Datum, Gast, Promo-Code, Filter- und Suchsteuerung

Der Buchungsprozess umfasst:

  • Verfügbarkeitsuche
  • Zimmerauswahl
  • Ratenanzeige
  • Upselling-Möglichkeiten
  • Eingabe von Gastinformationen
  • Sichere Zahlungsabwicklung

 Innerhalb des Buchungsablaufs von Immersive Experience 2.0 (Pop-up und Vollbild) werden Suchdetails der Gäste, einschließlich Datumsangaben, Anzahl der Gäste, Aktionscodes, ausgewählte Zimmer und Fortschritt beim Check-out, bei bis zu 10 Minuten Inaktivität automatisch gespeichert. Wenn ein Gast den Buchungsablauf kurz verlässt und innerhalb dieses Zeitraums zurückkehrt, setzt er genau dort fort, wo er aufgehört hat. Dies sorgt für ein reibungsloseres Buchungserlebnis und reduziert potenzielle Abbrüche.

Preisgestaltung und Verfügbarkeit

Der Zugriff auf Immersive Experience 2.0 hängt von Ihrem Cloudbeds-Abonnement ab. Wenn Premium-Einbettungen in Ihrem Paket enthalten sind, können Sie Immersive Experience 2.0 im Premium-Bereich der Einbettungen-Registerkarte aufrufen.

Wenn Premium-Einbettungen nicht in Ihrem Paket enthalten sind, kann im Premium-Bereich die Option Vertrieb kontaktieren angezeigt werden. Klicken Sie auf Vertrieb kontaktieren, um weitere Informationen zum Upgrade auf ein Paket mit Premium-Einbettungen anzufordern.

 Premium-Einbettungen umfassen Immersive Experience 2.0 und zugehörige Webkomponentenlösungen. Einfache Einbettungen bleiben für einfachere Widget-basierte Implementierungen verfügbar.

Benutzerdefinierte Zahlungsmethoden und Gateway-Unterstützung

  • Empfehlungen zur Gateway-Unterstützung: Wir empfehlen nicht, nicht unterstützte Zahlungsgateways in der Immersive Experience zu verwenden. Sobald Gateways nicht mehr auf einer Cloudbeds-Domain liegen, haben wir keine Kontrolle über Sicherheit oder PCI-Konformität.
  • Aktuelle Einschränkungen: Benutzerdefinierte Zahlungsmethoden sollten derzeit nur in gehosteten Umgebungen verwendet werden.
  • Zukünftige Unterstützung: Das Cloudbeds Payments-Team arbeitet daran, offizielle Unterstützung für diese Gateways über benutzerdefinierte Verbindungen innerhalb der PMS-Benutzeroberfläche bereitzustellen. Dieses Feature ist für die Veröffentlichung im Jahr 2026 geplant. Kunden können mit genaueren Informationen zum Zeitpunkt der Veröffentlichung rechnen, sobald wir uns dem Lieferdatum nähern.
  • Support-Weg: Für implementierungsspezifische Anleitungen oder Fragen zu benutzerdefinierten Zahlungsmethoden wenden Sie sich bitte direkt an unser Cloudbeds Payments-Team. Dieses verwaltet das gesamte Payments-SDK und ist am besten geeignet, Ihnen zu helfen.

Immersive Experience 2.0 installieren

Schließen Sie die folgende Einrichtung ab, um Ihre Website-Domain zu autorisieren, das unterstützte Immersive Experience-Skript zu laden und die Komponente der Buchungsmaschine zu Ihrer Website hinzuzufügen. Die Schritte gelten sowohl für die Vollseiten- als auch für die Jetzt buchen-Button-Implementierungen.

 Jeder als {PARAMETER} angezeigte Wert ist ein Platzhalter. Ersetzen Sie ihn durch Ihren tatsächlichen Wert und entfernen Sie die geschweiften Klammern.

 Platzieren Sie die Webkomponenten-Tags der Immersive Experience 2.0 nicht innerhalb eines iframes. Dies kann zu Scrollproblemen führen und würde erfordern, dass jedes Element in der iframe-Kette auf die Zulassungsliste gesetzt wird, was nicht empfohlen wird.

Schritt 1: Premium-Einbettungen-Zugang bestätigen

 Wichtig: Der Zugriff auf Premium-Einbettungen hängt von Ihrem Cloudbeds-Abonnement ab.

  • Wenn Premium-Einbettungen in Ihrem Paket enthalten sind, können Sie die Optionen der Immersive Experience 2.0 unter Buchungsmaschine > Einbettungen > Premium aufrufen.
  • Sind Premium-Einbettungen nicht in Ihrem Paket enthalten, zeigt der Premium-Bereich möglicherweise eine Option Vertrieb kontaktieren an. Klicken Sie auf Vertrieb kontaktieren, um weitere Informationen zum Upgrade auf ein Paket mit Premium-Einbettungen anzufordern.
  • Wenn Sie Kunde von Cloudbeds Websites sind, können Sie sich an das Cloudbeds-Websites-Team wenden, um Unterstützung bei Implementierungs- und Aktivierungsanfragen zu erhalten.

Schritt 2: Fügen Sie Ihre Domain zu den zugelassenen Domains hinzu

Fügen Sie die Domain, auf der Sie die Immersive Experience 2.0 installieren möchten, im Abschnitt Zugelassene Domains der ausgewählten Premium-Einbettung hinzu. Sie können bis zu 5 Domains hinzufügen.

  1. Wählen Sie im Kontomenü Account Menu.jpg die Einstellungen Settings icon.png
  2. Klicken Sie auf Buchungsmaschine Booking Engine icon.png
  3. Klicken Sie auf die Registerkarte Einbettungen.
  4. Wählen Sie im Abschnitt Premium die Immersive Experience-Option aus, die Sie installieren möchten.
  5. Klicken Sie in der Karte Zugelassene Domains auf Domain hinzufügen.
  6. Geben Sie die Domain ein, auf der die Immersive Experience installiert wird, und speichern Sie Ihre Änderungen.

 Sowohl Hauptdomains als auch Subdomains werden unterstützt, zum Beispiel my-hotel.com und booking.my-hotel.com.

Registerkarte Einbettungen der Buchungsmaschine mit dem Abschnitt Premium und der Karte Zugelassene Domains zum Hinzufügen einer autorisierten Website-Domain

 Zugelassene Domains: So prüfen Sie das korrekte Domainformat

Manchmal ist eine Website-Domain so eingerichtet, dass das www enthalten sein muss. Um beide Möglichkeiten abzudecken, prüfen Sie vor dem Hinzufügen, welches Domainformat Ihre Website verwendet.

  1. Öffnen Sie Ihre Website und schauen Sie sich die URL in Ihrem Browser an.
  2. Prüfen Sie, ob die URL www enthält. Zum Beispiel könnte sie https://www.ihredomain.com oder https://ihredomain.com anzeigen.

Sobald Sie wissen, welches Format Ihre Seite verwendet, geben Sie die passende Domain im Feld Zugelassene Domains ein. Wenn Ihre Seite beispielsweise mit www angezeigt wird, fügen Sie Ihre Domain als www.ihredomain.com zur Zulassungsliste hinzu.

 Warum Domains zugelassen werden müssen

Die Immersive Experience ist eine Webkomponente, kein iframe. Sie läuft auf Ihrer Website und sendet API-Anfragen an Cloudbeds-Dienste von Ihrer Domain aus. Die Zulassung teilt Cloudbeds mit, welche Ursprünge autorisiert sind, damit diese domainübergreifenden Anfragen akzeptiert werden.

Schritt 3: Fügen Sie das Immersive Experience-Skript hinzu

Fügen Sie das folgende Skript in das <head>-Element des HTML-Dokuments Ihrer Website ein:

<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>

 Wenn Ihre Website eine Consent Management Platform (CMP) verwendet, schließen Sie die CMP-Einrichtung ab, bevor Sie die Implementierung veröffentlichen. Die Anforderungen der CMP variieren je nach Anbieter.

Schritt 4: Betten Sie die Buchungsmaschine ein

Sie können die Immersive Experience auf zwei Arten darstellen:

  • Standardmodus (Vollseiten-Einbettung): Auch bekannt als „Vollseiten-Einbettung“, ist dies der Standardmodus, bei dem die Buchungsmaschine vollständig in die Host-Website integriert ist. Um sie einzubetten, fügen Sie den folgenden Code-Schnipsel an der Stelle im HTML ein, an der sie angezeigt werden soll:
<cb-immersive-experience mode="standard" property-code="{PROPERTY_CODE}" />
  • Popup-Modus (Jetzt buchen-Button): In diesem Modus wird die Buchungsmaschine als Popup mit fester Position und Overlay dargestellt. Um einen Jetzt buchen-Button hinzuzufügen, der die Immersive Experience in einem Popup öffnet:
<cb-book-now-button property-code="{PROPERTY_CODE}" />

  Wenn Sie das Attribut mode weglassen, verwendet die Komponente standardmäßig den Wert standard.

 Finden Sie Ihren Property Code

Gehen Sie zum Kontomenü > Einstellungen > Buchungsmaschine > Registerkarte Zusammenfassung. Ihr Code ist der 6-stellige alphanumerische Wert am Ende Ihres Buchungsmaschinen-Links:

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

Im folgenden Beispiel ist der hervorgehobene Abschnitt der Property Code, den Sie in Ihrem Einbettungscode verwenden sollten (ersetzen Sie die geschweiften Klammern und den Wert in Ihrem Snippet).

Registerkarte Zusammenfassung der Buchungsmaschine mit dem Property Code am Ende des Buchungsmaschinen-Reservierungslinks

Wenn Ihre Website eine Consent Management Platform (CMP) verwendet, konfigurieren Sie die Immersive Experience so, dass die erforderlichen Cloudbeds-Ressourcen als essenziell behandelt werden und nicht blockiert sind, bevor der Buchungsablauf geladen werden kann. Befolgen Sie die anbieter-spezifische Einrichtung unten, bevor Sie die Website-Änderungen veröffentlichen.

Verwenden Sie die für Ihre CMP zutreffende anbieter-spezifische Einstellung:

  • Cookiebot: data-cookieconsent="ignore"
  • OneTrust: data-ignore-consent="true"
  • Quantcast: data-quantcast-ignore="true"
  • Termly: Fügen Sie die untenstehende benutzerdefinierte Blockierungskarte vor dem Termly-Skript ein, idealerweise nahe am Anfang des HTML-Codes.
<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>

Klassifizieren Sie den Immersive Experience Loader in Ihrer CMP-Konfiguration als notwendig oder essenziell. Verwenden Sie den aktuellen Loader-Einstiegspunkt unten. Die direkte Verwendung von cb-immersive-experience.js ist veraltet.

<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>

 Die Zustimmung zum Laden blockierter Skripte hebt nicht auf, wenn das Skript bereits versucht hat zu laden. Nach der Zustimmung müssen Gäste die Seite aktualisieren, damit zuvor blockierte Karten-, Bild- und Zahlungsressourcen angezeigt werden.

Einrichtungshinweise und Fehlerbehebung

Die folgenden Abschnitte heben Verhaltensweisen und Implementierungsdetails hervor, die vor dem Livegang hilfreich zu wissen sind.

Kompatibilität mit Website-Buildern

  Die Immersive Experience wurde mit individuell erstellten Websites getestet. Template- oder No-Code-Website-Builder können benutzerdefinierte Skripte anders handhaben, was die Funktionalität beeinträchtigen kann.

  • Head-Injektion: Stelle sicher, dass du das Immersive Experience <script> im Seiten-<head> hinzufügen kannst.
  • Zulassungsliste: Sorge dafür, dass deine Live-Domains (sowie alle Staging-/Vorschau-Domains) unter der Karte Zugelassene Domains eingetragen sind, damit API-Anfragen akzeptiert werden. Du kannst bis zu 5 Domains hinzufügen.
  • Benutzerdefiniertes CSS/JS: Styles oder Skripte, die im Anpassungsbereich der Buchungsmaschine hinzugefügt werden, gelten nicht automatisch für die Immersive Experience; füge sie stattdessen im HTML deiner Website ein.
  • Zahlungsseite: Der Zahlungsschritt kann je nach ausgewählter Zahlungsmethode variieren.
  • Wenn der Gast Apple Pay, Google Pay oder eine andere Zahlungsoption eines Drittanbieters wählt, wird er zur entsprechenden Drittanbieter-Seite weitergeleitet, um die Zahlung abzuschließen.
  • Nach erfolgreicher Transaktion wird der Gast zurück zur Bestätigungsseite der Immersive Experience geleitet.
  • Deep Links und Parameter: Suchparameter werden nur beim ersten Laden gelesen. Wenn du die URL nach dem Laden der App änderst, lade die Seite neu, damit die Änderungen wirksam werden.

Portal

Die Buchungsmaschine rendert mehrere Elemente in einer festen Position auf dem Bildschirm, zum Beispiel:

  • Modale Fenster
  • Tooltips
  • Kalender
  • Rate Checker
  • Banner des Warenkorbs (auf Mobilgeräten)
  • Sprach- und Währungsauswahlen

Diese Elemente werden innerhalb eines Portals gerendert, was bedeutet, dass sie anstatt der Struktur des DOM-Baums zu folgen, von einem Element mit der statischen Klasse .cb-portal umschlossen und ans Ende des Body angehängt werden. Die Portale haben unterschiedliche z-Index-Werte entsprechend der jeweiligen Ebene in unserem Stacking Context.

Die meisten Websites besitzen selbst Stacking Contexts, und je nachdem, wie diese auf der imaginären z-Achse definiert sind, können sie mit den Stacking Contexts der Immersive Experience in Konflikt geraten oder nicht.

Beispielsweise könnte bei einer nicht ordnungsgemäßen Definition der Rate Checker der Immersive Experience über dem mobilen Navigationsmenü der Unterkunfts-Website angezeigt werden, oder ein schwebendes Element auf der Unterkunfts-Website könnte über dem „Jetzt buchen“-Button im Warenkorb-Banner auf Mobilgeräten liegen, diesen blockieren und somit den Benutzer daran hindern, mit dem Reservierungsprozess fortzufahren.

Derzeit gibt es vier Arten von Portalen: modal, popover, sticky und tooltip. Die Art des verwendeten Portals hängt vom jeweiligen Elementtyp ab. So verwenden alle Modale Fenster ein modal-Portal, der Kalender-Popover sowie die Sprach- und Währungsauswahlen ein popover-Portal, während das Warenkorb-Banner auf Mobilgeräten und der Rate Checker ein sticky-Portal verwenden, um nur einige Beispiele zu nennen.

Je nach Portaltyp verwendet die Immersive Experience folgende Werte für die CSS-Eigenschaft z-index:

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

Fehlerbehebung bei Überlappungsproblemen

Wenn Probleme mit von der Immersive Experience gerenderten Elementen auftreten, die andere Elemente der übergeordneten Website überlappen, empfehlen wir, das Portal (Element mit der statischen Klasse .cb-portal), das das Element enthält, zu suchen und den z-index-Wert entsprechend anzupassen oder alternativ den z-index-Wert des Elements der übergeordneten Website zu verändern.

Die z-index-Werte für die verschiedenen Arten von Portalen, die von der Immersive Experience gerendert werden, können einfach durch Neudefinition der CSS-Variablen angepasst werden, die zu diesem Zweck verwendet werden, wie im folgenden Beispiel gezeigt:

<style>
/* Geltungsbereich auf die Buchungsmaschinen-Wurzel beim Überschreiben */
.cb-bookingengine-root {
  --booking-engine-zIndices-sticky: 1100;
  --booking-engine-zIndices-modal: 1400;
  --booking-engine-zIndices-popover: 1500;
  --booking-engine-zIndices-tooltip: 1800;
}
</style>

 Der Rate Checker ist in allen Cloudbeds Booking Engine-Paketen enthalten, außer in Legacy-Tarifen. Unterkünfte mit aktiven Paketen können ihn ohne zusätzliche Kosten aktivieren.

 

Suchparameter und Tracking

Immersive Experience kann unterstützte Suchparameter beim ersten Laden der Anwendung auslesen und mit webseitenbasierten Analyse- und Werbetools zusammenarbeiten. Verwenden Sie die untenstehenden Referenzabschnitte, wenn Sie Suchwerte übergeben, das Tracking konfigurieren oder die Parameter von Google Hotel Ads verstehen möchten.

Suchparameter

Die Immersive Experience unterstützt dieselben Suchparameter wie die gehostete Version. Die Parameter werden nur beim ersten Laden gelesen und nicht dynamisch aktualisiert.

Name Typ Beschreibung Beispiel
adults Zahl Die Anzahl der Erwachsenen für die Reservierung, verwendet bei der Suche nach verfügbaren Zimmern. adults=2
allotment_block_code Zeichenkette Der Kontingentblock-Code, der verwendet wird, um Zimmer für die ausgewählten Datumsangaben abzurufen. allotment_block_code=b123456
checkin JJJJ-MM-TT Das ausgewählte Datum für den Check-in. checkin=2025-12-01
checkout JJJJ-MM-TT Das ausgewählte Datum für den Check-out. Wenn checkin angegeben ist, aber checkout nicht, wird standardmäßig der nächste Tag verwendet. checkout=2025-12-01
currency 3-stelliger ISO-4217-Währungscode Ausgewählte Währung. Wenn keine angegeben ist, verwendet die Buchungsmaschine die Standardwährung der Unterkunft. currency=brl
Kinder Zahl Anzahl der Kinder für die Reservierung, verwendet bei der Suche nach verfügbaren Zimmern. kids=1
promo Text Aktionscode, der bei der Abfrage von Zimmern für ausgewählte Datumsangaben verwendet wird. promo=superpromo
rate_plan Durch Semikolon getrennte Zeichenkette Filtert die Zimmerergebnisse basierend auf den Ratenplänen, entspricht dem „Privaten Ratenplan-Namen“ im PMS. rate_plan=3DAYSTAY;LOWSEASON
rid Durch Semikolon getrennte numerische Zeichenkette Liste von Zimmer-IDs zur Filterung der Zimmerergebnisse. rid=27434;23421
room_type Durch Semikolon getrennte 3-Buchstaben-Zeichenkette Entspricht der „Zimmerabkürzung“ im PMS und wird verwendet, um die Zimmerergebnisse zu filtern. Wenn kein Check-in und Check-out angegeben sind, wählt die Buchungsmaschine automatisch morgen und den folgenden Tag aus. room_type=PRI;SHA
utm_source Text Wird verwendet, um die Quelle der Marketingkampagne zu erkennen (z. B. Google, TripAdvisor, Trivago). utm_source=Google

Tracking und Analysen

Die Immersive Experience unterstützt dieselben Suchparameter wie die gehostete Version. Die Parameter werden nur beim ersten Laden der Anwendung aus der Fenster-URL ausgelesen, was bedeutet, dass dynamische Änderungen der Suchparameter nach dem Laden der Immersive Experience keine Auswirkungen haben.

Außerdem aktualisiert die Immersive Experience die Fenster-URL nicht wie die gehostete Version nach bestimmten Benutzeraktionen (zum Beispiel bei der Auswahl von Check-in- und Check-out-Daten).

  • Google Analytics 4 / GTM: Die Google-Tag-ID oder der GTM-Container-ID muss auf der Website der Unterkunft initialisiert werden.
  • Google Ads: Das Conversion-Tracking erfordert eine manuelle Einrichtung auf der Website der Unterkunft.
  • Meta Pixel: Das Meta-Pixel-Skript muss im HTML-<head> zur Initialisierung hinzugefügt werden.

Für weitere Konfigurationsdetails konsultieren Sie bitte die Dokumentation der jeweiligen Tracking-Plattform.

Fügen Sie die Google Tag Manager (GTM)- oder Google Analytics 4 (GA4)-Skripte manuell in den <head>-Bereich Ihres HTML-Codes ein, um das Tracking zu aktivieren.

Suchparameter von Google Hotel Ads

Diese Parameter werden von Google Hotel Ads angehängt und die Buchungsmaschine sendet sie bei der Reservierungsanfrage an den Server:

Parameter
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

Immersive Experience 2.0 anpassen

Gestalten Sie die Immersive Experience mit Komponentenattributen sowie eigenem CSS/JS auf Ihrer Website individuell.

 Eigene Codes können mit der Zeit Wartung erfordern

  • Mit der Weiterentwicklung der Buchungsmaschine können selbst vorgenommene Anpassungen nicht mehr funktionieren oder Aktualisierungen benötigen.
  • Testen Sie Änderungen wann immer möglich auf einer Staging- oder Entwurfsversion Ihrer Website, bevor Sie live gehen.

Komponentenattribute für cb-immersive-experience und cb-book-now-button

Diese Attribute werden sowohl vom Standard- als auch vom Popup-Modus geteilt (siehe Einbetten der Buchungsmaschine).

Die folgenden Attribute sind alle optional (außer dem property-code) und werden von den Webkomponenten cb-immersive-experience und cb-book-now-button unterstützt.

Name Typ Erforderlich Standardwert Beschreibung
Währung (*) 3-stelliger ISO-4217-Währungscode Nein Standardwährung der Unterkunft Die Währung, die für den initialen Ladevorgang der Immersive Experience verwendet wird.
disable-css-title-reset ja | nein Nein nein ja sollte verwendet werden, wenn die Unterkunft eigene CSS-Regelsätze für Überschriften in der Benutzeroberfläche (h1… h6) definieren möchte.
hide-custom-header ja | nein Nein nein Um die benutzerdefinierte Kopfzeile auszublenden, die im PMS definiert ist.
hide-custom-footer ja | nein Nein nein Um die benutzerdefinierte Fußzeile auszublenden, die im PMS definiert ist.
hide-property-info ja | nein Nein nein Um den Abschnitt Unterkunftsinformationen auf allen Seiten auszublenden.
ignore-search-params (*) ja | nein Nein nein Die Immersive Experience liest standardmäßig die Abfrageparameter in der URL der Unterkunfts-Website und verwendet diese beim initialen Laden der Anwendung. Sie unterstützt dieselben Parameter wie die gehostete Buchungsmaschine.
lang (*) auto-detect | 2-stelliger ISO 639-1-Sprachcode Nein Standard-Sprache der Unterkunft. Die Sprache, die beim initialen Laden der Immersive Experience verwendet wird. Wenn keine angegeben ist, prüft die Immersive Experience das lang-Attribut des HTML-Dokuments. Ist auch dieses nicht definiert, wird die Standardsprache der Unterkunft verwendet. Wird der Wert auto-detect angegeben, wird die Immersive Experience in der Sprache des Browsers des Nutzers geladen.
mode standard | popup Nein standard Der Modus, in dem die Immersive Experience dargestellt werden soll. Ein Popup sollte verwendet werden, wenn die Immersive Experience in einem Container mit fester oder maximaler Höhe angezeigt wird.
property-code (*) 6-stelliger alphanumerischer Code, der Ihre Unterkunft identifiziert. Ja Nicht zutreffend Der 6-stellige alphanumerische Code, der die Unterkunft repräsentiert. Es ist derselbe Code, der in der URL der Buchungsmaschine verwendet wird: https://hotels.cloudbeds.com/reservation/{PROPERTY_CODE}.

  Attribute, die für den Initial-Ladevorgang markiert sind, werden nur einmal beim Start der App gelesen. Änderungen an diesen Attributen in Ihrer Unterkunft wirken sich nicht auf eine bereits geladene Immersive Experience aus.

Benutzerdefinierte Attribute für den Button „Jetzt buchen“

Diese Optionen gelten für die Komponente cb-book-now-button (siehe den Abschnitt Einbetten der Buchungsmaschine) und ermöglichen es Ihnen, den Button zu gestalten sowie die Bezeichnung und die Abmessungen des Pop-ups zu steuern.

Attribut Beschreibung
class-name CSS-Klasse zur Gestaltung des Buttons.
close-label Benutzerdefinierte Bezeichnung für den Schließen-Button.
height Höhe des Pop-ups.
width Breite des Pop-ups.

Beispiel für den Button „Jetzt buchen“ mit Bezeichnung, Größe und CSS-Klasse:

<cb-book-now-button
  property-code="{PROPERTY_CODE}"
  class-name="cb-book-now-button"
  label="Jetzt buchen"
  height="90vh"
  width="90vw"
/>

Benutzerdefiniertes CSS und JavaScript für die Immersive Experience hinzufügen

Benutzerdefiniertes CSS oder JavaScript, das in den Anpassungsfeldern der Buchungsmaschine hinzugefügt wird, wird nicht automatisch auf die Immersive Experience angewendet. Diese müssen manuell in das HTML-Dokument eingefügt werden.

Fügen Sie das Attribut data-cb-immersive-experience-root zu Style- und Script-Tags hinzu, um Konflikte zu vermeiden.

Beispiel für benutzerdefiniertes CSS:

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

Nächster operativer Schritt

Nachdem Sie Immersive Experience 2.0 auf Ihrer autorisierten Domain installiert und getestet haben, sehen Sie sich die Anleitung zur Registerkarte Einbettungen der Cloudbeds Booking Engine an, wenn Sie weitere Einbettungsoptionen vergleichen oder konfigurieren möchten.

War dieser Beitrag hilfreich?
0 von 0 fanden dies hilfreich

Kommentare

0 Kommentare

Bitte melden Sie sich an, um einen Kommentar zu hinterlassen.