GA4 Integration
Technische Spezifikation: Google Analytics 4 (GA4) Integration
- System: CASABLANCA Booking Engine und GA4
- Version: 2.0 (Consent-Mode-V2-konform)
- Stand: 2026
Überblick
Unsere Booking Engine bietet eine native „Plug-and-play“-Integration mit Google Analytics 4. Die technische Umsetzung von DataLayer, Event-Auslösung und DSGVO-Einwilligungsmanagement übernehmen wir automatisch.
So aktivierst du die Integration:
- Navigiere in der CASABLANCA Cloud zu Booking Engine > Spaces > Space Einstellungen.
- Trage die GA4 Mess-ID ein (Format:
G-XXXXXXXXXX). - Ergebnis: Das System fügt den Tracking-Code automatisch ein und aktiviert den DSGVO-Cookie-Banner im Frontend.
Datenschutz und Einwilligung (DSGVO)
Standardmäßig arbeiten wir im strikten Modus (Standard in Österreich und der EU).
- Consent Mode V2: Vollständig umgesetzt.
- Aktivierung: Das GA4-Skript und die Cookies sind blockiert, bis der Nutzer im Cookie-Banner ausdrücklich auf „Akzeptieren“ klickt.
- Signal-Aktivierung: Nach der Zustimmung lösen wir
gtag('consent', 'default', { ...granted... })aus und laden die Bibliothek.
E-Commerce-Events
A. Funnel-Events
Wir verfolgen den Weg des Nutzers vom Ansehen eines Zimmers bis zum Kauf.
| Event | Auslöser | Übermittelte Hauptparameter |
|---|---|---|
view_item_list | Der Nutzer sieht eine Liste von Angeboten bzw. Artikeln. | event, commerce |
add_to_cart | Der Nutzer wählt ein Angebot oder fügt einen Artikel hinzu. | event, commerce |
remove_from_cart | Der Nutzer entfernt ein Angebot oder einen Artikel. | event, commerce |
begin_checkout | Der Nutzer ruft die Checkout-Seite auf. | event, commerce |
add_shipping_info | Der Nutzer sendet das Checkout-Formular erfolgreich ab. | event, commerce |
add_payment_info | Das Zahlungsfenster wird geöffnet (nur bei erforderlicher Direktzahlung). | event, commerce |
purchase | Der Nutzer schließt die Buchung ab. | event, commerce |
B. Struktur der Item-Daten
Die Items haben folgende Objektstruktur:
Aufenthalt (Stay)
{
"item_id": "pms_123_pms_abc", // {roomTypeId}_{rateId}
"item_name": "Doppelzimmer (Halbpension)", // {roomTypeName} ({rateName})
"item_category": "Stay",
"item_category2": "pms_123", // {roomTypeId}
"item_category3": "pms_abc", // {rateId}
"price": 150.00, // Preis pro Nacht
"quantity": 3, // Anzahl der Nächte
// benutzerdefinierte Dimensionen
"arrival_date": "2026-02-01",
"departure_date": "2026-02-08",
"number_of_adults": 2,
"number_of_children": 0
}
Zusatzleistung (AddOn)
{
"item_id": "9a762d48-3be1-4eb3-b9ad-e8486824ad9c", // {upsellingArticleId}
"item_name": "Rückenmassage", // {upsellingArticleName}
"item_category": "AddOn",
"price": 50.00, // Preis pro Einheit
"quantity": 1 // Anzahl der Einheiten
}
Reiseversicherung (TravelInsurance)
{
"item_id": "HOSPL", // {travelInsuranceCode}
"item_name": "Hotelstorno Plus", // {travelInsuranceName}
"item_category": "TravelInsurance",
"price": 50.00, // Gesamtprämie
"quantity": 1 // immer 1
}
Benutzerdefinierte Dimensionen (optional)
Wir ergänzen das item vom Typ Stay um zusätzlichen Buchungskontext. Damit du diese Angaben in deinen GA4-Berichten siehst, musst du sie in den Einstellungen deiner GA4-Property als benutzerdefinierte Dimensionen (Custom Dimensions) registrieren.
| Parametername | Bereich (Scope) | Beschreibung |
|---|---|---|
arrival_date | Item | Das Anreisedatum (ISO 8601). |
departure_date | Item | Das Abreisedatum (ISO 8601). |
number_of_adults | Item | Die Anzahl der Erwachsenen im Zimmer. |
number_of_children | Item | Die Anzahl der Kinder im Zimmer. |
Häufige Fragen
Wie verhindere ich, dass die Sitzung nach der Zahlung abbricht?
- Stelle sicher, dass die „Referral Exclusion List“ in GA4 die Domains des Payment Gateways enthält. Dann bricht die Sitzung bei der Rückkehr von der Zahlung nicht ab.
Gibt es einen Debug-Modus?
- Ja. Lege im Local Storage des Browsers den Schlüssel
ga4:debugModemit dem Wertenabledan und lade die Seite neu. Wenn es funktioniert, erscheint in der Entwicklerkonsole die Meldung[Analytics] Initializing GA4 in debug mode ....