Set Up GA4 Integration

Depending on how your store has implemented Google Analytics, multiple integration methods are available. Google Tag Manager is the recommended method, as it provides the most reliable data flow and gives you full control over your analytics implementation.

Google Tag Manager (Recommended)

Google Tag Manager provides the most reliable integration with full control over how events flow to GA4. This is the recommended method for all stores.

Prerequisites

Before you begin, make sure you have:

• A Google Tag Manager container installed on your store with a Google Analytics 4 tag configured

• Access to the Google Analytics property you want to connect (you'll authorize this in Shoplift)

• Permission to create Audiences in GA4 using the Google account you'll connect

• Permission to publish changes to your GTM container

• Permission to create custom definitions in GA4 to register the event as a custom dimension (Admin > Custom definitions)

Step 1: Connect GA4 in Shoplift

Start by authorizing Shoplift to access your Google Analytics property:

1. In Shoplift, navigate to Settings → Integrations

2. Find the Google Analytics section and click Connect

3. Sign in with the Google account that has access to your GA4 property

4. When prompted, grant Shoplift permission to "Edit Google Analytics management entities" — this allows Shoplift to create audiences for your tests

5. Set the integration type to "Google Tag Manager (recommended)"

6. Select your GA4 account and property from the dropdowns and click Confirm

The integration will toggle on, confirming that Shoplift and GA4 are now connected.

Step 2: Create the Data Layer Variable in GTM

Shoplift pushes test data to the data layer using a variable called exp_variant_string. You need to create this variable in GTM so it can be passed to GA4:

1. In Google Tag Manager, go to Variables

2. Under User-Defined Variables, click New

1. Name the variable exp_variant_string

2. Click Variable Configuration and select Data Layer Variable

1. In the Data Layer Variable Name field, enter: exp_variant_string

2. Confirm the Data Layer Version is set to Version 2

1. Click Save

Step 3: Create the GA4 Event Tag

Now create a tag that sends the experience_impression event to GA4:

1. In GTM, go to Tags and click New

2. Name the tag Shoplift - GA4 Event

3. Click Tag Configuration and select Google Analytics: GA4 Event

1. In the Measurement ID field, enter your GA4 Measurement ID (format: G-XXXXXXXXXX) — this should match the property you connected in Shoplift

2. In the Event Name field, enter: experience_impression

3. Expand Event Parameters and click Add Parameter

4. Set the Parameter Name to: exp_variant_string

5. For the Value, click the variable picker and select the exp_variant_string variable you created in Step 2

1. Click Save

Step 4: Create the Event Trigger

Create a trigger that fires your tag when Shoplift pushes the experience impression event:

1. In the tag you just created, click Triggering

2. Click the + icon to create a new trigger

3. Name the trigger Shoplift - GA4 Event Trigger

4. Click Trigger Configuration and scroll to the Other section

5. Select Custom Event

1. In the Event name field, enter: experience_impression

1. Click Save to save the trigger

2. Click Save again to save the tag

Step 5: Publish Your Changes

Click Submit in GTM, then Publish to push your changes live.

Your GTM container is now configured to receive events from Shoplift and forward them to GA4.

Step 6: Register the event as a custom dimension in Google Analytics

Required Step: You must register exp_variant_string as a custom dimension before you can use test data in GA4 Explorations. Skip this step and your test variants won't appear as a segmentation option.

GA4 requires event parameters to be registered as custom dimensions before they can be used in reports. Here's how to set this up:

1. In Google Analytics, click Admin (gear icon in the bottom left)

2. Under your property, click Custom definitions

3. Click Create custom dimension

1. Configure the dimension:

   • Dimension name: exp_variant_string

   • Scope: Event

   • Event parameter: Select exp_variant_string from the dropdown

1. Click Save

Note: If exp_variant_string doesn't appear in the Event parameter dropdown, it means GA4 hasn't received any events with this parameter yet. Launch a test in Shoplift and visit your store as a test participant, then return to this step. It may take up to 24 hours for new parameters to appear.

Once registered, the custom dimension will be available for use in Explorations within 24-48 hours.

Elevar (via Google Tag Manager)

Google & YouTube Sales Channel

Ready to analyze your data in GA4? See View Test Data In GA4