Zum Hauptinhalt springen

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:

  1. Navigiere in der CASABLANCA Cloud zu Booking Engine > Spaces > Space Einstellungen.
  2. Trage die GA4 Mess-ID ein (Format: G-XXXXXXXXXX).
  3. Ergebnis: Das System fügt den Tracking-Code automatisch ein und aktiviert den DSGVO-Cookie-Banner im Frontend.

→ Siehe Einrichtung – Tracking

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.

EventAuslöserÜbermittelte Hauptparameter
view_item_listDer Nutzer sieht eine Liste von Angeboten bzw. Artikeln.event, commerce
add_to_cartDer Nutzer wählt ein Angebot oder fügt einen Artikel hinzu.event, commerce
remove_from_cartDer Nutzer entfernt ein Angebot oder einen Artikel.event, commerce
begin_checkoutDer Nutzer ruft die Checkout-Seite auf.event, commerce
add_shipping_infoDer Nutzer sendet das Checkout-Formular erfolgreich ab.event, commerce
add_payment_infoDas Zahlungsfenster wird geöffnet (nur bei erforderlicher Direktzahlung).event, commerce
purchaseDer 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
}

→ Siehe Benutzerdefinierte Dimensionen (optional)

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.

ParameternameBereich (Scope)Beschreibung
arrival_dateItemDas Anreisedatum (ISO 8601).
departure_dateItemDas Abreisedatum (ISO 8601).
number_of_adultsItemDie Anzahl der Erwachsenen im Zimmer.
number_of_childrenItemDie 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:debugMode mit dem Wert enabled an und lade die Seite neu. Wenn es funktioniert, erscheint in der Entwicklerkonsole die Meldung [Analytics] Initializing GA4 in debug mode ....