weltpixel

Google Analytics 4 (GA4) with GTM support for Magento 2

Face to face with the new generation: Google Analytics 4.

Google Analytics 4 is a new type of property which includes different reports than the ones Google has gotten us used to with Universal Analytics. Google Analytics 4 can be used for Websites, Apps or both at the same time, whereas Universal Analytics can only be used for Websites. In this day and age, information is key to pretty much everything, which means that keeping your existing Universal Analytics Property and setting up a new GA4-based property to run in parallel can elevate your information game to new heights and assure you make the most informed, data-driven decisions when steering your store into the future.


Our extension helps open up this new platform to Magento 2 with an integration that's easy to set up and deploy. It brings the powerful functionality and ease of use of our popular Google Analytics Enhanced eCommerce UA GTM Tracking extension to the GA4 platform so you can get ready for stepping into the future.

Features of the Extension.

  • Track product impressions by position in the Category Page
  • Track product clicks by position in the Category Page
  • Track product impressions by position in the Search Result Page
  • Track product clicks by position in the Search Result Page
  • Track product impressions by position in the Related, Up-sell and Cross-sell section
  • Track product clicks by position in the Related, Up-sell and Cross-sell section
  • Track the number of times a product was added to the shopping cart
  • Track the number of times a product was removed from the shopping cart
  • Track the number of times a product was included into the checkout process
  • Track each Checkout Step (billing address, shipping address, shipping options, payment options)
  • Track purchases with or without shipping and tax fees
  • Exclude Orders with 0 Value from being tracked
  • Track Transactions Success Pages with Custom Success Page URLs
  • Track coupon usage
  • Track product Brand
  • Track internal Promotion Impressions
  • Track internal Promotion Clicks
  • Track Sign-Ups
  • Track Logins
  • Track Site Searches
  • Internal Promotion Widget
  • Child Vs Parent (Send Parent Id or Child id cart, checkout and thank you page)
  • Multi Currency Ready
  • GDPR-compliant with native magento accept cookie functionality
  • Multi Store Ready
  • Varnish Cache Ready
  • Full Page Cache Ready
  • 8KB payload support
  • Order Success Page Total Calculation (Subtotal / Grand total)
  • Track Magento User ID
  • Track user type (customer group)
  • Google Ads Remarketing Tracking
  • Google Ads Conversion Tracking
  • Persistent Data Management
  • Track product review count
  • Track product review score
  • Track stock status
  • Track Sale products
  • Track transactions by product variants (configurable product)
  • Track transactions by product custom options
  • Track custom dimension Page Type
  • Track custom dimension Page Name
  • Product level Custom Dimension / Metric sending (Send up to 5 product attributes to GTM)
  • Compatibility with Google Analytics 360 (GA360)
  • dataLayer Preview Window for easy debugging with possibility of adding custom IP ranges
  • Send all Simple Product configurations via the View Item event on Configurable Product Pages
  • NEW: Custom trigger for Google Ads Conversion Tracking Tag.
  • Complete sales data, including refunds and repeat purchases (PRO)
  • 100% order accuracy between Magento and Google Analytics (PRO)
  • Avoids missing orders (PRO)
  • Avoids duplicate orders (PRO)
  • Measurement Protocol Tracking for Purchase (PRO)
  • Measurement Protocol Tracking for Refunds (PRO)
  • Measurement Protocol Tracking for Sign Up and Login (PRO)
  • Measurement Protocol Tracking for Item View (PRO)
  • Measurement Protocol Tracking for Search (PRO)
  • Measurement Protocol Tracking for View, Add and Remove from Cart (PRO)
  • Measurement Protocol Tracking for Begin Checkout, Add Payment and Shipping (PRO)
  • NEW: User Properties for Measurement Protocol - Used to create Custom Dimensions (PRO)
  • Easy Measurement Protocol event debugging via Google Analytics Debug View (PRO)
  • Hyvä Theme Ready (PRO)
  • Meta Pixel (formerly Facebook Pixel) Integration (PRO)
  • Enhanced Conversions for Google Ads (PRO)
  • NEW: Enhanced Conversions for Google Analytics 4 (PRO)
  • New Customer Data for Google Ads (PRO)
  • Cart Data for Google Ads (PRO)
  • Exclude orders from being sent to Google Analytics by Order Status (PRO)
  • Purchase and Add Payment Info event compatibility with the Magento 2 Multi Shipping Checkout flow (PRO)

Compatibility with Google Analytics 360 (GA360)

Google Analytics 360 is an enterprise-level rendition of Google Analytics, which provides the tools and support required for merchants to get actionable insights from the data that flows into their dashboards. Google Analytics 360 boasts a number of advanced tools, in addition to all the standard Analytics features. A couple of these tools are:

  • Unsampled Reports
  • BigQuery Export
  • Data Driven Attribution

Apart from this, merchants using Google Analytics 360 also benefit from a higher-level service agreement which covers data freshness, collection and reporting, a higher processing limit and access to dedicated support services. Our Google Analytics 4 and Google Analytics 4 PRO extensions are compatible with Google Analytics 360 and are ready to send the data you need to build and maintain a true enterprise-level eCommerce business.

description
description
weltpixel

Event tracking from the get-go!

  • Right out of the box, Universal Analytics only allows for tracking page-views. While this is already great information to build upon, it's not necessarily enough for a store in the modern age. With GA4, there is more information available without needing to delve deeper into its settings.
  • Enhanced Measurement collects important data such as scrolling, clicks, downloads, engagements with videos on your website and more. While this is definitely possible with Universal Analytics as well, GA4 does this without the need for intervention!

Next-level retargeting!

  • Most websites have a conversion rate of around 2% on the first visit. Retargeting exists for the remainder 98% of users and can spell the difference between a user never visiting your website again and securing a conversion. In most cases, however, once a conversion is secured, you may not want to immediately keep targeting the user with ads. Prior to GA4, retargeting, while still extremely efficient, lacked the dynamism of being able to exclude certain users (either temporarily or permanently) from being retargeted. GA4 changes this and allows you to more efficiently use retargeting to, for example, temporarily exclude users that have recently purchased an item from being shown a particular ad again until they're eligible for a new set.
