Version 3.x of VTEX Google Tag Manager (GTM) app introduces enhanced tracking capabilities for user interactions within the store. With the integration of the ecommerceV2 variable, this version allows for comprehensive monitoring of the user journey, capturing events from product views to completed purchases. Additionally, it allows stores to send events in both the Google Analytics 4 (GA4) format and the Universal Analytics (UA) format, facilitating a seamless transition to GA4.
Product schema properties of GTM 3.x
To ensure consistency in product information across all areas of the store and effectively track the user's journey, Google Tag Manager 3.x introduces Enhanced Ecommerce properties to the product data schema as events. By adding these properties, stores can include additional information such as product printing, promotion, and sales data, thereby enhancing the overall tracking capabilities and maintaining a unified view of the user's journey throughout the store.
| GTM 3.x property | Type | Description |
|---|---|---|
id | Updated property | Product ID - Previously SKU ID. |
variant | Updated property | SKU ID - Previously SKU Name. The variant of the product, e.g., Rebel pink. |
name | Updated property | Product Name - Previously Product Name or SKU Name. |
quantity | Unchanged property | Product quantity |
price | Unchanged property | Product price. |
category | Unchanged property | Product category, e.g., Apparel. |
brand | Unchanged property | Product brand. |
dimension1 | New property | Product Reference ID. |
dimension2 | New property | SKU Reference ID. |
dimension3 | New property | SKU Name (does not include the Product Name). |
The dimension1, dimension2, dimension3 properties are custom dimensions that you can use to collect and analyze data that Google Analytics does not automatically create.
For more information about custom dimensions and Enhanced Ecommerce, refer to Custom dimensions and metrics and Google Enhanced ecommerce official guide respectively.
Migrating to GTM 3.x
To migrate to the app's 3.x version, please follow these guides:
- Create a Google Analytics 4 property: Refer to the "Create a Google Analytics 4 property" section and follow the instructions provided.
- Once you have completed the setup, proceed to the Setting up Google Tag Manager guide for instructions on configuring events, tags, and triggers specifically for GA4.
By following these steps, you'll be able to smoothly migrate to the latest version of the app and set up events, tags, and triggers for both GA4 and UA formats.