Skip to main content

Changelog

2.1.4 (2026-10-09)

Improvements

  • Updating from the old separate Hyvä package (mirasvit/module-gtm-hyva) is now smoother: Composer removes it automatically instead of refusing to install this version until you uninstall it by hand

Fixed

  • The "Download" buttons for the GA4 and Google Ads conversion GTM container files in the admin now respect admin role permissions — previously any logged-in admin user could download them, even without access to the Google Tag Manager settings
  • Fixed a possible error when sending events with Google Ads remarketing enabled, if the remarketing data replaced the event's ecommerce block with an unexpected value
  • Server-side GA4 (Measurement Protocol) requests that Google rejects now report Google's response code and validation messages, instead of throwing an error whose message could expose your GA4 API secret in log files

2.1.3 (2026-09-14)

Features

  • Map shipping_tier and payment_type on the GA4 purchase tag

2.1.2 (2026-08-28)

Fixed

  • Google Ads conversion tracking now records the real order value on purchase instead of a zero-value conversion
  • Google Ads conversion and remarketing tags are no longer blocked on stores with Content Security Policy enabled

2.1.1 (2026-06-16)

Fixed

  • Deliver login, logout, and sign_up GTM events reliably

2.1.0 (2026-06-10)

Improvements

  • Event delivery is now fully handled by the Tag Manager (Mirasvit_Tm) shared data layer — the module's own JS event stack, AJAX cart-response injection and frontend routes were removed
  • Server-side GA4 Measurement Protocol sending refactored into a dedicated API client
  • The module-specific debug toolbar and "GTM logging" option were replaced by the shared Tag Manager debug toolbar and Debug Mode setting
  • Updated remarketing variables in the GTM container import (gtm_conversion.json)
  • Hyva theme is supported out of the box — the separate mirasvit/module-gtm-hyva compatibility extension is no longer needed and must be removed
  • The "Tracking settings" and "Attribute mapping" options moved out of the Google Tag Manager section into the shared Tag Manager (Mirasvit_Tm) section, where they apply to every consumer module. Saved values are migrated automatically on update — please re-check your tracking configuration under Stores → Configuration → Mirasvit → Tag Manager after updating
  • Requires mirasvit/module-tm 1.1.0 or newer

2.0.40 (2026-06-03)

Improvements

  • Google Ads dynamic-remarketing parameters are now part of the same dataLayer.push as the ecommerce event: top-level value and items: id, google_business_vertical next to the GA4 ecommerce block (required by the Google Ads Remarketing tag)
  • Remarketing parameters are now attached to every ecommerce event that carries items (previously view_item only); for purchase, value includes shipping
  • Remarketing logic moved from the TM module to the GTM module
  • The separate remarketing dataLayer.push (product_ids, page_type, total_value) was removed — point the Google Ads Remarketing tag to the top-level value and items instead
  • Replaced the "GTM logging" admin option with a Debug Mode setting and a new on-page debug toolbar

2.0.39 (2026-05-22)

Improvements

  • Add google_business_vertical to dynamic-remarketing dataLayer payload

2.0.38 (2026-05-21)

Improvements

  • Optimized GTM add-to-cart tracking

2.0.37 (2026-05-19)

Improvements

  • Localized to 15 core e-commerce locales (ar, cs, de, es, fr, it, ja, nl, pl, pt-BR, pt-PT, sv, tr, uk, zh-Hans)

2.0.36 (2026-02-13)

Fixed

  • Fixed add_to_cart event not firing on Breeze theme due to incorrect JS initialization pattern

2.0.35 (2026-02-04)

Features

  • Breeze theme support — full GTM tracking now works on Breeze-powered storefronts, including add-to-cart, product impressions, checkout steps, and dataLayer management

2.0.34 (2026-01-30)

Improvements

  • Product variant selection events now push to dataLayer first and fall back to gtag, improving compatibility with GTM container setups

2.0.33 (2026-01-06)

Fixed

  • Fixed incorrect item data in the add_shipping_info event during checkout

2.0.32 (2025-12-23)