weltpixel
weltpixel

Redefining time-based events.

  • Universal Analytics provides great insight into time spent on pages and sessions, however, the insight can be lacking out of the box when it comes to more specific actions users take on your website, such as watching your neat presentation video. GA4 takes this one step further and allows you to set up time measurements for defined actions or sets of actions through its "Elapsed Time" functionality. This way, you can determine how long it takes a user to watch your video, browse the Category Page and finally complete the Checkout Process.

Bringing Web and Mobile together!

  • With the advanced capabilities of Google Analytics 4's Data Streams functionality, you can now centralize all your channels under one property, by setting up Data Streams for each one. This means that, if you have a website and mobile app, for example, you have access to the insights from both under the same Google Analytics property, which will allow you to better piece together and analyze a user's journey across your store, whichever device they choose to use in order to make it.
weltpixel

1 MINUTE INSTALLATION GUI.

  • Step 1.

    Before starting the installation:

    • Ensure your Magento version is compatible - This extension is currently compatible with the following Magento versions: 2.3.0. - 2.4.7.
    • Install the extension on a testing/development/staging environment first, then, after thoroughly testing it out, install it on a production (live) environment.
    • Make sure the Magento instance is in developer mode. You can use the php bin/magento deploy:mode:set developer command to change the mode to developer and then check to make sure the generated folder in the root of the Magento project is empty.
  • Step 2:
    Copy the extension files to below paths of your magento 2 instance. If the ‘app/code/WeltPixel’ folder is missing, please create it manually:
    app/code/WeltPixel/Backend
    app/code/WeltPixel/GA4


  • Optional
    Copy the extension files into the below path of your Magento 2 instance. If the ‘app/code/WeSupply’ folder is missing, please create it manually:
    app/code/WeSupply/Toolbox

  • Step 3:
    Copy the installation GUI folder 'weltpixel-extension-installation' in the root of your Magento installation. In some Magento configurations the public root folder may be under 'pub' directory.
    www.yourmagentostore.com/weltpixel-extension-installation/
  • Step 4:
    In your browser go to www.yourmagentostore.com/weltpixel-extension-installation/ and simply follow the installation steps from the graphical interface, presented in your browser. See the installation video: 1 Minute Module Installation via browser GUI.
  • Step 5:
    If your store was in production mode before starting the installation, make sure to switch it back to production mode by running the following command in the root of your Magento installation: php bin/magento deploy:mode:set production.
  • Step 6:
    Wooohooo! The extension is now installed on your Magento store! Congrats!

Troubleshooting

If you experienced any issues or limitations with this quick GUI installation, see also SSH Installation below. SSH installation does the same thing but you are required to issue the commands step by step via CLI. Some servers may have high security configurations and may limit the functionality of this GUI Installer.

How to Install via SSH.

  • Step 1.

    Before starting the installation:

    • Ensure your Magento version is compatible - This extension is currently compatible with the following Magento versions: 2.3.0. - 2.4.7.
    • Install the extension on a testing/development/staging environment first, then, after thoroughly testing it out, install it on a production (live) environment.
    • Make sure the Magento instance is in developer mode. You can use the php bin/magento deploy:mode:set developer command to change the mode to developer and then check to make sure the generated folder in the root of the Magento project is empty.
  • Step 2.
    Copy the extension files to below paths of your magento 2 instance. If ‘app/code/WeltPixel’ folder is missing, please create it manually:
    app/code/WeltPixel/Backend
    app/code/WeltPixel/GA4


  • Optional
    Copy the extension files into the below path of your Magento 2 instance. If the ‘app/code/WeSupply’ folder is missing, please create it manually:
    app/code/WeSupply/Toolbox

  • Step 3.
    Access the root of your magento 2 project from command line and run the following commands:
    php bin/magento module:enable WeltPixel_Backend --clear-static-content
    php bin/magento module:enable WeltPixel_GA4 --clear-static-content
    php bin/magento setup:upgrade
    php bin/magento setup:di:compile
    php bin/magento setup:static-content:deploy -f
  • Step 4.
    Flush any cache that you might still have enabled on your server or in Magento.
  • Step 5:
    If your store was in production mode before starting the installation, make sure to switch it back to production mode by running the following command in the root of your Magento installation: php bin/magento deploy:mode:set production.
  • Step 6:
    Wooohooo! The extension is now installed on your Magento store! Congrats!

How to Upgrade the extension.

  • Step 1. Go to your Google Tag Manager account and remove all tags associated with this extension as new release may contain new tags or adjustments to existing tags. If not removed, tags will not be updated.
  • Step 2. Remove extension code under app/code/WeltPixel/GA4 before adding the new extension files. Extension may be refactored and old unused files may cause random issues so it's best to only keep the latest version of the files.
  • Step 3. Follow normal installation instructions above.

Magento Marketplace Installation.

Google Analytics 4 (GA4) Hyvä Theme Compatibility Addon

The Hyvä Theme frontend is basically built from the ground up, most traditional Magento 2 modules need to be extended to ensure they work properly in conjunction with Hyvä. We provide these adjustments via an addon, which is basically another extension you can install to ensure the full functionality of the Google Analytics 4 PRO module are available with the Hyvä frontend.

Installing the Google Analytics 4 (GA4) Compatibility Addon for the Hyvä Theme

The steps for installing the Google Analytics 4 (GA4) Hyvä Theme Compatibility Addon are the following:

  • Step 1. Make sure you've installed the Google Analytics 4 PRO extension by following the installation steps above.
  • Step 2. Open the Hyvä Theme Compatibility Addon folder and found in the Google Analytics 4 PRO zip file and copy the app folder to the root of your Magento 2 project.
    Note: If you're using Hyvä version 1.1.x, copy the content from the Patches/Hyvä 1.1.x folder into the root of your Magento project and make sure you select the Overwrite option when prompted.
  • Step 3. Enable the addon with the following command:
    php bin/magento module:enable WeltPixel_HyvaGA4
  • Step 4. Upgrade the database and redeploy the static content if necessary.
  • Step 5. Flush all your available caches and you should be done! The addon has no configuration options, once it's installed and enabled, the adjustments will automatically apply and provide the necessary compatibility for the Google Analytics 4 PRO module with the Hyvä Theme.

