Migrating Google Tag Manager app from major 2.x to major 3.x

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 propertyTypeDescription
idUpdated propertyProduct ID - Previously SKU ID.
variantUpdated propertySKU ID - Previously SKU Name. The variant of the product, e.g., Rebel pink.
nameUpdated propertyProduct Name - Previously Product Name or SKU Name.
quantityUnchanged propertyProduct quantity
priceUnchanged propertyProduct price.
categoryUnchanged propertyProduct category, e.g., Apparel.
brandUnchanged propertyProduct brand.
dimension1New propertyProduct Reference ID.
dimension2New propertySKU Reference ID.
dimension3New propertySKU 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:

  1. Create a Google Analytics 4 property: Refer to the "Create a Google Analytics 4 property" section and follow the instructions provided.
  2. 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.

Photo of the contributor
+ 1 contributors
Was this helpful?
Suggest edits (Github)
See also
Vtex Google Tag Manager
Setting up Google Tag Manager
Storefront development
Photo of the contributor
+ 1 contributors
On this page