Skip to main content

Setting up Google Analytics 4 (GA4) Cross-Domain Tracking with Wheelbase

  • Updated

 

This documentation guides you through setting up cross-domain Google Analytics 4 (GA4) tracking to connect your primary website domain with the checkout.wheelbasepro.com domain.

This process is essential for maintaining a single, unique user session when a customer navigates from your main site to the Wheelbase checkout. A correct setup ensures that traffic and conversions are accurately attributed to the original user acquisition channel (e.g., Google, Social, Direct) rather than being recorded as a "self-referral" from your own site.

 

 

 

Step 1: Add Your GA4 Tag ID in Wheelbase

  1. Navigate to Wheelbase Integrations: Go to the Account Integrations page in your Wheelbase dashboard: https://dashboard.wheelbasepro.com/account/integrations.
  2. Enter the GA4 Tag: Locate the input field for “Google Analytics (GA4)” and add your GA4 Tag/Measurement ID (it will be prefixed with “G-”).
  3. Save: Click “Save”.

Tip: Finding Your GA4 Tag ID

If you don't know your ID, navigate to the Admin panel in your Google Analytics property. Go to Data Streams, select your Web stream, and the Measurement ID will be clearly displayed.

 

 

Step 2: Install the GA4 Tag on Your Website

 

Your website needs the GA4 tracking code snippet installed on all pages to begin collecting data.

  1. View Tag Instructions in GA4: In your GA4 Admin panel, go to Data Streams and select your Web stream. Find and click “View tag instructions”.
  2. Copy the Snippet: Copy the global site tag snippet provided.
  3. Add to Website: Add this snippet to the <head> section of every page on your website.

 

 

Step 3: Configure Cross-Domain Linking in GA4

 

To ensure a continuous session when users switch between your domain and the Wheelbase checkout, you must configure cross-domain linking.

  1. Access Tag Settings: From the same Data Stream menu in GA4, select “Configure tag settings”.
  2. Configure Domains: Select “Configure your domains”.
  3. Add Domains: Add both your primary website domain and the Wheelbase domain for cross-domain linking:
    • Your website domain (e.g., mywebsite.com)
    • The Wheelbase checkout domain: checkout.wheelbasepro.com
  4. Save: Click “Save”.

 

 

Step 4: Implement Referral Exclusion

 

Without referral exclusion, some browsers may treat the transition from your main site to the Wheelbase checkout as a new session, recording the traffic as a self-referral. Adding the domains to the exclusion list prevents this.

  1. Go to GA4 Admin: Navigate to your GA4 property's Admin panel.
  2. Select Data Stream: Choose your Web Data Stream.
  3. Configure Tag Settings: Scroll down and click “Configure tag settings”.
  4. List Unwanted Referrals: Click on “List unwanted referrals”.
  5. Add Domains: Add your domains and the embedded iframe domain. This instructs GA to ignore these domains as traffic sources, forcing it to look back at the original source (Google, Direct, etc.).

 

 

Final Step: Implement the Wheelbase Embed Script

 

Lastly, to ensure the Wheelbase checkout process functions correctly, you must install the required embed script on your website.

  • Action: Ensure the Wheelbase embed script has been added to your site.
  • Documentation: For detailed instructions on implementing the embed script, please refer to the official Wheelbase documentation: Wheelbase Embed Script Setup