WATCH THE 10-MINUTE CONFIGURATION VIDEO

HOW TO CONFIGURE GOOGLE ANALYTICS 4 (GA4) WITH GTM SUPPORT.

Step 1.

  • a. Go to Admin > Store > Configuration > Sales > Google API > Google Analytics > and set this option to [ No ].
  • b. Go to Admin > Store > Configuration > Sales > Google API > Google Adwords > and set this option to [ No ].
  • c. Go to WeltPixel > Google Analytics 4 Ecommerce > General Configuration > Enable GA4 and set this option to [ Yes ].
weltpixel
weltpixel

Step 2.

  • You need to create a Google Tag Manager account if you don’t have one already at this link: Google Tag Manager
  • Set up the Account name and the container in your Google Tag Manager account like in the image.

Step 3. HOW TO SET UP GOOGLE ANALYTICS 4 IN MAGENTO 2.

  • Once the account is created get the Google Tag Manager (GTM) scripts in admin section of your Magento 2 store WeltPixel > Google Analytics 4 Ecommerce > General Configuration.

    You need also to get the code for the "<body>" section.

weltpixel
weltpixel
Note: If you already have a Google Tag Manager (GTM) account you can find the script in you Google Tag Manager account in Admin section, as seen in the screenshot.
  • Go to WeltPixel > Google Analytics 4 Ecommerce > General Configuration > Google Tag Manager Javascript Code and paste the code for "<head>" section in your magento store.
  • Then go to WeltPixel > Google Analytics 4 Ecommerce > General Configuration > Google Tag Manager Non-Js Code and paste the code for "<body>" section in your magento store.
weltpixel
weltpixel

Step 4. HOW TO ADD GOOGLE TAG MANAGER AND GOOGLE ANALYTICS 4 TO MAGENTO 2.

  • In Magento admin configure your Google Tag Manager (GTM) API Credentials in order to link your store with your GTM account and generate the default Tags, Triggers and Variables.
  • For this you need to go to WeltPixel > Google Analytics 4 Ecommerce > GTM API Configuration and fill in the Account ID, Container ID and Measurenent ID fields. All this information can be found in your Google Tag Manager and Google Analytics accounts.

  • a) Go to Google Tag Manager (GTM) Identify the IDs in your GTM account like in the picture.
  • b) Go to Google Analytics (GA) You can see how to get your Measurement ID from your Google Analytics account.

    The Measurement ID is available under GA account > Admin > Data Streams > *Select your Stream* > Measurement ID as you can see in the picture.

  • Head back into your Magento Admin section and paste the Account ID, Container ID and Measurement ID into the GTM API Configuration section.
  • Save the configuration.
weltpixel
weltpixel

Step 5

The Tag, Trigger and variable generation works via a JSON generation process. The JSON is generated in Magento based on your settings, after which it's imported into Google Tag Manager.

Note: After making any extension configuration changes, remember to re-generate the JSON and re-import and overwrite the existing GTM container to ensure your settings are picked up by Google.

Generate JSON.

  • Go to WeltPixel > Google Analytics 4 Ecommerce > JSON Export Options , fill in your Public ID (it can be found in your GTM account) and hit the Generate Json for Variables, Triggers and Tags button.

    You will be notified that the JSON has been generated successfully and a Download JSON button will appear. Click the button to download the generated JSON.

Tag Manager Admin.

  • Go to your Google Tag Manager Dashboard and access the Admin section and choose Import Container

weltpixel
weltpixel

Import JSON.

  • Click on the Choose container file button and find your previously generated and downloaded JSON file. Then, choose a workspace (you can choose an existing workspace or create a new one) and an import option.

    When importing your container, you will have the option to merge the imported content with the selected workspace, or overwrite the workspace entirely. Overwriting the selected workspace will remove all your existing tags, triggers and variables in that workspace, and will replace them with the imported container.

Preview and Confirm.

  • After importing the generated JSON, a preview will show up letting you know the number of changes made to the container. There should be Tags, Triggers and Variables created or updated in various amounts depending on your Magento Admin settings. Click on Confirm and you should be done with importing your settings!

weltpixel
weltpixel

Step 6.

  • After all your tags have been created in Google Tag Manager (GTM), go to Google Tag Manager (GTM) account and PUBLISH / SUBMIT all your tags by following the steps from Google Tag Manager.
  • ! NOTE: If the container is not published/submitted in your GTM account, no tracking will be available. Make sure to publish your container.
  • !! NOTE 2: Displaying statistics in your Google Analytics account based on tracked data could take from 30 minutes from 48 hours according to GTM Documentation. However, real time data should be visible right away if your account is correctly set up.

Measurement Protocol Tracking Configuration (PRO VERSION ONLY).

If you have the PRO version, make sure you do the following setup:

  • Enable Measurement Protocol Tracking Configuration: To enable go to Admin -> WeltPixel -> GA4 PRO -> Enable Measurement Protocol Tracking Configuration -> Set to Yes
  • Measurement ID: Ex: G-XCXCCXXC Find this information in Google Analytics 4 -> Admin Settings -> Data Stream -> Open the desired Data Stream -> MEASUREMENT ID (it is the same ID generated in Step 4b)
  • API Secret: Find this information in Google Analytics 4 -> Admin Settings -> Data Stream -> Open the desired Data Stream -> Measurement Protocol API secrets -> create a new API secret key and paste the value into this field
  • Track Events: Select the Events that you need: Purchase / Refund / Sign Up / Login / View Item / View Item List / Select Item / Search / Add to WishList / Add to Cart / View Cart / Begin Checkout / Add Payment Ingo / Add Shipping Info

    Note: If you are using Client Side Tracking in conjunction with Measurement Protocol, make sure that you only track events on one side or another. For example, by having the “purchase” tag enabled on client side as well as via measurement protocol, 1 transaction will be triggered twice and it will result in duplicate transactions. You can check this by going to Google tag Manager -> Tags -> Select the Tags that you added in Track Events and click Pause (example image below)

  • Send User-ID Yes/No - Including the User ID allows for more granular and accurate connection of user counts and behavior across different sessions as well as various devices and platforms.
  • Send User Properties with enabled events Yes/No - If set to Yes, a User Properties object will be sent to Google Analytics for each enabled Measurement Protocol event, containing data that can be used to create Custom Dimensions.
  • Select User Properties to send: Select the User Properties that you want to send to Google Analytics 4: Browser / Browser Version / Platform (Operating System)

    Note:When creating Custom Dimensions for the enabled User Properties, use browser, browser_version and platform in the User Property field.

  • Automatically disable data layer for enabled measurement protocol events: Yes/No - To avoid any chance of duplicate events to be sent, you must choose which event is sent via Measurement Protocol or via Data Layer. By enabling this option we automatically disable Data Layer for enabled Measurement protocol events, therefore even existing GTM tags will not fire because the data layer is not sent.
  • Enable File Log: Yes/No - Enable push data log in ga4.log file
  • Enable Debug Collect: Yes/No Enable push of data to https://www.google-analytics.com/debug/mp/collect
  • Save the configuration.
