A/B Test and Google Analytics Integration via GTM

Crazy Egg can optionally send a custom event to Google Analytics whenever an A/B Test variant is viewed by one of your site visitors. This event will include custom properties specifying the name and ID of the variant that was viewed and the name and ID of the associated A/B Test for use in your Google Analytics reports.

Integration method

Crazy Egg sends its custom events to Google Analytics in one of two ways, depending on how you installed GA4 on your site.  This article is for those who installed GA4 using Google Tag Manager.

Configure Google Tag Manager (GTM)

1. Download the file Crazy Egg GA4 GTM integration.json
   
   
2. Log in to GTM at https://tagmanager.google.com/.
   
   
3. Select the desired site container from the Accounts tab.
   
   
4. Click Admin from the navigation bar near the top of the page.
   
   
5. Click Import Container
   
   
6. Click Choose container file and select the previously downloaded file Crazy Egg GA4 GTM integration.json.
   
   
7. Under Choose Workspace, click Default Workspace
   
   
8. If there is not already a separate workspace, click the + button to add a new workspace, name it something like Crazy Egg, and then click Save. Otherwise, select your existing Crazy Egg workspace.
   
   
9. Under Choose an import option, click Merge.
   
   
10. Select the Overwrite conflicting tags, triggers, and variables option.
    
11. Click Confirm.
    
    
12. Click Tags.
    
    
13. Click the Crazy Egg Variant View tag.
    
    
14. Ensure the Measurement ID is correct for the Google Analytics 4 tag installed on your site. Update the ID, if necessary, and click Save.
    
    You should see this:
    
    If this is not what you see, go to troubleshooting GTM setup.
    
    
15. Publish your changes by clicking the Submit button near the top-right corner of the page.

Configuring Custom Definitions in Google Analytics

You will need to configure Google Analytics to report on the custom event properties that Crazy Egg sends. Otherwise, they will not consistently appear in your GA reports. These steps are repetitive, but they only have to be performed once to integrate Crazy Egg fully with Google Analytics.

1. Log in to Google Analytics at https://analytics.google.com/ and select the desired account and property.
   
   
2. Click Admin from the bottom of the navigation area on the left side of the page.
   
   
3. Under Data Display, select Custom Definitions.
   
   
4. Click the Create custom dimension button.
   
   
5. Create the "Crazy Egg AB Test ID" dimension
   • Enter Crazy Egg AB Test ID into the Dimension name field
   • Enter crazyegg_ab_test_idinto the Event parameter field
   • Click Save
     
     
6. Create the "Crazy Egg AB Test Name" dimension
   • Enter Crazy Egg AB Test Name into the Dimension name field
   • Enter crazyegg_ab_test_nameinto the Event parameter field
   • Click Save
     
     
7. Create the "Crazy Egg Variant ID" dimension
   • Enter Crazy Egg Variant ID into the Dimension name field
   • Enter crazyegg_variant_idinto the Event parameter field
   • Click Save
     
     
8. Create the "Crazy Egg Variant Name" dimension
   • Enter Crazy Egg Variant Name into the Dimension name field
   • Enter crazyegg_variant_nameinto the Event parameter field
   • Click Save
     
     
9. Create the "Crazy Egg AB Test and Variant" dimension
   • Enter Crazy Egg AB Test and Variant into the Dimension name field
   • Enter crazyegg_ab_test_and_variant into the Event parameter field
   • Click Save

Afterward, the Custom dimensions table should have four new custom dimensions:

Confirming your integration

1. Log in to Google Analytics at https://analytics.google.com/ and select the desired account and property.
2. Click View realtime →
3. Scroll down to the Event count by Event name section.
4. Whenever a visitor views an A/B Test, a crazyegg_variant_view event should appear in this section.
5. Clicking the crazyegg_variant_view event name will show the event counts for the event properties defined earlier: crazyegg_ab_test_id, crazyegg_variant_id , etc.