Skip to main content

​
Overview

Connecting Google Analytics (GA4) to Innkeepr allows you to stream event and user data directly into Innkeepr’s data model. This enables more accurate user identification, event enrichment, and audience creation based on behavioral insights captured by GA4. Unlike ad destinations (e.g., Meta or TikTok), Google Analytics acts as a data source — it sends information to Innkeepr rather than receiving audiences back. Once connected, Innkeepr uses these events to enrich profiles, improve predictive models, and activate segments across your ad platforms.

​
Prerequisites

Technical Requirements:
  • Active Google Analytics 4 (GA4) property
  • Admin access to GA4 and Innkeepr
  • Google Analytics integration enabled in Innkeepr
  • User consent to share first-party data for analytics and advertising purposes
Recommended setup:
  • GA4 connected to your website or app
  • Key events tracked: page_view, session_start, view_item, add_to_cart, purchase, sign_up

​
Setup Instructions

​
Step 1: Connect Google Analytics to Innkeepr

  1. In Innkeepr, navigate to Sources > Browse
  2. Click Connect Google Analytics
  3. Sign in with your Google account and select the GA4 property you want to connect
  4. Grant Innkeepr read access to the Analytics data
  5. Confirm the connection — your GA4 property will appear as an active data source

​
Step 2: Map Analytics Events to Innkeepr Events

After connecting, you’ll need to define how GA4 events map to Innkeepr’s standardized event schema.
GA4 EventMapped Innkeepr EventDescription
page_viewPage ViewedUser visited a page on your website
add_to_cartProduct AddedUser added an item to their cart
purchaseCheckout CompletedUser completed a transaction
sign_upUser Signed UpNew user registration
loginUser Logged InReturning user logged into account
Optional: You can map custom GA4 events (e.g., view_promo, start_trial) to custom Innkeepr events for deeper behavioral tracking.

​
Step 3: Send User Identifiers (Identify Calls)

Innkeepr uses Identify calls to tie event data to specific users.
GA4 can forward user information (when available) such as: 
{
  "type": "identify",
  "traits": {
    "email": "user@example.com",
    "plan": "premium",
    "country": "DE"
  },
  "userId": "12345"
}

​
Enable User-ID Tracking in GA4

You can configure this by enabling User-ID tracking in GA4:
  1. Go to Admin → Data Streams → Web → Configure tag settings → User-ID
  2. Enable User-ID collection
  3. In your website tag or GTM, send the same user identifier to both GA4 and Innkeepr
  4. Innkeepr will automatically merge sessions and events under one profile

​
Step 4: Verify Event Flow

To confirm that GA4 events are successfully flowing into Innkeepr:
  1. Open Innkeepr → Events in the top navigation
  2. Make sure the view is set to Live
  3. Use the Search or Filter to look for events that should come from GA4 (e.g. page_view, purchase, sign_up)
  4. Check the Type column — GA4 events will usually show up as PAGE or TRACK, and Identify-style data as IDENTIFY
  5. Open an event to verify that user traits (e.g. email, country, plan) are attached
If events do not appear:
  • Confirm the Google Analytics connection is active under Sources (or Connections → Data Sources, depending on your setup)
  • Check that GA4 is actually firing those events (use GA4 DebugView or Tag Assistant)
  • Make sure you connected the correct GA4 property / data stream
  • Wait up to 24 hours for the first sync

​
Best Practices

  • Use consistent User IDs: Make sure the same userId is passed to both GA4 and Innkeepr to maintain data integrity.
  • Track key conversion events: At minimum, track add_to_cart, purchase, and sign_up.
  • Avoid double counting: If you already send events directly from your site to Innkeepr, disable duplicate GA4 forwarding for those events.
  • Leverage traits: Include identifiers like email, country, and plan to enable better segmentation and predictive scoring.
  • Regularly verify event mapping: GA4 event names can change — review mappings quarterly.

​
Troubleshooting

​
Events Not Showing in Innkeepr

Issue: Events from GA4 aren’t appearing in Innkeepr
Solutions:
  • Confirm the integration is connected under Connections → Data Sources
  • Check GA4 API permissions (read access required)
  • Ensure GA4 property uses a web data stream
  • Wait up to 24 hours for the first sync to complete

​
User Traits Missing

Issue: Events arrive, but user info (e.g., email, plan) is missing
Solutions:
  • Verify User-ID tracking is enabled in GA4
  • Confirm Identify traits are sent from GA4 tags or via your backend
  • Map email and plan traits correctly in Innkeepr’s field mapping settings

​
Duplicate Events

Issue: Same event appears multiple times in Innkeepr
Solutions:
  • Check if events are being sent both directly via site tags and GA4
  • Disable duplicate event forwarding in Innkeepr or Tag Manager
  • Retain only one active source per event type