weltpixel
weltpixel

Note: If you've enabled the Automatically disable data layer for enabled measurement protocol events option, you can skip this step.

  • To avoid duplicate transactions go to your Google tag Manager -> Tags -> Select the Tags that you added in Track Events and Pause each client side event that is also enabled under Track Events section.

  • Note: Ensure you don't disable the main Analytics Tag, labeled WP - GA4, as this tag is required for tracking sessions, page views and other important user metrics.

META (FACEBOOK) PIXEL TRACKING (PRO VERSION ONLY).

If you're running the PRO version of the module, and want to integrate with Meta Pixel, you can do so by following the steps below:

  • Enable Meta Pixel Tracking: To enable go to Admin -> WeltPixel -> Google Analytics 4 eCommerce PRO GTM Settings -> Meta Pixel Tracking -> Set to Yes
  • Meta Pixel Tracking Javascript Code: Get your Meta Pixel Tracking Javascript Code from your Facebook Business Manager account and paste it here. More details about how to find this code can be found in the Meta (Facebook) Documentation.
  • Track Events: Select the Events that you want to track:
    • Purchase
    • AddPaymentInfo
    • AddToCart
    • AddToWishlist
    • InitiateCheckout
    • Search
    • ViewContent
    • ViewCategory
  • Product Identifier [ ID / SKU ]: Choose the Product Identifier type you want to send to Facebook for enabled events.

Save the configuration and flush the Magento Cache.

weltpixel

Success.

  • Woohoo, the extension is configured!

    Note: Your GA and GTM account are now configured with our pre-generated settings and ready to receive valuable information from your Magento 2 store! You can now gather valuable data and take data driven decisions! Congrats!
    Note 2: If you would like to receive even more personalized tracking data, you can always extend your GTM and GA default configurations from your account. If you would like our Google Certified Specialists to help you with that please contact our support for a quote.

General Configuration.

  • Google Tag Manager Javascript Code - The main tracking code for Google Tag Manager. This code is automatically placed in the head section of your Magento store.
  • Google Tag Manager Non-Js Code - The non-Javascript code for Google Tag Manager. This code is automatically placed in the body section of your Magento store.
  • Enable dataLayer frontend Preview/Debug [ Yes / No ] - Set this option to Yes to enable a button which can be used to trigger a preview window on the frontend which shows the current values of the dataLayer and is updated as the dataLayer is updated.
  • IP Address Restriction - Add IP ranges in this field (comma separated) to limit the display of the dataLayer preview to certain IP addresses only. Leave blank for no restrictions.
  • Impression Chunks Size - Allows you to break up the View Item List event payload into smaller chunks. We recommend limiting it to 15.
  • Product identifier [ SKU / ID ] - Choose whether to use the Product ID or the SKU as the product identifier in Google Analytics.
  • Enable Brand - Set this option to Yes if you'd like to send a brand attribute with the product data.
  • Enable Variant - Set this option to Yes if you'd like to send the product variant with the product data.
  • Order Success Page Total Calculation [ Subtotal / Grandtotal ] - Calculates total order value on the Success Page based on the Subtotal or Grand total.
  • Exclude Tax From Transaction [ Yes / No ] - Exclude the tax amount from the purchase event.
  • Exclude Shipping From Transaction [ Yes / No ] - Exclude the shipping amount from the purchase event.
  • Exclude Orders with 0 Value [ Yes / No ] - Set this option to Yes to ensure no purchase event is sent for orders with a value of 0.
  • Exclude Orders By Status [ Yes / No ] - If this option is set to Yes, you'll be able to select a number of statuses for which a purchase event will not be sent. This is useful if you want to exclude transactions that are generated in a certain status, such as Pending, Processing, Canceled, etc