Fixed

  • Fixed event values not being converted to store currency, causing incorrect amounts in multi-currency setups

2.0.31 (2025-12-09)

Fixed

  • Fixed incorrect total value in the add_shipping_info checkout event

2.0.30 (2025-12-08)

Improvements

  • Added item details (product name, ID, price) to the add_shipping_info event for richer checkout analytics

2.0.29 (2025-11-18)

Improvements

  • Product data for view_item_list events is now loaded via AJAX, enabling accurate tracking with layered navigation, AJAX pagination, and cached category pages

2.0.28 (2025-09-25)

Improvements

  • Optimized product brand attribute loading — uses direct database reads instead of full product loads, significantly reducing page load time on product-heavy pages

2.0.27 (2025-06-26)

Improvements

  • GTM debug log files now use Magento's filesystem abstraction, enabling compatibility with remote storage (AWS S3, etc.)
  • Improved brand attribute detection logic with better fallback handling

2.0.26 (2025-06-02)

Improvements

  • Improved WCAG 2.2 AA accessibility compliance for GTM container download button in admin

2.0.25 (2025-04-14)

Fixed

  • Fixed select_promotion event using gtag directly instead of pushing to dataLayer, which bypassed GTM container triggers
  • Fixed "Array to string conversion" error when using product description as a custom dimension

Improvements

  • Reorganized admin configuration layout with clearer grouping and descriptions for tracking settings

2.0.24 (2024-12-19)

Fixed

  • Fixed GTM container import files failing to import due to missing container metadata

2.0.23 (2024-10-30)

Improvements

  • Compatibility with Mirasvit GDPR Cookie Consent module — GTM code injection now respects consent preferences

2.0.22 (2024-07-12)

Fixed

  • Fixed search event firing twice on search results pages

2.0.21 (2024-07-12)

Features

  • Search tracking — automatically tracks search queries as search events
  • Sign-up tracking — tracks new customer registrations as sign_up events

2.0.20 (2024-07-10)

Fixed

  • Fixed "InvalidArgumentException: Either remote URL or hashable content is required" error when CSP is enabled but the GTM Regular Code field is left empty

2.0.19 (2024-07-02)

Fixed

  • Fixed add_to_cart event incorrectly firing after view_cart when Magento's "Redirect to Shopping Cart" setting is enabled

2.0.18 (2024-07-02)

Improvements

  • Added Content Security Policy (CSP) nonce support for inline GTM scripts
  • Compatibility with Aheadworks OneStepCheckout

Fixed

  • Fixed compatibility with Magento 2.3
  • Fixed JavaScript error on configurable product pages when all variants are out of stock

2.0.17 (2024-06-07)

Improvements

  • Admin-placed orders now include utm_source and utm_medium parameters (set to "Backend" / "Customer service") for attribution tracking

2.0.16 (2024-06-05)

Improvements

  • ⚠️ Moved shared JS event handling to the module-tm base module — requires mirasvit/module-tm = 1.0.11

2.0.14 (2024-05-27)

Features

  • UTM parameters on admin orders — orders placed from the admin panel now include utm_source and utm_medium custom dimensions for backend attribution

2.0.13 (2024-05-17)

Fixed

  • Fixed "customerId must be of type int, null given" error when tracking admin-placed orders for guest customers

Features

  • Brand tracking setting — added configurable catalog brand attribute selection in admin

2.0.12 (2024-05-10)

Features

  • Server-side admin order tracking — orders placed through the admin panel are now tracked via GA4 Measurement Protocol

Improvements

  • ⚠️ Moved catalog page view event tracking to the module-tm base module

2.0.11 (2024-04-26)

Fixed

  • Fixed product custom option prices not being included in item prices for cart and checkout events

2.0.10 (2024-04-05)

Fixed

  • Fixed add_to_cart event not firing on Hyva theme
  • Fixed brand not being tracked for child products of configurable items
  • Fixed product prices in cart/checkout events not including selected option prices

2.0.9 (2024-04-01)

Fixed

  • Minor stability improvements

2.0.8 (2024-03-28)

Improvements

  • Added enhanced conversion data (user email, phone, address) to the purchase event for Google Ads Enhanced Conversions

