Search Documentation

Find sections across all documentation pages

Analytics Setup

BookerKit automatically sends analytics events to your website's tracking infrastructure for complete conversion tracking and campaign attribution.

How It Works

The widget sends events via postMessage to your page, which automatically pushes them to window.dataLayer. No configuration required—if you have GTM or analytics installed, events will flow automatically.

Events Fired

bookerkit_widget_opened

When: Widget loads or button is clicked

Use for: Tracking widget engagement, page views

Data included: Account ID, session ID, account name

bookerkit_booking_started

When: User completes personal information (Step 1)

Use for: Lead generation tracking, measuring booking intent

Data included: Account ID, session ID, guest ID, email

bookerkit_service_selected

When: User selects a service (Step 2)

Use for: Understanding which services drive bookings

Data included: Account ID, session ID, service ID, service name, price, pre-selected flag

bookerkit_provider_selected

When: User selects a provider/therapist (Step 3, if provider selection is enabled)

Use for: Tracking provider preferences, funnel analysis

Data included: Account ID, session ID, provider ID, provider name, service ID

bookerkit_date_selected

When: User picks an appointment date

Use for: Micro-conversion tracking

Data included: Account ID, session ID, selected date, service info

bookerkit_time_selected

When: User selects a time slot

Use for: Funnel optimization

Data included: Account ID, session ID, date, time, service duration

bookerkit_booking_completed

When: Booking successfully completed

Use for: PRIMARY CONVERSION EVENT for Google Ads, Facebook, GA4

Data included: Account ID, session ID, booking ID, reservation ID, value (price), service ID, service name, date, start time, guest name, guest email

Setting Up Conversion Tracking

  1. Open Google Ads and go to Tools → Conversions
  2. Click "+ New conversion action"
  3. Select "Website" as the conversion source
  4. Choose "Code the conversion action yourself"
  5. Set up conversion with event name: bookerkit_booking_completed
  6. Configure value tracking using the value parameter
  7. Save and verify events are being tracked

Pro Tip: The value parameter automatically includes the service price, allowing for accurate ROAS tracking.

Facebook Pixel

  1. Open Facebook Events Manager and select your pixel
  2. Go to "Custom Conversions" → "Create Custom Conversion"
  3. Name it "Booking Completed"
  4. For the rule, choose "URL equals" and enter your website domain
  5. Add an event parameter rule: "event equals bookerkit_booking_completed"
  6. Set the conversion value to use event value
  7. Save and use in your Facebook Ads campaigns

Alternative Method: If you have GTM set up with Facebook Pixel, create a trigger using the bookerkit_booking_completed event and fire a Facebook Standard Event.

Google Analytics 4

  1. Events automatically appear in GA4 if using GTM
  2. Go to GA4 → Configure → Events to see all BookerKit events
  3. Mark bookerkit_booking_completed as a conversion
  4. Use the value parameter for revenue tracking in reports
  5. Create audiences based on booking behavior for remarketing

Google Tag Manager

GTM receives all events automatically. Create triggers and tags based on BookerKit events:

  1. Go to GTM → Triggers → New
  2. Trigger Type: "Custom Event"
  3. Event name: bookerkit_booking_completed (or any other event)
  4. Create tags that fire on these triggers (GA4 events, Facebook events, etc.)
  5. Access event data using variables like {{dlv - value}} for the booking value

Available DataLayer Variables

  • event (event name)
  • accountId
  • sessionId
  • bookingId, reservationId
  • value (service price)
  • serviceId
  • providerId, providerName
  • date, startTime
  • guestEmailSha256, guestNameSha256 (SHA-256 hashed)

For privacy, service names and raw guest identifiers are not exposed in the dataLayer. Email and name are provided only as SHA-256 hashes, suitable for Google Enhanced Conversions and Meta Advanced Matching.

Session Tracking & Attribution

BookerKit automatically captures detailed session data for every booking. This data is stored with the booking session and included in webhook payloads for full attribution.

Ad Platform Click IDs

Automatically captures: gclid (Google), fbclid (Facebook), fbc / fbp (Facebook cookies), msclkid (Microsoft).

UTM Parameters

Captures utm_source, utm_medium, utm_campaign, utm_term, and utm_content from the page URL.

Device & Browser

Records device type (desktop/mobile/tablet), browser name and version, OS, screen resolution, and viewport size.

Referral Data

Captures the referring URL and landing page where the widget was loaded.

Testing Analytics

Browser Console

Open your browser's developer console and type dataLayer to see all events. After completing a booking, you should see BookerKit events appear.

Google Tag Assistant

Install the Google Tag Assistant browser extension. It will show you all GTM and GA4 events firing in real-time as you test the widget.

Facebook Pixel Helper

Install the Facebook Pixel Helper extension to verify Facebook events are firing correctly.

Testing Recommendation

Complete a test booking on your live site before running any paid ads. Verify that the bookerkit_booking_completed event appears in your analytics platform with the correct value.