weltpixel
weltpixel
  • Checkout Page Paths - If you're using custom checkout, and the checkout page path is different from the default magento path: 'checkout/index/index', you can list it here to make sure the transaction data is sent to Google Analytics.
  • Success Page Paths - If you're using a custom checkout, and the success page path is different from the default Magento path: 'checkout/onepage/success', you can list it here to make sure the transaction data is sent to Google Analytics.
  • Measure Product Clicks - This option allows ‘Product Click’ tracking on Category and Search pages, as well as on Related, Up-Sell and Cross-Sell product grids. If this option is enabled, it rewrites the Magento_Catalog::product/list.phtml and Magento_Catalog::product/list/list.phtml files. If you're using a custom theme/extension that already rewrites these templates, check out this article for information on how you can make the necessary compatibility adjustments: How to solve GTM compatibility issues
  • Promotion Tracking [ Yes / No ] - Example of usage:
                     <a href="#" data-track-promo-id="PROMOID"
                        data-track-promo-name="PROMONAME"
                        data-track-promo-creative="PROMOCREATIVE"
                        data-track-promo-position="PROMOPOSITION">Content
                     </a>
                  
  • Persistent datalayer expiry time - The specified value represents minutes.
  • Child vs Parent - Choose whether to send the Child or Parent product identifier to Google Analytics.
  • Send all simple products on View Item - Choose whether to send all Simple Configurations for Configurable Products via the View Item event.
  • Use Secure Cookies - Choose whether to use Secure Cookies. This option should only be set to Yes if your whole website is on HTTPS.
  • Load Product List Block - Set this option to Yes only if you're having issues on Category/Search Pages, such as ignored product limit per page settings or incorrect sorting after enabling the extension. This is usually only required if you're using a 3rd party Search Engine or have modifications/customizations applied to the default product listing on Category/Search Pages.
  • Custom Dimension - Customer ID [ Yes / No ] - Send the Customer ID to Google Analytics as a Custom Dimension.
  • Custom Dimension - Customer Group [ Yes / No ] - Send the Customer Group to Google Analytics as a Custom Dimension.
  • Custom Dimension - Page Name [ Yes / No ] - Send the Page Name to Google Analytics as a Custom Dimension.
  • Custom Dimension - Page Type [ Yes / No ] - Send the Page Type to Google Analytics as a Custom Dimension.
  • Custom Dimension - Stock Status [ Yes / No ] - Send the product Stock Status to Google Analytics as a Custom Dimension.
  • Custom Dimension - Reviews Count [ Yes / No ] - Send the product Reviews Count to Google Analytics as a Custom Dimension.
  • Custom Dimension - Reviews Score [ Yes / No ] - Send the product Reviews Score to Google Analytics as a Custom Dimension.
  • Custom Dimension - Sale Product [ Yes / No ] - Send the value of Magento's Sale attribute for the product in question to Google Analytics as a Custom Dimension.

You're able to send up to 5 additional Custom Attributes as Custom Dimensions. For more details about how to use Custom Dimensions, check out this Support Center article: Google Analytics 4 - Using Custom Dimensions

GTM API Configuration.

  • Account ID - Must be set as seen in Step 4 from Configure section
  • Container ID - Must be set as seen in Step 4 from Configure section
  • Measurement ID - Must be set as seen in Step 4 from Configure section
  • I.P Anonymization [ Yes / No ] - Allows website owners to request that all of their users' IP addresses are anonymized. It help website owners comply with their own privacy policies or, in some countries, recommendations from local data protection authorities, which may prevent the storage of full IP address information.
weltpixel
weltpixel

Google Ads conversion tracking.

  • Enable [ Yes / No ] - Enables Google Ads Conversion tracking
  • Send separate dataLayer event for Google Ads Conversion - Set this option to Yes to enable a new dataLayer event for Google Ads Conversions, which will be used as a trigger for the Google Ads Conversion Tracking Tag. This is only required if you find your tag isn't picking up the correct transaction details from the dataLayer. If you change this setting, remember to regenerate and reimport the JSON container into Google Tag Manager.
  • Google Ads Conversion ID - You need a Google Ads account adwords.google.com. Follow the Google documentation on how to find the Conversion ID for Google Ads.
  • Google Ads Conversion Label - Follow the Google documentation on how to find Conversion Label for Google Ads.
  • Google Conversion Currency Code - Fill in the currency used in your Google Ads account. e.g. usd
  • Exclude Orders with 0 value [ Yes / No ] - Orders with value 0.00 can be excluded from conversion tracking if you set this option to Yes.
  • Enable Enhanced Conversions - If set to Yes, the dataLayer will be populated with the Email and Phone Number used in the checkout process, which are sent to Google Ads via the Google Ads Conversion Tracking tag. If you're enabling this feature after the initial configuration, please make sure you regenerate and reimport your Google Tag Manager JSON container file. More details about Enhanced Conversions can be found in the Google Documentation on the topic.
  • Send Enhanced Conversions to Google Analytics 4 - If set to Yes, the Google Analytics 4 Purchase Tag will be supplemented with Enhanced Conversions data, which is then sent over to Google Analytics. More details can be found in Google's Documentation.
  • Enable New Customer Acquisition - If set to Yes, the dataLayer will be populated with the parameters required for New Customer Data Reporting on the Success Page, which you can then send to your Google Ads Conversion Tracking tag. More details about New Customer Data can be found in the Google Documentation on the topic.
  • Purchase Time Period (In Days) - This setting refers to the time (in days) that needs to pass without the customer having completed an order before they're marked as a New Customer again.
  • Enable Cart Data - Set this option to Yes to enable the Cart Data functionality for Google Ads to enhance ad performance with details regarding the products being sold. To find out more about this functionality, check out the Google Documentation on the subject.
  • Feed Country - The country associated with the feed where your items are uploaded. Use CLDR territory codes.
  • Feed Language - The language associated with the feed where your items are uploaded. Use ISO 639-1 language codes.

Google Ads Remarketing.

  • Enable [ Yes / No ] - Enables Google Ads remarketing.
  • Google Conversion Code - Follow the Google documentation on how to find the Conversion Code for Google Ads Remarketing.
  • Google Conversion Label - Follow the Google documentation on how to find the Conversion Label for Google Ads Remarketing.
weltpixel
weltpixel

Troubleshooting.

For details about how to use Google Analytics 4's DebugView to confirm your data is correctly making it into Google Analytics, check out this article on our Support Center: How to preview and monitor Google Analytics 4 events using Debug View?

Preview and debug GTM tags

  • Use GTM Preview functionality
    There are many ways to troubleshoot your GTM setup. However we found that using the GTM preview mode you can quickly and easily troubleshoot your GTM setup regardless of your expertise level. Go to your GTM account and in the top right corner you will see the Preview Button
  • After hitting the Preview Mode button, you will be redirected to the Tag Assistant page where you'll need to input your website's URL.
weltpixel
weltpixel
  • You will then be redirected to your website in a new tab, with a confirmation that the debugger is connected. Switch back to the Tag Assistant tab and you'll be able to view every tag that gets fired here.

Change Log.

