📖 Send Boost event data to your Google Analytics 4 account so you can measure how shoppers use search, product clicks, filters, and conversions in your own reports.
⚠️ Requirements
Available on the TURBO version only.
Event tracking only works on themes running the latest Boost template version. If events aren't showing in GA4, update your theme to the latest Boost version.
Before you start
To avoid a failed connection, make sure both of these are ready in GA4 first:
Administrator access to the GA4 property. The Google account you connect with must have the Administrator role on the property you want to use. Check in GA4 under Admin > Property access management. If you only have Viewer or Editor access, ask a property admin to upgrade your role.
A web data stream on the property. When a GA4 property is created, the "link a website or app" step can be skipped, but Boost needs a web data stream to send data to. In GA4, go to Admin > Data streams. If there's no web stream, click Add stream > Web, enter your store URL, and save. You don't need to add any code to your theme, just create the stream.
Turn on the connection
Go to Integration > Third-party integration > Google Analytics 4 integration.
Click Configure on the Google Analytics 4 card.
Switch on the Integrate Boost with Google Analytics 4 toggle.
You'll be redirected to Google to sign in. Choose the Google account that owns your GA4 data and approve access.
Boost connects securely via OAuth and returns you to the integration page.
Once connected, Boost automatically starts sending event data to your GA4 property.
Choose a GA4 property
If your Google account has only one property, Boost connects to it automatically.
If your account has multiple properties, you'll be asked to pick one:
Open the Select GA4 property dropdown.
Choose the property you want to receive Boost event data.
Click Connect property.
To switch later, click Change property and select a different one.
Confirm it's connected
On the integration page you'll see:
Connected Google account: the email you signed in with.
Property name: the GA4 property receiving data.
Property ID: for example,
G-XXXXXXX.
Events Boost sends to GA4
After connecting, Boost pushes these events so you can build reports in GA4:
Event group | Event name | Trigger condition |
Search |
| When users submit a search query (from the search box or by clicking View all results in ISW). |
|
| When users click suggestion terms in ISW. |
|
| When users click search results in ISW (Blog, Page, Collection). |
|
| When users click suggestion terms in the Did You Mean widget. |
Product click |
| When users click a product, or click the Quick view icon, on a collection page, search page, or any Boost widget. |
Conversion actions |
| When users click Add to cart in a product card on a collection page, search page, Boost widget, or product page (for Boost-related actions). |
|
| When users click Buy now in a product card on a collection page, search page, Boost widget, or product page (for Boost-related actions). |
|
| When users click the Pre-order button. |
|
| When users click the Notify me button. |
Filter |
| When users click a filter option value in the filter tree. |
Recommendation widget |
| When a widget (recommendation, bundle) appears to users (as they scroll and see the widget). |
Test that events reach GA4
After connecting, do a quick test to confirm data is flowing:
Open your live store (the published theme) in a browser.
Trigger a few of the events from the list above, for example: click the search box, run a search, click a product, or apply a filter.
Go back to GA4 > Reports > Realtime overview and look for those events.
You can also check via GA4 > Reports > Business Objectives > View users engagement and retention > Events.
Events usually appear within about 10 minutes. If you don't see them after that:
Make sure you connected the correct GA4 property.
Confirm your live theme is on the latest Boost template version.
Try again in a fresh or incognito browser session to avoid cached scripts.
Turn off the connection
When you no longer want Boost to send events to GA4, switch the Integrate Boost with Google Analytics 4 toggle off. A confirmation appears before the connection is removed. Confirm to stop the data flow. You can turn the toggle back on at any time to reconnect.
Best practices
Get the most reliable, useful data out of the GA4 integration.
Set up cleanly
Connect your production GA4 property, not a test one, so the data matches your real store.
Use a shared or admin Google account that won't be deactivated when a team member leaves.
Keep your live theme on the latest Boost template version so every event fires.
Run the test step above before you start relying on the data.
Make the data usable in GA4
Mark the events that matter (for example,
boost_search_query, product click, conversions) as key events in GA4 so they appear in conversion reports.Build a dedicated exploration or custom report for Boost events instead of digging through default reports. Useful views: top search terms, searches with no clicks, and filter usage.
Give the connection a few days before drawing conclusions. Realtime is for testing, while trends need volume.
Turn data into action
Understand what shoppers care about using
boost_filter_option_value_click. This shows which filter values customers pick most (brands, colors, sizes). Use it to spot demand trends and stock, promote, or merchandise those products accordingly. For example, if "Brand: Nike" and "Color: black" are clicked far more than others this month, feature them on your collection and home pages.Fix weak search results by spotting search terms with many searches but few product clicks. Low clicks usually mean the results are poor, missing, or irrelevant. For example, if shoppers search "sneakers" but rarely click, add it as a synonym for "shoes" or adjust merchandising so the right products show up.
Measure impact on revenue by cross-referencing Boost events with purchases. Compare the purchase rate of shoppers who used search vs. those who didn't to see how much search and filters contribute to sales.
Maintain the connection
Re-check the connection after theme changes, app updates, or moving to a new theme.
Make sure GA4 tracking is covered by your cookie consent and privacy policy.
Avoid turning the toggle off and on repeatedly. Removing the integration stops data and creates gaps in your reports.
Feel free to reach out to our dedicated support team via chat if you have any questions or require additional assistance.