In this guide, you will learn how to track and analyze data from your store using Google Analytics 4. Specifically, you will:
-
Set up GA4 events by downloading and importing a container file, adding necessary tags, triggers, and variables, and editing the Measurement ID field with your Google tag ID.
-
Test that the GA4 Configuration tag is firing correctly on every page and ensure that the GA4 Event tags accurately track user actions such as viewing a product or adding a product to the cart.
-
Verify that the events are arriving and the reports are being filled with data by accessing the Google Analytics' DebugView and Reports.
-
Use the available events that Pixel Apps can listen to and new events that GA4 has introduced to start tracking various user actions such as product impressions, add to cart, order placed, and more.
Before you start
Before proceeding any further, make sure you have the following requisites:
-
Installed and configured the VTEX Google Tag Manager app. For more information, refer to Installing Google Tag Manager.
-
Created A Google Analytics 4 (GA4) Configuration tag using your Measumerent ID in Google Tag Manager (GTM). For more information, refer to the following Google article Set up the Google Analytics 4 Configuration tag.
Step-by-step
Step 1 - Setting up GA4 events
Once the GA4 Configuration tag is created, set up all GA4 events as follows:
-
Download the container file. This container adds all the necessary tags, triggers, and variables.
-
Import the container file by following Google’s Import a container guide. This will add all the necessary tags, triggers, and variables to the workspace.

- In the GTM container, go to the GA4 Configuration tag, and edit the Measurement ID field with your Google Tag ID ( G- ID).
To find your Google Tag ID, refer to Find your Google tag ID article
Step 2 - Testing Tags in Google Tag Manager
To test that the GA4 Configuration tag is firing correctly for every page, use the Preview mode in Google Tag Manager (GTM). Additionally, verify if the GA4 Event tags are firing accurately for user actions such as viewing a product or adding a product to the cart.
Step 3 - Testing Events sent to Google Analytics 4
To verify if the events are arriving and the reports are being filled with data, access the Google Analytics Admin and use the DebugView to verify if the events are arriving and the Reports are being filled with data.

To see the available events that GA4 can track, refer to the Overview of Events in Google Analytics 4 section.
Overview events
This section provides a list of events that GA4 can track.This section also explains the view_promotion event, which is usually attached to the promotion banners carousel displayed by the Slider Layout block.
View Promotion
The GA4 view_promotion expects to receive the product’s name or ID associated with it.
This event is commonly attached to the promotion banners carousel displayed by the Slider Layout block. For example, you can use the Site Editor to configure the Product ID and Product Name. To access the Site Editor, in the VTEX Admin, go to Storefront > Site Editor.

Supported events
Check out the available events that Pixel Apps can listen to and their equivalent names in UA and GA4:
| VTEX | UA | GA4 |
|---|---|---|
| vtex:promoView | promoView | view_promotion |
| vtex:promotionClick | promoClick | select_promotion |
| vtex:productView | detail | view_item |
| vtex:productImpression | impressions | view_item_list |
| vtex:productClick | click | select_item |
| vtex:addToCart | add | add_to_cart |
| vtex:removeFromCart | remove | remove_from_cart |
| vtex:cartLoaded | checkout | begin_checkout |
| vtex:orderPlaced | purchase | purchase |
GA4 events
Besides the events listed in the previous sections, GA4 has new events that stores can start tracking. The full list can be found on Google documentation.
The GTM app listens to the following events and sends them in the following corresponding GA4 format:
| VTEX | GA4 |
|---|---|
| vtex:addPaymentInfo | add_payment_info |
| vtex:addShippingInfo | add_shipping_info |
| vtex:login | login |
| vtex:signUp | sign_up |
| vtex:viewCart | view_cart |
| vtex:beginCheckout | begin_checkout |
| vtex:refund | refund |
| vtex:addToWishlist | add_to_wishlist |
| vtex:search | search |
| vtex:share | share |