What’s new in v.1.14.1 - April 19, 2024

  • New Feature: Added an option that allows for including a new event in the dataLayer called ads_purchase which can be used as a trigger for the Google Ads Conversion Tracking Tag, used in cases in which the tag misses timing.
  • New Feature: Added support for Enhanced Conversions in Google Analytics 4. Previously, this feature was only available for Google Ads, however, Google has since implemented it for Google Analytics as well.
  • New Feature: Added a new configuration option for the Measurement Protocol functionality to allow for sending various User Properties to Google Analytics, which can be used to create Custom Dimensions.
  • New Feature: Extended the New Customer Data reporting functionality for Google Ads to ensure data is sent for Guest Customers as well as Signed-In users.
  • Fixed an issue related to Enhanced Conversions for Google Ads whereby User-Provided variable values were not being mapped properly in the exported JSON.
  • Added adjustments to Meta Pixel View Content event structure for Item IDs (SKUs) to ensure proper event validation in Facebook Ads Manager.
  • Fixed a bug that would sometimes cause an error to be displayed when modifying item quantity in the cart from a small to a large number.
  • Fixed a bug that would sometimes result in item variants being duplicated in the Add to Cart & Remove from Cart event dataLayer.
  • Added adjustments to increase compatibility with custom script insertion/optimization methods, particularly Rocket Javascript.
  • Added performance optimizations related to server-side (Measurement Protocol) View Item List event caching.
  • Added/adjusted Magento Admin configuration option descriptions for improved clarity.
  • Confirmed compatibility with the latest Magento 2.4.7 release, as well as newly released 2.4.6-p5, 2.4.5-p7 & 2.4.4-p8 Security Patches.
  • Confirmed compatibility with PHP 8.3 on the Magento 2.4.7 release. PHP 8.2 is also supported for this Magento version.
  • Added security improvements to the Backend module's license verification process.


What’s new in v.1.12.17 - Jan 12, 2024

  • New Feature: Extended the Enhanced Conversions functionality to include Customer Name & Address details in the dataLayer as well. The required Google Tag Manager variables are automatically created via JSON container import.
  • New Feature: Added a new setting related to the View Item event for Configurable Products, which allows for sending all associated Simple Products alongside the View Item event in one push, via the "items" array.
  • New Feature: Excluded bots from being tracked via the Measurement Protocol. This increases the overall tracking accuracy as requests from the most common bots/crawlers are now prevented from skewing data.
  • New Feature: Extended the Purchase event with a "discount" parameter, which applies whenever a purchased product has a discounted price via coupon, price rule or Special Price.
  • Fixed an error that would be thrown, in some cases, on the frontend when the Meta Pixel Tracking functionality was enabled.
  • Added minor code optimizations/adjustments for increased dataLayer customizability.


What’s new in v.1.12.15 - Dec 14, 2023

  • New Feature: Added support for Google Ads Cart Data, along with a Google Merchant Center integration upon Cart Data configuration. The extension automatically configures the Google Ads Conversion Tracking tag via the JSON container import.
  • New Feature: Extended the New Customer Data functionality to automatically update the Google Ads Conversion Tracking Tag in Google Tag Manager with the new settings via JSON container import.
  • New Feature: Added a new Magento Admin setting specific to the dataLayer Preview functionality that allows for setting specific IP ranges for which to display the dataLayer Preview box.
  • Fixed an error that would be thrown in the Magento Admin when trying to process a refund. This would usually happen when attempting the refund for a product that no longer exists.
  • Added optimizations to account for various caching solutions, including Varnish.
  • Added various optimizations for ADA Compliance.


What’s new in v.1.12.11 - Oct 12, 2023

  • New Feature: New Feature: Extended the New Customer Data functionality for Google Ads to automatically configure the Google Ads Conversion Tracking Tag and create new dataLayer Variables in Google Tag Manager upon JSON container import.
  • New Feature: Added a new admin setting which allows for changing the way the Product List Block is loaded, enhancing compatibility with 3rd party functionality on Category and Search pages.
  • New Feature: Extended the Measurement Protocol functionality to send a hostname property alongside each event, allowing for page location tracking in Google Analytics.
  • Fixed a bug that would prevent the Select Item (Product Click) event from being triggered via Measurement Protocol when the Category name had a " character in it.
  • Fixed a bug that would cause the Impressions Chunk Size setting to be ignored on Search pages for the View Item List client-side event.
  • Implemented changes to Magento Admin setting names and descriptions surrounding Google Ads functionalities for increased clarity.
  • Confirmed compatibility with the latest Magento 2.4.6-p3, 2.4.5-p5 and 2.4.4-p6 releases.


What’s new in v.1.12.9 - Sep 5, 2023

  • New Feature: Added a new dataLayer Debug/Preview functionality, which allows for turning on a special window in the frontend, populated with the current dataLayer contents, for better client-side tracking debugging.
  • New Feature: Added a new option in the Meta Pixel (Facebook Pixel) configuration section that allows for choosing between sending the Product SKU or ID as the identifier for all available events.
  • New Feature: Extended the View Item event firing conditions to include Configurable Product swatch selection changes, which allows for better tracking of individual product variants.
  • New Feature: Extended Magento Multi Shipping Checkout support with Add Payment Info event. This applies to both client-side and server-side tracking implementations.
  • Fixed a bug that prevented event data from being sent to Google Analytics when using a Custom Dimension based on an attribute with a "null" value in that event.
  • Fixed a bug that would prevent the Child vs Parent product tracking functionality from functioning, as reports would always be populated using Parent data.
  • Fixed a bug that would cause a Remove from Cart event to be fired incorrectly when trying to add a product with no available stock to the cart.
  • Fixed a bug that would cause a lack of Category information in the View Item event on instances with multiple stores and Root Categories.
  • Fixed a bug that would cause multiple View Item events to be triggered on Product Pages with Related and Up-Sell Carousels/Grids.
  • Fixed a minor incompatibility with the Subcategories with Images Category Layout functionality in the Pearl Theme.
  • Adjusted Magento Admin Panel Google Ads setting titles and descriptions for increased clarity and legibility.
  • Minor code cleanup and improvements for better alignment with Magento best practices.