Fixed

  • Fixed Unicode characters being stripped from item_brand values

2.0.7 (2024-03-19)

Improvements

  • Product variant selection on the product page is now tracked with preselected swatch values
  • Guest customer email is now included in conversion events for enhanced conversion matching

Fixed

  • Fixed custom product attributes displaying question marks instead of special characters for non-Latin locales
  • Fixed user properties not being pushed to dataLayer for add_to_cart, shipping, and payment events

2.0.6 (2024-03-01)

Improvements

  • Google Consent Mode v2 compatibility — GTM scripts respect consent state for analytics and ad storage

2.0.5 (2024-02-15)

Improvements

  • Added GDPR cookie consent integration — GTM tracking respects consent preferences when GDPR module is active

2.0.4 (2023-12-27)

Fixed

  • Fixed refund tracking not working per store view — refund scope now respects multi-store configuration

2.0.3 (2023-11-28)

Fixed

  • Fixed coupon code not being included in the add_shipping_info checkout event

2.0.2 (2023-11-22)

Fixed

  • Fixed duplicate add_to_cart events firing on product pages

2.0.1 (2023-10-25)

Fixed

  • Fixed "Track Variants" configuration option not being applied correctly

2.0.0 (2023-10-17)

Improvements

  • ⚠️ Major refactoring — Facebook Pixel tracking has been moved to a separate module-facebook-pixel module. If you use Facebook Pixel, install the new module after upgrading.
  • ⚠️ Removed legacy block classes (BeginCheckout, Purchase, ViewCart, ViewList, ViewProduct) — event data is now generated centrally via GtmDataConverter
  • ⚠️ Removed PixelConverter, DataLayer, DataProvider, Registry, and cart/wishlist plugins — functionality consolidated into the TM base module
  • Simplified configuration with fewer admin settings

1.2.61 (2023-10-12)

Fixed

  • Fixed prices not being tracked for configurable products

1.2.60 (2023-08-24)

Improvements

  • Added price and special_price as available item values in Custom Dimensions and Metrics mapping

Fixed

  • Fixed events tracking the final (discounted) price instead of the original product price

1.2.59 (2023-08-18)

Improvements

  • ⚠️ Removed GA3 (Universal Analytics) support — only GA4 is now supported. The GA3 container import button and UA converter have been removed.
  • Significantly faster product attribute collection on category and cart pages
  • Improved debug log formatting

Fixed

  • Fixed "str_replace(): Argument 3 must be of type array|string, Phrase given" error
  • Fixed double tracking of payment and shipping events on AJAX-powered checkouts

1.2.58 (2023-07-13)

Fixed

  • Fixed custom attribute mapping not working correctly for category-level attributes

1.2.57 (2023-07-06)

Fixed

  • Fixed conflict with Amasty GDPR extension causing GTM code not to load

1.2.56 (2023-06-21)

Fixed

  • Fixed product discount values not being calculated correctly in cart and checkout events

1.2.55 (2023-06-19)

Fixed

  • Fixed missing value and currency fields in the view_item event on product pages

1.2.54 (2023-06-07)

Fixed

  • Fixed Facebook Pixel code incorrectly replacing GTM code in page output

1.2.53 (2023-06-01)

Features

  • Refund tracking — automatic refund tracking via GA4 Measurement Protocol with CLI command and cron support

Fixed

  • Fixed GTM container settings file download not working for non-default websites

1.2.52 (2023-05-23)

Fixed

  • Fixed encoding issues for non-Latin characters (Cyrillic, CJK, etc.) in tracked product data
  • Fixed GTM code loading in the wrong position when "Move JS code to the bottom of the page" is enabled

1.2.51 (2023-04-20)

Fixed

  • Minor stability improvements

1.2.50 (2023-04-14)

Improvements

  • Added store-level variables (store name, store code, website name) to Custom Dimensions and Metrics mapping

Fixed

  • Fixed product quantity always showing as 1 in the view_item event

1.2.49 (2023-03-23)

Fixed

  • Fixed JavaScript error "TypeError: Cannot read properties of undefined" on product pages with swatches

