Skip to main content
To use event data from Google Analytics 4 in SegmentStream, you need to first set up a Google Analytics 4 BigQuery Link. Refer to the Set up GA4 BigQuery Link guide and ensure the following requirements are met:
  • The data location of the BigQuery dataset used in SegmentStream matches the one configured in GA4. GA4 BigQuery data location setting
  • The Streaming export type is enabled, and the Daily export is disabled. GA4 BigQuery streaming export setting
  • No events are excluded in your BigQuery Link settings. GA4 BigQuery no excluded events
Once the GA4 BigQuery Export is set up, data should start flowing to your BigQuery project within 24 hours. After that happens, you can connect your Google Analytics 4 to SegmentStream.

Connecting Google Analytics 4 to SegmentStream

1

Navigate to events tracking

Inside the admin panel navigate to Settings > Events Tracking.
2

Add Google Analytics 4

Click + ADD and select the Google Analytics 4 option.
3

Authorise your Google account

In the drawer that opens, authorise your Google account.
4

Select account and property

Select the account and property where your data is collected.
5

Save

Click Save.
6

Wait for data processing

All event data exported to your BigQuery in the past 60 days will be processed by SegmentStream, and reports will become available. This process might take a couple of hours.
Follow the guide on Additional GA4 settings to pass additional parameters that help SegmentStream integrate better with your business.
GA4 connection in SegmentStream

Referral exclusion logic

To ensure SegmentStream provides accurate insights, it must correctly identify where each session’s traffic is coming from. Properly setting up referral exclusions is key, especially when users move between different domains or subdomains during redirects. Typical scenarios for using referral exclusions include stopping traffic from payment gateways, login systems, or other internal processes from being counted as external referrals. SegmentStream uses the settings from your Google Analytics 4 (GA4) property to filter out unwanted referrals. If your GA4 is correctly set up, SegmentStream automatically applies those same settings. This process helps identify and exclude unwanted referral traffic through the following methods:
  • Identifying when visitors navigate within different parts of your site or its subdomains, preventing these movements from being counted as external visits.
  • Redirects between websites specified in your GA4 stream’s cross-domain measurement function are treated similarly to redirects within the same domain and are excluded from referral tracking. Learn more about setting up cross-domain measurement in Google’s documentation.
  • You can further control unwanted referrals by configuring the unwanted referrals list in your GA4 stream settings. Refer to Google’s documentation for configuring unwanted referrals.

BigQuery access issues

If the Google Analytics 4 BigQuery link is connected to a different project than the one specified in the SegmentStream BigQuery settings, you need to provide additional permissions before connecting event tracking.

Get your service account email

  1. In your SegmentStream project, navigate to Settings > Events Tracking.
  2. Click on the Google Analytics 4 option.
  3. Select the account and property where your data is collected.
  4. Copy the service account email from the Google Analytics 4 connection settings.
Service account email in SegmentStream

Find the BigQuery project linked to GA4

  1. In your Google Analytics property, go to Admin.
  2. Under Product Links, click BigQuery Links.
  3. You will see the ID and name of the linked project.
GA4 BigQuery linked project

Set permissions in your Google Cloud account

1

Open Google Cloud Console

2

Navigate to IAM

Open the console left side menu and click IAM & admin. Select IAM from the list.Google Cloud IAM admin page
3

Select the linked project

Click on the project selection menu in the navigation bar, and select the project linked to Google Analytics 4.Google Cloud project selector
4

Grant access

Click GRANT ACCESS.Google Cloud grant access button
5

Configure roles

  1. Paste the service account email address into the New principals field.
  2. Select the BigQuery Data Viewer and BigQuery User roles.
  3. Click Save. BigQuery roles configuration

Test connection and save

  1. Return to your SegmentStream project and navigate to the Google Analytics 4 connection.
  2. Click TEST CONNECTION.
  3. If the permissions have been correctly set up, the SAVE button should be active. Click it to complete your Google Analytics 4 tracking setup.
GA4 test connection in SegmentStream

In this section