What’s new in v.1.12.7 - Jul 26, 2023

  • New Feature: Added a native integration with Google Ads Enhanced Conversions - this feature improves the accuracy of your conversion measurement by sending hashed first party conversion data from your website to Google in a privacy safe way. More details can be found in the Google Documentation on the topic - PRO version only.
  • New Feature: Added support for Google Ads New Customer Data - this feature enables you to send data required in order to create and optimize a new customer acquisition goal in Google Ads. More details can be found in the Google Documentation on the topic - PRO version only.
  • New Feature: Added support for the Magento Multi Shipping Checkout functionality. The extension can now trigger a purchase event for each order generated by the Magento 2 Multi Shipping Checkout, enhancing its tracking capabilities both via frontend (client-side) and Measurement Protocol (server-side) - PRO version only.
  • New Feature: Added a feature that allows you to exclude orders created with specific statuses from being sent to Google Analytics. This is especially useful when importing orders with custom statuses into Magento 2 and you don't want to send them to Google Analytics - PRO version only.
  • Added major performance optimizations by refactoring the method through which the module builds product lists for the view_item_list event. This change improves loading performance on Category and Search pages with large numbers of products displayed per page.
  • Added a minor dataLayer adjustment for the coupon parameter, which is now sent as an empty string even if a coupon is not applied.
  • Implemented minor code optimizations for best practices: removed ObjectManager class dependency.
  • Improved Magento Admin option comments related to Custom Dimensions for increased clarity.


What’s new in v.1.12.5 - Jul 5, 2023

  • New Feature: Added integration with Meta Pixel (formerly Facebook Pixel), allowing you to set up Meta Pixel Tracking for the following events: Page View, Category View, Product View, Add To Cart, Add To Wishlist, Search, Initiate Checkout, Add Payment Info, Purchase - PRO version only.
  • New Feature: The extension can now track orders created via the Magento Admin with Measurement Protocol. When an order is created via the Admin Panel, the extension now triggers a server-side Purchase event with all the order details - PRO version only.
  • New Feature: Implemented a new GA4 cache file handing method which increases performance for very large catalogs. The new method ensures a faster and less demanding cache file deletion process which makes use of a cron job.
  • Fixed an issue that would sometimes result in the Add Payment Info Tag not being fired. This was caused by the speed at which the user was redirected from the Checkout Page to the Success Page.
  • Added an optimization which ensures proper value parameter calculation for the Add to Cart and Remove from Cart events, which now takes into consideration the Quantity that was added/removed.
  • Fixed a bug that would cause item_category/item_list_name parameters to be split up incorrectly when the view_item_list event was triggered on Categories that had slashes in the name.
  • Fixed an issue that would sometimes prevent the server-side Purchase event from being triggered when Cookies were not accepted by the user on the frontend.
  • Fixed a minor admin bug that caused enabled Measurement Protocol events to become unselected when the option was turned off and then back on again.
  • Updated CSP whitelist to account for broader Google domain declarations and prevent frontend CSP warning/error reports.
  • Fixed a bug that would cause an empty view_item_list event to be sent on Categories that contained no visible products.
  • Fixed an error that would sometimes be thrown when trying to add a Configurable Product to the cart from a Wishlist.
  • Added additional error handling on the Checkout Page for increased compatibility with 3rd party integrations.


What’s new in v.1.12.1 - May 30, 2023

  • New Feature: Introduced a refactored dataLayer for Client-Side events, aligning the extension events, as well as Tags, Triggers and Variables with updated Google Documentation recommendations. A reimport of the container JSON is required. More details in this article: Reimporting a Google Tag Manager container - Merge and Overwrite Conflicting Tags, Triggers and Variables.
  • New Feature: Added Sign Up, Login and Search events to the extension's Client-Side tracking capabilities. Previously, these events were only available in the PRO version via the Measurement Protocol functionality.
  • New Feature: Added an option to include custom Checkout Page paths, thereby increasing compatibility with 3rd-party Checkout solutions that change or alter the default Magento Checkout Page path.
  • New Feature: Added a debug flag to the Measurement Protocol that allows events to be displayed in the Google Analytics debugView. Previously, this was only available for Client-Side events.
  • Adjusted the triggering of the Server-Side Purchase event to ensure it happens on the Success Page and not beforehand for increased compatibility with 3rd-party payment solutions.
  • Fixed an issue that would sometimes prevent the add_payment_info event from being triggered Client-Side due to the redirect to the Success Page happening too fast.
  • Fixed an error that would sometimes be thrown when creating a Credit Memo via the Magento Admin when the Measurement Protocol - Refund event was enabled.
  • Fixed an issue that would result in an incorrect Google Ads ecomm_pagetype parameter value being sent on the Checkout page.
  • Fixed a bug that would prevent the Server-Side view_item_list event from being triggered when cookies were not accepted.
  • Added additional PHP 8.2 code validations.


What’s new in v.1.11.19 - March 23, 2023

  • Implemented a solution in the extension's Measurement Protocol functionality to ensure proper Source/Medium Attribution in the Google Analytics 4 Dashboard.
  • Fixed a bug that would result in an error on the frontend when changing the quantity for a Configurable Product in the mini cart or on the Cart Page.
  • Fixed an issue that would prevent the disabling of all events in the Measurement Protocol Admin Settings. One event would always remain selected.
  • Optimized the dataLayer for events containing the item_category parameter. This ensures that product subcategory tree data is properly sent.
  • Fixed a bug that would occasionally prevent certain frontend notification messages from being displayed.
  • Adjusted Magento Admin Custom Attribute settings to allow attributes containing an underscore.
  • Fixed an issue that would prevent Promotion Tracking events from firing.
  • Added Magento Admin comment adjustments for increased clarity.
  • Added additional validations for PHP 8.1.
  • Fixed an error that would sometimes be thrown in the WeltPixel Debugger, depending on various server permissions.
  • Added compatibility with the latest Magento 2.4.6 and 2.4.5-p2 versions.
  • Confirmed compatibility with Hyvä Theme versions 1.1.23 and 1.2.3.


What’s new in v.1.11.17 - Feb 9, 2023

  • Fixed an error that would be thrown when compiling the Magento 2 code via the Command Line Interface. This error was specific to the standard version of the module, and did not affect the PRO version.
  • Fixed an error that sometimes occurred when the default Magento 2 Reviews module was disabled in the Magento core.
  • Added minor README adjustments for improved clarity.