1.2.48 (2023-03-01)

Improvements

  • Compatibility with MageBig QuickView and Ajaxcartpro extensions

Fixed

  • Fixed customer group not being tracked in events
  • Fixed Product SKU mapping returning incorrect values in attribute mapping

1.2.47 (2023-02-13)

Improvements

  • Added order subtotal as an available field in attribute mapping

Fixed

  • Fixed tax and shipping values being sent as strings instead of numbers in the purchase event

1.2.46 (2023-01-23)

Fixed

  • Fixed add_to_cart event not firing reliably when products are added to cart

1.2.45 (2022-12-26)

Improvements

  • Added order-level attributes (order ID, status, payment method, etc.) to the purchase event via attribute mapping

1.2.44 (2022-12-07)

Features

  • Dynamic Remarketing — added Google Analytics Dynamic Remarketing event tracking for product and category pages

Fixed

  • Fixed incorrect discount value calculation in cart events
  • Removed unnecessary product_id field from event data

1.2.43 (2022-12-05)

Fixed

  • Fixed Facebook Pixel sending incorrect content_type for configurable products — now correctly sends product_group

1.2.42 (2022-11-29)

Fixed

  • Fixed tax not being included in the total value for the add_payment_info checkout event

1.2.41 (2022-11-17)

Fixed

  • Fixed Region Code custom dimension returning empty values
  • Fixed brand attribute showing raw option value instead of the human-readable label

1.2.40 (2022-11-08)

Fixed

  • Fixed compatibility with PHP 7.1

1.2.39 (2022-11-01)

Improvements

  • Compatibility with Plumrocket AMP extension — GTM output is automatically disabled on AMP pages

Fixed

  • Fixed product variant tracking in Universal Analytics (GA3)

1.2.38 (2022-10-31)

Improvements

  • Compatibility with Plumrocket AMP extension — added AMP detection service to prevent GTM conflicts

1.2.37 (2022-10-31)

Improvements

  • Added new_customer parameter to the purchase event, allowing you to distinguish first-time buyers in analytics

1.2.36 (2022-10-04)

Improvements

  • Added selected shipping method name to the add_shipping_info event

Fixed

  • Fixed product attribute values not resolving correctly in custom dimension mapping

1.2.35 (2022-09-30)

Fixed

  • Fixed payment method not being tracked in GA4 events when Facebook Pixel is also enabled

1.2.34 (2022-09-20)

Fixed

  • Fixed Facebook Pixel firing duplicate purchase events

1.2.33 (2022-09-16)

Fixed

  • Fixed product quantity always showing as 1 in the view_item event

1.2.32 (2022-09-15)

Fixed

  • Fixed list name and position values missing from the view_item_list event in Universal Analytics

1.2.31 (2022-09-12)

Fixed

  • Fixed "Undefined variable: contentIds" error in Facebook Pixel converter on certain page types

1.2.30 (2022-09-06)

Fixed

  • Added missing content_type, id, and content_ids parameters to Facebook Pixel events
  • Fixed set_user_properties event not firing on page load

1.2.29 (2022-09-01)

Fixed

  • Fixed cart item removal events being incorrectly triggered in GraphQL API requests

1.2.28 (2022-09-01)

Improvements

  • Added add_payment_info and add_shipping_info event triggers to the GA4 GTM container import file

1.2.27 (2022-08-11)

Fixed

  • Fixed Universal Analytics category tracking not sending correct category data

1.2.26 (2022-08-04)

Features

  • Track catalog page views — new option to enable/disable view_item_list tracking on category pages

Improvements

  • Compatibility with Swissup PageSpeed module — GTM scripts work correctly with deferred JS loading

1.2.25 (2022-07-21)

Improvements

  • Added Google-related domains to the CSP whitelist to prevent Content Security Policy errors

Fixed

  • Fixed "Call to undefined method getUsedProducts()" error on simple product pages

1.2.24 (2022-07-21)

Improvements

  • Product variant selection via swatches is now tracked — changing color, size, or other options updates the tracked product data in real time

