GTM Kit Premium 1.7.0
Find out about what's new in our release post.
Added
- Custom product list tracking API. Themes that render product lists themselves, such as JavaScript-rendered grids, search-index results and AJAX carousels, can mark lists and products with data attributes or call a small JavaScript API, and GTM Kit sends view_item_list, select_item and list-attributed add_to_cart for them through its usual consent handling. Lists are sent once per set of products, by default when they scroll into view, and now carry item_list_id. Two template functions build the product data for server-rendered cards and search indexes.
- Cart sync API. Themes that change the cart with their own calls to the WooCommerce Store API can hand each cart response to gtmkit.cart.sync(), and GTM Kit sends add_to_cart and remove_from_cart for what changed, with the net quantity, the value and the full item data, through its usual consent handling. Adds from a tracked product list keep their list attribution, an add already reported through the list API is not reported twice, and nothing is sent on page load or for changes made in another tab. Loads with the custom product list tracking API and shares its cart baseline with the block cart tracking, so a response a theme also hands to the block cart is reported once, with its list attribution.
- Revenue per product list. When a product is added from a tracked custom list, the list is stored with the cart line and copied to the order, so the items of view_cart, begin_checkout, add_shipping_info, add_payment_info and purchase, including the purchase webhook, carry the list the product came from and GA4 can report which lists generate sales. Works with the custom product list tracking setting on. When the same product is added from more than one list the most recent list wins; a filter can keep the first instead.
- Consent from the GTM Kit consent bridge. On stores whose consent banner runs inside Google Tag Manager and reports to GTM Kit through the consent bridge template, the consent stored with the order at checkout now follows the visitor's answer in that banner, so the server-side purchase carries hashed customer details only when advertising consent was given. Requires the GTM Kit consent bridge template, available in the Template Assistant.
- German translation. GTM Kit Premium's settings, notices and order screen are now available in German, alongside Danish and Spanish.
Fixed
- On stores that send the server-side purchase only when the browser does not confirm it, and anonymize webhooks by consent, the anonymized purchase is now also sent for shoppers who denied analytics consent. Previously the browser's confirmation stopped it, so these purchases were missing from the server side.
- The event deferral queue now sends the events it is holding when the visitor leaves the page, so a purchase held for consent on the order confirmation page is no longer lost when the shopper closes the tab before the timeout. Applies to the flush expiry mode. Where the GTM Kit consent bridge is installed, the queue also follows the consent it reports instead of waiting for the timeout.
Changed
- GTM Kit Premium now requires GTM Kit 2.22.0 or later, and will not run until GTM Kit is updated.