GA4 integration

Ask your account manager to enable the GA4 integration for your account. Once it is on, Shuttlebase sends an event to your GA4 property every time a visitor is assigned to an experiment variant, so you can analyze experiment exposure alongside the rest of your analytics.

The event is named abtest_user_bucketed and carries four parameters:

Parameter	Contains
abtest_exp_id	Experiment ID
abtest_exp_name	Experiment name
abtest_var_id	Variant ID
abtest_var_name	Variant name

Note

This data is there for your own exploration. Experiment results on the Shuttlebase dashboard are always calculated from Shuttlebase’s first-party tracking — see Metrics and guardrails.

Make the parameters visible in GA4

GA4 collects every parameter on the event as soon as the integration is on, but you’ll have to go through a one-time setup in order to see the figures inside Google Analytics, each dimension applies from the moment you create it onward.

1. In Google Analytics, open Admin, then Data display, then Custom definitions.
2. Click Create custom dimension.
3. Set Scope to Event.
4. Fill in the dimension name and event parameter from the table below.
5. Repeat for each of the four parameters.

Dimension name	Scope	Event parameter
Experiment Name	Event	abtest_exp_name
Variant Name	Event	abtest_var_name
Experiment ID	Event	abtest_exp_id
Variant ID	Event	abtest_var_id

Allow up to 24 hours for the dimensions to begin populating. After that you can break reports down by experiment and variant. The quickest place to start is Explore: build a free-form exploration with abtest_exp_name and abtest_var_name as rows and your own metrics as columns.

Note

A GA4 property allows up to 50 event-scoped custom dimensions. Your remaining quota is shown on the same Custom definitions screen.

BigQuery

If your GA4 property exports to BigQuery, no setup is needed. Every parameter on the event is written to the export as it arrives — including data collected before you create the custom dimensions — and is queryable from the event_params field.