Zum Hauptinhalt springen

Meta Integration

Technische Spezifikation: Meta Integration

  • System: CASABLANCA Booking Engine und Meta
  • Stand: 2026

Überblick​


Unsere Booking Engine bietet eine native „Plug-and-play“-Integration mit dem Meta Pixel und der Meta Conversion API (CAPI). Die technische Umsetzung der Event-Auslösung und das DSGVO-Einwilligungsmanagement übernehmen wir automatisch.

So aktivierst du die Integration:

  1. Öffne in der CASABLANCA Cloud Booking Engine > Spaces > Space Einstellungen.
  2. Trage die Meta Pixel ID und den Meta-CAPI-Zugriffstoken ein.
  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)​


  • Aktivierung: Das Meta-Pixel-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 fbq("consent", "grant") aus und laden die Bibliothek.

E-Commerce-Events​


Über die Conversion API senden wir folgende Events:

Funnel-Events​

EventAuslöserÜbermittelte Hauptparameter
InitiateCheckoutDer Nutzer ruft die Checkout-Seite auf.custom_data
PurchaseDer Nutzer schließt die Buchung ab.custom_data

Nutzerdaten wie client_user_agent, fbc und em werden ergänzt, wenn sie zum Zeitpunkt der Event-Auslösung verfügbar sind.

Struktur der Custom Data​

custom_data hat folgende Objektstruktur:

{
"currency": "EUR",
"value": "129.99",
"content_ids": ["{tenantId}"],
"contentType": "hotel"
}

Häufige Fragen für Agenturen​


Müssen wir den Google Tag Manager (GTM) einrichten?

  • Nein. Wir binden die fbevents.js direkt ein.

Kann ich den Cookie-Banner anpassen?

  • Den Text des Cookie-Banners kannst du nicht ändern, nur die Links. Du findest sie in der CASABLANCA Cloud unter Booking Engine > Spaces > Space Einstellungen > Links.

→ Siehe Formularfelder & Links

Wie funktioniert Cross-Domain-Tracking?

  • Beide Domains müssen dieselbe Meta Pixel ID verwenden, und die fbclid muss als URL-Query-Parameter übergeben werden.

Warum sollte ich die UTM-Parameter an die Booking Engine übergeben, auch wenn Cross-Domain-Tracking aktiv ist?

  • Wenn du die UTM-Parameter utm_source, utm_medium und utm_campaign übergibst, können wir das Angebot im CASABLANCA-System mit diesen Daten anreichern.

Gibt es einen Debug-Modus?

  • Ja. Lege im Local Storage des Browsers den Schlüssel meta:testEventCode mit deinem Meta-Test-Event-Code an und lade die Seite neu. Die CAPI-Funnel-Events werden dann an die angegebene Testumgebung gesendet.