Zum Hauptinhalt springen

Technical Specification: Meta Integration

  • System: CASABLANCA Booking Engine and Meta
  • Date: 2026

1. Overview​

Our Booking Engine offers a native, "plug-and-play" integration with Meta Pixel and Meta Conversion API (CAPI). We handle the technical implementation of the Event Firing, and GDPR Consent Management automatically.

How to activate:

Navigate to the CASABLANCA cloud > Booking Engine > Spaces > Space Settings.
Enter the Meta Pixel ID and the Meta Access Token (for CAPI).
Result: The system automatically injects the tracking code and enables the GDPR Cookie Banner on the frontend.

2. Privacy & Consent (GDPR/DSGVO)​

Activation: The Meta Pixel script and cookies are blocked until the user explicitly clicks "Accept" on the Cookie Banner.
Signal Activation: Upon acceptance, we fire fbq("consent", "grant") and load the library.

3. E-Commerce Event Specification​

We utilize the Conversion API to send the following events:

A. Funnel Events​

EventNameTriggerKey Parameters Sent
InitiateCheckoutUser enters the checkout page.custom_data
PurchaseUser completes booking.custom_data

User data, like client_user_agent, fbc and em are added if available at the time the event was triggered.

B. Item Data Structure​

The object structure of the items are as follows:

CustomData:

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

4. FAQ for Agencies​

Q: Do we need to set up Google Tag Manager (GTM)?
A: No. We inject the fbevents.js directly.

Q: Can I customize the Cookie Banner?
A: The text of the Cookie Banner can't be edited, only the links. (CASABLANCA cloud > Booking Engine > Spaces > Space Settings > Links)

Q: What about Cross-Domain Tracking?
A: Both domains must use the same Meta Pixel ID and the fbclid needs to be passed as URL query param.

Q: Why should I pass the UTM query params to the Booking Engine even if Cross-Domain Tracking is active?
A: If you pass the UTM query params utm_source, utm_medium and utm_campaign, we can enrich the offer in the CASABLANCA system with this data.

Q: Is there a way to activate debug mode?
A: Yes. Add the local storage key meta:testEventCode with your Meta Test Event Code and reload the page.
This will send the CAPI funnel events to the provided test environment.