GTM Kit - Google Tag Manager & GA4 integration
| 开发者 |
tlamedia
torbenlundsgaard gtmkit |
|---|---|
| 更新时间 | 2026年6月3日 14:28 |
| 捐献地址: | 去捐款 |
| PHP版本: | 6.8 及以上 |
| WordPress版本: | 7.0 |
| 版权: | GPLv3 |
| 版权网址: | 版权信息 |
标签
下载
2.13.0
2.14.1
1.14.2
1.2
2.3.1
1.23.2
1.23.3
1.16.2
2.3.0
2.0
1.1.1
1.17.2
1.22.1
1.22.4
1.23.1
1.4.3
1.6.1
1.5.1
1.5.2
1.5.3
1.8
1.4.2
1.4.5
1.3.2
1.4.1.1
1.10
1.12.1
1.13.1
1.3.1
1.0
1.12.2
1.13.2
1.3
1.15
1.16
1.16.1
1.7.1
1.12
1.17.1
1.2.1
2.2.2
1.17
1.19
1.20
1.21
1.22
1.6
1.7
1.9
2.0.1
1.1
1.4
1.18
2.4.2
2.5.1
2.6.0
1.14
1.14.1
1.18.1
1.3.3
1.4.1
1.5
1.6.2
2.3.2
2.4.1
2.8.0
2.8.4
1.19.1
2.10.0
2.4.4
2.7.0
2.8.1
2.9.0
1.22.3
2.11.0
2.12.0
2.2.0
2.2.1
2.5.0
2.8.2
2.8.3
1.11
1.11.1
1.13
1.23
1.4.4
2.1.0
2.13.1
2.14.0
2.4.0
2.4.3
详情介绍:
GTM Kit puts the Google Tag Manager container code on your website so that you don't need to touch any code. It also pushes data from WooCommerce, Easy Digital Downloads (EDD) and Contact Form 7 to the data layer for use with for Google Analytics 4, Facebook and other GTM tags.
The goal of GTM Kit is to provide a flexible tool for generating the data layer for Google Tag Manager. It is easy to use and doesn't require any coding, but it allows developers to customize the plugin as needed.
eCommerce events tracked with Google Analytics 4
The following GA4 events are automatically included in the dataLayer:
WooCommerce
- view_item_list
- select_item
- view_item
- add_to_wishlist [Premium]
- add_to_cart
- view_cart
- remove_from_cart
- begin_checkout
- add_shipping_info
- add_payment_info
- purchase
- refund [Premium]
- order_paid [Premium] Unlock all features with GTM Kit Woo Add-On.
- view_item
- add_to_cart
- begin_checkout
- purchase
- Post type: include the type of the current post or archive page.
- Page type: include a defined page type. I.e. post, page, product, category, cart, checkout etc.
- Categories: include the categories of the current post or archive page.
- Tags: include the tags of the current post or archive page.
- Post title: include the post title of the current post.
- Post ID: include the Post ID of the current post.
- Post date: include the post date.
- Post author name: include the post author name.
- Post author ID: include the post author ID.
安装:
- Install GTM Kit either via the WordPress.org plugin repository or by uploading the files to your server.
- Activate the plugin through the 'Plugins' menu in WordPress
- Enter your GTM Container ID and click 'Save changes'.
屏幕截图:
常见问题:
Where do I get a GTM Container ID?
Create an account and container in Google Tag Manager and get it there.
Is Google Analytics 4 (GA4) supported?
Yes! We strive to support the full feature set of Google Analytics 4 and will implement any future features of Analytics 4.
Is this plugin cache friendly?
Yes! Pagespeed is one of our main focus points, and we strive to make the plugin compatible with full page caching.
How can I report security bugs?
You can report security bugs through the Patchstack Vulnerability Disclosure Program. The Patchstack team help validate, triage and handle any security vulnerabilities. Report a security vulnerability.
更新日志:
2.14.1
Release date: 2026-06-03
A maintenance fix for the 2.14 line; see the 2.14 release post for what 2.14 introduced.
Bugfixes:
- WooCommerce block tracking now loads on block (FSE) themes where Cart, Checkout, Mini Cart, Product Collection, or Related Products are rendered from block templates and template parts. Previously the block tracking bundle could fail to load on these sites, so block ecommerce events never fired.
- New "Engagement events" settings section emits GA4 standard
login,sign_up,search, andgenerate_leadevents out of the box. Each event has its own toggle and defaults to on, so customers see the events the moment they upgrade. - Rebuilt WooCommerce block tracking on stable data-store APIs. Cart, Checkout, Mini Cart, All Products, Product Collection, Single Product, Related Products, the Cart block cross-sells, and product filter blocks now all emit ecommerce events end to end, including add_to_cart and view_cart from the Mini Cart, list and select tracking for the All Products grid and cart cross-sells, and view_item_list re-fires when a filter or pagination control updates a Product Collection.
- The Contact Form 7 integration now loads reliably on form pages when "Load JavaScript" is set to the recommended "Only on pages where the Contact Form 7 script is registered" mode, even when a performance plugin (e.g. WP Rocket) defers Contact Form 7's own scripts until shortcode render. Previously the integration could be skipped on legitimate form pages and
gtmkit.CF7MailSentwould not fire.
- New developer filters let extensions tag the method, normalise the search term, assign a lead value, rename the handoff cookie, veto any event, or opt custom search templates into the
searchevent. - New
gtmkit_blocks_supportedfilter lets developers add custom block names to the list that loads GTM Kit's block tracking. - Raised the minimum WooCommerce version to 10.3 for the new block tracking integration. Sites on earlier WooCommerce continue to receive classic-template tracking unchanged.
- Added Vitest and Playwright test harnesses covering the block tracking path, plus PHPUnit coverage for the block detection and Store API extension.
- Prepare the settings and setup-wizard bootstrap for React 19, which WordPress will ship in a future release. No behaviour change under the current React 18.
- The "Exclude pages from GTM" feature now also holds back the WooCommerce, Contact Form 7, and Easy Digital Downloads tracking scripts on excluded pages. Previously those add-on scripts could still load on an excluded page and fail, because the core GTM Kit runtime they rely on was withheld there.
- New "Exclude pages from GTM" section on the Container settings page lets you list URL patterns where GTM Kit should stay off. Useful for third-party checkout iframes, partner-hosted subpages, or in-app webview routes that have their own tracking.
- New
window.gtmkit.events.push()helper now sits in front of every GTM Kit event push, so an add-on can defer consent-sensitive events in the browser without server-side suppression.
- The existing
gtmkit_container_activefilter now receives the actual computed container-active value instead of a hardcodedtrue, so callbacks that return the value through unchanged automatically honor the new URL exclusion. - PHP-rendered initial dataLayer content is now emitted through the same client helper, so deferral works the same on full-page-cached and uncached pages.
- New welcome modal greets fresh installs on their first GTM Kit admin page and links to the documentation. Existing installs are not interrupted.
- GTM Kit can now surface launch and upgrade announcements from gtmkit.com without a plugin release.
- Prevent a fatal error on WooCommerce shop and archive pages when another plugin (e.g. WP Grid Builder) re-runs the product loop without a current product in context. GTM Kit now skips its hidden product-data tag instead of crashing the page.
- No more "headers already sent" PHP warning when running WP-CLI commands on sites that use the Cookie Keeper option.
- New
gtmkit_introductionsfilter andIntroduction_Interfacecontract let add-ons register their own announcement modals through a documented public API.
- "Exclude tax" toggle now controls every standard e-commerce event the data layer emits:
view_cart,begin_checkout,purchase, variation prices on variable product pages (re-firedview_item+add_to_cart), and the per-item coupondiscountfield.
- Cart, checkout, variation, and coupon-discount events now follow the "Exclude tax" toggle consistently across
value,price, anddiscountfields. The GTM Kit Woo and GTM Kit Premium add-ons extend the fix to refund and order-paid events in their paired releases. - Silence the "translation loading triggered too early" notice that WordPress 6.7+ logs against the
gtm-kittext domain by registering translations at the very start ofinitbefore any other code can request a translated string. - Close an edge case where a script-dependency notice could still appear under WordPress 6.9.1+ when a consent or CMP plugin toggled the GTM Kit container active mid-request, by asking the WordPress script registry directly which scripts were actually registered instead of re-evaluating the container gate.
- Heads up: GA4 numbers may move after this update. Stores with prices entered ex-tax and tax-inclusive cart display will see
valuechange from ex-tax to inc-tax in cart and checkout events. - New
gtmkit_resolve_tax_modeandgtmkit_resolve_item_discountfilters let developers override the toggle programmatically (per-event or per-context) and override the per-item coupon discount calculation. - Minimum required WordPress version is now 6.8 (was 6.7). Sites still on WordPress 6.7 won't get this update via the dashboard until they upgrade WordPress.
- New
gtmkit_consent_admin_badgesfilter lets add-ons (e.g. Premium's WP Consent API integration) push status banners onto the Consent settings page so users see immediately when a higher-priority consent source has taken over.
- New "CMP script attributes" section on the Consent settings page lets you toggle Cookiebot, Iubenda, and CookieYes script-blocking attributes with one click and add a custom attribute for any other CMP — no PHP filters required.
- Fresh installs auto-detect a known CMP plugin (Cookiebot, Iubenda, CookieYes) and pre-select the matching toggle so the right attribute is on from day one.
- New "Script gating" mode on the Consent settings page lets you choose between always loading GTM, letting it load under Consent Mode v2 control, or holding it back entirely until consent is granted. Default stays as "Always load" so existing installs see no change.
- Strong-block mode masks the Google Tag Manager container until visitors consent. Works alongside any CMP and falls back gracefully when no consent signal arrives.
- Power users can override which consent categories must be granted before strong-block mode unmasks GTM via the new
gtmkit_strong_block_required_categoriesfilter. window.gtmkit.consent.stateexposes the current consent state so partner scripts and integrators can inspect it without subscribing to events.- New developer hooks let CMP integrations and consent add-ons plug into GTM Kit's consent flow without forking the plugin — sites running Cookiebot, CookieYes, WP Consent API or in-house consent solutions can now feed their state straight into GTM Kit.
- Server-side broadcast
gtmkit_consent_updatedso other plugins can react to consent state changes without polling. - Per-event
gtmkit_event_should_deferfilter so future deferral features can hold individual events back when consent is missing.
- Eliminate "dependencies that are not registered: gtmkit-container" warnings logged by WordPress 6.9.1+ on sites that have GTM Kit's container active.
- The Cookiebot script attribute (
data-cookieconsent="ignore") is now configurable via Settings → Consent → CMP script attributes. Existing installs keep the attribute on by default to preserve current behavior; turn it off explicitly if you do not use Cookiebot.
- Scope Google Consent Mode defaults to specific countries or regions (e.g. DK, DE, US-CA) instead of applying them everywhere. Useful for sites with visitors both inside and outside the EU.
- Consent updates from other plugins or partner scripts can now talk to GTM Kit through a simple JavaScript API, making CMP integrations easier.
- Webhooks for Server-side Tracking on the WooCommerce integrations page no longer stay locked after entering an sGTM Container Domain on premium installs.
- "Wait For Update" is now a proper number field with a sensible 500 ms default on new installs. Your existing value is kept.
- Clearer warning on the Consent Mode page — if Cookiebot, Complianz, CookieYes, or Cookie Information already handles your consent, leave this setting off.
- Introduced an internal automated test suite (PHPUnit + Vitest) and continuous integration across PHP 7.4–8.4 × WordPress 6.9. No functional change — every future release is now verified by unit and integration tests before shipping, raising the bar on quality and reliability.
- Declared compatibility with WooCommerce Product Object Caching (
product_instance_caching) introduced in WooCommerce 10.5. No functional change; resolves the "incompatible plugins" notice in WooCommerce → Settings → Advanced → Features. - Tested up to WooCommerce 10.7.
- Tested up to WordPress 7.0.
- Fix: Add error handling to WooCommerce blocks action handlers to prevent tracking errors from breaking checkout functionality or interfering with third-party plugins.
- Tested up to WooCommerce 10.6.
- Fix undefined array key warning for order-received query var in edge cases like certain payment gateway redirects or bot traffic.
- Fixes correct detection of the premium plugin.
- Improved internal handling of plugin settings to make GTM Kit more reliable and easier to maintain, while ensuring full backward compatibility with existing configurations.
- Tested up to WooCommerce 10.5.
- Require WooCommerce 9.5.