What’s new in v.1.11.15 - Feb 1, 2023

  • New Feature: Updated the functionality for the Add to Cart and Remove from Cart events to account for any cart quantity changes. This ensures an Add to Cart or Remove from Cart event is fired whenever the cart quantity is modified, through whichever means this happens.
  • Added compatibility with the latest Hyva Theme releases, versions 1.2.1 and 1.1.21. For versions 1.1.x, a patch is now required to be applied in order to ensure full functionality. More details about how to apply the patch can be found in the dedicated installation section.
  • Fixed a bug that sometimes prevented the Purchase event from being fired when Measurement Protocol was enabled for certain events, but not for the Purchase event itself.
  • Code cleanup for certain dataLayer events.


What’s new in v.1.11.14 - Jan 10, 2023

  • New Feature: Added full compatibility for Google Analytics 4 PRO with the Hyvä Theme. This is achieved through a compatibility addon provided with the extension. More details in the dedicated installation section.
  • Fixed a bug that would sometimes result in users being redirected to a 404 page when adding a product with Configurable Options to their cart from Cross-Sell carousels.
  • Refactored event dataLayer push for increased adherence to Google Analytics 4 guidelines.


What’s new in v.1.11.11 - Nov 11, 2022

  • New Feature: Extended the Measurement Protocol functionality - It's now possible to send the view_item_list (Impression) event Server-Side. This applies to Category Pages, Search Results Pages, Advanced Search and Upsell/Related Products on Product Pages (PRO version only)
  • New Feature: Extended the Measurement Protocol functionality - It's now possible to send the select_item (Product Click) event Server-Side (PRO version only)
  • New Feature: Added an Admin option that allows you to choose whether to send the User ID when using Measurement Protocol (PRO version only)
  • Fixed an issue whereby the Magento Admin JSON generation process would not generate tags for certain events.


What’s new in v.1.11.9 - October 7, 2022

  • New Feature: Added the possibility of disabling the dataLayer for events sent via Measurement Protocol, which ensures none of the selected events are duplicated - PRO version only
  • Fixed an issue that certain dataLayer variables to be marked as "Other" when using Magento's Move JS to Bottom functionality in conjunction with Full Page Caching.
  • Added various adjustments to Magento Admin setting text for increased clarity.


What’s new in v.1.11.7 - September 1, 2022

  • New Feature: Extended the Child/Parent SKU/ID functionality to apply to Add to Cart and Remove from Cart events as well.
  • Fixed an error related to PHP 8.1 that was thrown when the Google Ads Remarketing functionality was enabled.
  • Fixed an issue that would sometimes prevent Product Impressions from being pushed when using Ajax Pagination.
  • Fixed an error related to PHP 8.1 that occurred when refreshing the Success Page.
  • Performed various code cleanups related to PHP 8.1.
  • Confirmed compatibility with the latest Magento 2.4.5 and 2.4.4-p1 versions.
  • Updated installation/upgrade scripts to use data patches.


What’s new in v.1.11.5 - August 17, 2022

  • New Feature: The Google Analytics 4 PRO extension is now available for purchase, which contains improved and 100% accurate tracking via Measurement Protocol.


What’s new in v.1.11.1 - April 25, 2022

  • New feature: Added the possibility of including custom Success Page URLs with an asterisks to account for dynamic Success Page URLs and increase compatibility with 3rd party Payment Methods.
  • Fixed a bug that, in some cases, caused the default Magento pagination to break on Category Pages when the module was enabled.
  • Fixed an error that occurred when the Impression Chunk Size setting in the Magento Admin was set to 0.
  • Ensured Price and Quantity values are passed as integers via the dataLayer to conform to Google recommendations.
  • Initiated a clear of the dataLayer eCommerce object before a push event to conform with Google recommendations.
  • Added a "value" parameter to the dataLayer for Checkout and View Cart events.
  • Code cleanup: Removed certain unused jQuery/UI elements from the Magento Admin.
  • Fixed an incorrect licensing message on B2B Magento Enterprise instances which would display when an invalid license was entered.
  • Confirmed compatibility with the latest Magento 2.4.4 and 2.3.7-p3 versions as well as PHP 8.1.


What’s new in v.1.10.17 - October 22, 2021

  • Confirmed compatibility with the latest Magento 2.4.3-p1 and 2.3.7-p2 versions.


What’s new in v.1.10.15 - August 31, 2021

  • Fixed an error that was thrown when disabling the Google Tag Manager or Google Analytics 4 extensions before installing other WeltPixel extensions - This issue affected Pearl Theme users only.
  • Added performance optimizations and enhanced compatibility with 3rd party code on Category Pages.
  • Confirmed compatibility with the newly released Magento 2.4.3, 2.4.2-p2 and 2.3.7-p1 versions.
  • Added .localhost as an accepted domain termination for the licensing process.


What’s new in v.1.10.11 - July 7, 2021

  • Fixed an incompatibility with the default Magento 2.4.2 Move JS to Bottom functionality. When enabled, it would change the execution order of events on the Success Page, which sometimes caused missing transactions in Google Analytics.
  • Fixed an issue that caused missing Revenue in Google Analytics 4. Requires a regeneration and reimport of the JSON file into Google Tag Mangager, after which the container needs to be published.
  • Added improvments to the WeltPixel Developer Magento Admin section. Latest Cron Jobs now lists the last 100 executed Cron Jobs.


What’s new in v.1.10.9 - May 18, 2021

  • Fixed a Display Currency discrepancy related to the Add and Remove from Cart events.
  • Confirmed compatibility with the newly released Magento 2.3.7 and 2.4.2-p1 versions.


What’s new in v.1.10.7 - March 26, 2021

  • Added compatibility adjustments with a new Product Labels extension functionality. Requires the WeltPixel Product Labels extension.
  • Added small Magento Admin label adjustments.
  • Adjusted WeltPixel Developer section comments.


What’s new in v.1.10.5 - February 4, 2021

  • Initial release.


weltpixel