1.2.23 (2022-07-14)

Fixed

  • Fixed category data missing from cart events (add_to_cart, view_cart, begin_checkout)
  • Fixed GTM scripts loading on AMP pages where they don't function

1.2.22 (2022-07-05)

Fixed

  • Fixed tracking using base currency prices instead of store view prices for add_to_cart events

1.2.21 (2022-06-23)

Features

  • GTM debug logging — new admin option to log all GTM dataLayer pushes to a file for troubleshooting

Improvements

  • Added "Attribute Set" as an available product dimension in custom mapping

1.2.20 (2022-06-20)

Fixed

  • Fixed product variants not being tracked correctly in cart events

1.2.19 (2022-06-06)

Fixed

  • Fixed "Return value must be of type string, null returned" error when a product has no brand attribute set

1.2.18 (2022-05-26)

Fixed

  • Fixed tracking base price instead of the actual cart price (including options) for add_to_cart events

1.2.17 (2022-05-11)

Fixed

  • Fixed "Undefined index: gtm_id" error on the purchase confirmation page

1.2.16 (2022-05-09)

Improvements

  • Redesigned add_to_cart tracking — events now fire reliably via customer data sections instead of plugin-based approach, fixing issues with cached pages

1.2.15 (2022-05-03)

Fixed

  • Fixed compatibility with Klarna Checkout — purchase event now tracks correctly on Klarna's success page

1.2.14 (2022-04-29)

Fixed

  • Added Content Security Policy (CSP) whitelist rules for Google Tag Manager domains

1.2.13 (2022-04-25)

Fixed

  • Fixed GTM settings not saving correctly at the store view scope level

1.2.12 (2022-04-21)

Fixed

  • Fixed product and variant ID resolution for configurable products in cart and checkout events

1.2.11 (2022-04-20)

Improvements

  • Added customer and address attributes from the attribute mapping to the purchase event, enabling richer customer data in analytics

1.2.10 (2022-04-20)

Fixed

  • Fixed GTM container import configuration working only at the default scope — now supports website-level imports

1.2.9 (2022-03-25)

Fixed

  • Fixed checkout behavior tracking — payment and shipping step selection events now fire correctly

1.2.8 (2022-03-15)

Fixed

  • Fixed incorrect price calculation for bundle products in checkout events

1.2.7 (2022-03-14)

Fixed

  • Fixed remove_from_cart event not firing when items are removed from the shopping cart

1.2.6 (2022-01-19)

Improvements

  • Added Google Ads Conversion and Remarketing tag configurations to the GTM container import file

1.2.5 (2021-12-29)

Improvements

  • Added customer attributes as available dimensions in the attribute mapping — track customer group, company, or any custom attribute

Fixed

  • Fixed Google Ads settings not saving correctly in admin configuration

1.2.4 (2021-12-06)

Fixed

  • Fixed "Return value of getConversionId() must be of the type string, null returned" error when Google Ads Conversion ID is not configured

1.2.3 (2021-12-03)

Features

  • Google Ads conversion tracking — added purchase conversion event for Google Ads with configurable Conversion ID and Label

Fixed

  • Fixed GTM code being injected on admin (backend) pages

1.2.2 (2021-11-30)

Fixed

  • Fixed Universal Analytics (GA3) event tracking not sending data correctly for checkout and cart events

1.2.1 (2021-11-23)

Features

  • One-click GTM container setup — download pre-configured GA3 and GA4 container JSON files and import them directly into Google Tag Manager

1.2.0 (2021-11-19)

Improvements

  • ⚠️ Replaced "Measurement IDs" configuration with "GTM Regular Code" setting — update your configuration after upgrading

1.1.0 (2021-11-15)

Improvements

  • Added "Measurement IDs" configuration option for direct GA4 measurement

Fixed

  • Fixed "Array to string conversion" error when tracking products with multi-select attributes

1.0.2 (2021-11-09)

Features

  • Facebook Pixel integration — added Facebook Pixel analytics tracking for all ecommerce events (page view, product view, add to cart, purchase)

1.0.1 (2021-07-12)

Features

  • Initial release