Google Tag Manager (GTM) is Google’s free tool for everyone to be able to manage your analyitcs, PPC and other code snipets
using an intuitive web UI. To learn more about this tool, visit the official website.
This plugin can place the necessary container code snippet into your website so that you do not need to add this manually.
Multiple containers are supported!
The plugin can support your GTM setups by adding lots of meta data about the visited page and about the user into the so called data layer.
GTM help center incluldes more details about this data layer.
Some parts of the plugin requires PHP 5.3 newer.
PHP 5.4 or newer is recommended.
Please note that PHP 5.x is nearing its end of life cycle thus it is recommended to upgrade. If you are not sure which version you are using, please contact
your hosting provider for support.
GTM container code placement
GTM container code snippet is currently divided into two parts: the most important part will be added to the tag of your website every time. The second part is
performance this should be just after the opening body tag but it might be also safe to use the footer option in plugin settings as the worst case.
Yaniv Friedensohn showed me a solution that can add the GTM container code after the opening body tag
for almost every theme without modifying the theme files:
I added this solution to the plugin, currently as an experimental option.
Users of the Genisis Framework should use the “Custom” option but without altering the theme.
The Google Tag Manager container code will be added automatically.
Basic data included
- post/page titles
- post/page dates
- post/page category names
- post/page tag names
- post/page author ID and names
- post/page ID
- post types
- post count on the current page + in the current category/tag/taxonomy
- logged in status
- logged in user role
- logged in user ID (to track cross device behavior in Google Analytics)
- logged in user email address (to comply with GTM terms of service do not pass this towards Google tags)
- search data
- site name and id for WordPress multisite instances
Browser / OS / Device data
- browser data (name, version, engine)
- OS data (name, version)
- device data (type, manufacturer, model)
Data is provided using the WhichBrowser library: http://whichbrowser.net/
Add the current weather conditions into the dataLayer so that you can use this information to generate special
remarketing lists and additional segmentation in your web analytics solution:
- weather category like clouds, rain, snow, etc.
- weather description: more detailed data
- temperature in Celsius or Fahrenheit
- air pressure
- wind speed and degrees
Weather data is queried from Open Weather Map. Depending on your websites traffic, additional fees may be applied:
It is also required to obtain a free API key from OpenWeatherMap on the page above.
To determine to current location of your visitor, this plugin uses geoplugin.net.
Depending on your websites traffic, additional fees may be applied:
Media player events
The plugin can track user interaction with your embeded media:
It fires dataLayer events when a media player was being loaded on the page, when the media is being played, paused or stopped.
It can fire dataLayer events when the user reaches 10, 20, 30, …, 90, 100% of the media duration.
Tracking should work with embedded media using the oEmbed feauture of WordPress and it should also work with other plugins or even with copy/pasted codes.
Currently, players injected into the website after page load are not being tracked.
Fire tags based on how the visitor scrolls from the top to the bottom of a page.
You can track this as Analytics events and/or fire remarketing/conversion tags to if you want to track micro conversions.
Separate readers (who spend a specified amount of time on a page) from scrollers (who only scroll through within seconds)
Scroll tracking is based on the solution originally created by
- Nick Mihailovski
- Thomas Baekdal
- Avinash Kaushik
- Joost de Valk
- Eivind Savio
- Justin Cutroni
Google AdWords remarketing
Google Tag Manager for WordPress can add every dataLayer variable as an AdWords remarketing custom parameter list.
Using this you can create more sophisticated remarketing lists.
Blacklist & Whitelist Tag Manager tags and variables
To increase security on your website, you can whitelist and blacklist tags and variables.
This means you can disable certain tags from being fired or prevent the use of certain variable types
from being used regardless of your current Tag Manager setup.
If your Google account is being hacked that is associated with your Google Tag Manager account,
an attacker could easily execute malware on your website without accessing its code on your hosting server.
if you do not use those kind of elements.
Google Tag Manager for WordPress can integrate with several popular plugins.
- Contact Form 7: fire an event after a successful form submission
- Classic e-commerce:
- fire event when visitors ads a product to your cart
- include transaction data to be sent to Google/Universal Analytics
- include necessary remarketing tags for Google AdWords Dynamic Remarketing
- Enhanced e-commerce (beta):
- implementation of Enhanced E-commerce
- Does not include tracking of promotions since WooCommerce does not have such a feature (yet)
- Does not currently support refunds
- Classic e-commerce:
More integration to come!
- How can I …
I created some step by step guides so that you can create the proper settings in Google Tag Manager:
- PayPal / 3rd party payment gateway transactions in WooCommerce are not being tracked in Google Analyics
PayPal and some other 3rd party payment gateways does not redirect the user back to your website by default
after a successful transaction.
It offers the route back for your customer but it can happen that users simply close the browser
before they get back to your thankyou page (aka. order received page)
This means that neither Google Analyics tags or any other tags are being fired.
Enable auto return in your payment gateway settings. This will instruct them to show a quick
info page after payment and then redirect the user back to your site. This will
increase the number of tracked transactions.
- Why isn’t there an option to blacklist tag/variable classes
Although Google recommends to blacklist tags and variables using classes, I found it is complicated for people to understand
what tags and variables are being blacklisted/whitelisted automatically using classses. Therefore I decided to include
individual tags and variables on the blacklist tabs.
Please remember that tags are useless without variables so only blacklist variables if you are certain that you do not use them
with any tags in your container.
- How can I track scroll events in Google Tag Manager?
To track scrolling of your visitor you need to setup some tag in Google Tag Manager.
What type of tags?
In most cases you will need Google/Universal Analytics event tags but you can use AdWords remarketing
or conversion tags as well to collect micro conversions or to focus only on visitors who spend more time
reading your contents.
There are five dataLayer events you can use in your rule definitions:
- gtm4wp.reading.articleLoaded: the content has been loaded
- gtm4wp.reading.startReading: the visitor started to scroll. You can use the dataLayer variable
timeToScrollto see how many seconds have passed since the article has been loaded
- gtm4wp.reading.contentBottom: the visitor reached the end of the content (not the page!).
timeToScrolldataLayer variable updated
- gtm4wp.reading.pagebottom: the visitor reached the end of the page.
timeToScrolldataLayer variable updated
- gtm4wp.reading.readerType: at this point we are confident whether the visitor is a ‘scanner’ or ‘reader’ depending on how much time have passed since the content has been loaded.
readerTypedataLayer variable holds the type of the visitor
- Can I exclude certain user roles from being tracked?
Google Tag Manager is not just about visitor tracking.
The ability to include a Google/Universal Analytics tag is only one feature you can manage.
Therefore there is no need to have an option to exclude the container code snippet on certain cases.
If you want to exclude logged in users or certain user roles, use the corresponding dataLayer variable (visitorType)
and an exclude filter in Google Tag Manager.
- How do I put the Google Tag Manager container code next to the opening body tag?
Go to the admin section of the plugin and select “Custom” from the placement settings.
This way my plugin does not put the code snippet into the footer of the page.
In this case you have to edit your template files.
wp-content/plugins/themes/<your theme dir>and edit
In most cases you will find the opening
If you can not find it, contact the author of the theme and ask for instructions.
In case you found the opening
<body>tag, open a new line just after it and insert this line of code:
Be careful not to include this line inside any
<article>and so on.
It can break you theme.
There is also a solution named “Codeless” which tries to add the container code to the right place but
without additional theme tweaking. This is still experimental, use it wisely.
- Why can not this plugin insert the container snippet after the opening body tag automatically?
Currently WordPress has two ‘commands’ or ‘hooks’ that a programmer can use: one for the
one for the bottom of
<body>. There is no way to inject any content after the opening body tag without manually editing your template files.
Fortunately some theme authors already resolved this so in some cases you do not need to edit your template.
I suggest first to select the Custom placement and use Google Tag Assistant Chrome browser extension to check
whether the container code is placed as expected.
If it shows an error, go and edit your theme manually.
- Facebook like/share/send button events do not fire for me, why?
It is a limitation of Facebook. Click event tracking is only available for html5/xfbml buttons.
If you or your social plugin inserts the Facebook buttons using IFRAMEs (like Sociable), it is not possible to track likes.
Easy to setup!
I'm looking to move a site to php 7.0 and would like to know if there are any compatibility problems with php 7.0 Thank you.
Fixed: clicks on products in product list pages redirected to undefined URLs with some themes.
Lots of WooCommerce ecommerce codes has been changed and extended, please double check your measurement after upgrading to this version!
- Added: warning message if you are using PHP 5.3 or older. Browser/OS/Device tracking needs 5.4 or newer
- Added: Email address of the logged in user into the visitorEmail dataLayer variable. Remember: to comply with GTM TOS you are not allowed to pass this data towards any Google tag but you can use this in any other 3rd party tag.
- Added: gtm4wp_eec_product_array WordPress filter so that plugin and theme authors can add their own data for enhanced ecommere product arrays
- Fixed: Order data not present in some cases on the order received page
- Changed: Extended “User SKUs instead of IDs for remarketing” option to be also applied to ecommerce product data arrays
- Changed: Use wc_clean instead of the deprecated function woocommerce_clean
- Changed: New, divided GTM container implemented – a fixed part in the and an iframe part placed using the container placement option you’ve set earlier
- Fixed: WP CLI error message
- Fixed: wrong dynamic remarketing tagging on cart and checkout pages
- Updated: WhichBrowser library to 2.0.22
- Updated: slightly changed container code snippet to prevent W3 Total Cache to alter the code which breaks proper code execution
- Updated: replaced file_get_contents() usage in weather tracking to wp_remote_get() so that it is more compatible with several WP instances
- Updated: YouTube/Video/Soundcloud tracking now tracks videos not embedded using oEmbed (like videos in a widget area)
- Updated: new Vimeo Player API implemented which should solve several issues
- Changed: adapted W3C HTML5 media player event names which changes some events (needs updating your existing GTM setup):
- Soundcloud: finish => ended, seek => seeked
- YouTube: playing => play, paused => pause, playback-rate-change => ratechange
- Vimeo: seek => seeked
- Added: new placement option – ‘off’. This will only generate the data layer but you will need to add the proper GTM container code snippet by hand
- Added: new data layer variable: authorID
- Added: new data layer variable: siteID to be able to track based on blog ID in a multisite environment
- Added: new data layer variable: siteName to be able to track in a multisite environment
- Fixed: remove cart event not fired in WooCommerce 2.6
- Fixed: ecomm_prodid.push error message on product detail pages
- Fixed: proper tracking of cart actions on the cart page for WooCommerce 2.6
- Fixed: ‘Illegal string offset’ errors in some cases in the cart
- Fixed: OpenWeatherMap requires a (free) API key now, you can now enter this to use weather data in data layer
- Fixed: “json_encode() expects parameter 2 to be long, string given” on PHP 5.3 instances
- Fixed: Fatal PHP error in cart if you enabled taxes to be included in your cart
Major changes to the Enhanced Ecommerce implementation of the WooCommerce integration!
- Fixed: proper tracking of list positions
- Fixed: opening product detail page in a new window/tab when user pressed the CTRL key
- Fixed: ecomm_totalvalue included the total price of the cart without taxes
- Fixed: ecomm_totalvalue does not take into account the quantity of ordered products on the order received page
- Fixed: php error message on product lists when AdWords dynamic remarketing was enabled on WooCommerce 2.6
- Fixed: added data-cfasync=”false” to the GTM container code for better compatibility with CloudFlare
- Added: introducing tracking of list names (general product list, recent products list, featured products list, etc.)
- Some list names (like cross-sells) will be shown as ‘General Product List’. A proposed change in WooCommerce 2.6 will solve that issue
- Added: tracking product lists in widgets
- Added: tracking checkout options (payment and shipment)
- Updated: better add-to-cart / remove-from-cart management in mini cart and while updating cart content
- Updated: added currency code to each enhanced ecommerce call so that currency reporting is OK for multi currency sites
- Updated: replaced usage of get_currentuser() to keep compatibility with WordPress 4.5
- Fixed: subtabs on admin page now showing in certain cases
- Fixed: error message when running the site using WP CLI (thanks Patrick Holberg Hesselberg)
- Fixed: some typos on admin page
- Fixed: dismissable notices did not disappear in some cases
- Fixed: tracking of Twitter event cased sometimes JS errors
- Fixed: site search tracking caused sometimes PHP errors when HTTP_REFERER was not set
- Updated: preparation for translate.wordpress.org
- Added: support for multiple container IDs
- Added: added form ID when sending a Contact Form 7 form. Variable name: gtm4wp.cf7formid
- Fixed: PHP errors in frontend.php and admin.php
- Added: track embedded YouTube/Vimeo/Soundcloud videos (experimental)
- Added: new checkbox – use product SKU for AdWords Dynamic Remarketing variables instead of product ID (experimental)
- Added: place your container code after the opening body tag without modifying your theme files (thx Yaniv Friedensohn)
- Added: automatic codeless container code injection for Genesis framework users
- Fixed: Possible PHP error with custom payment gateway (QuickPay) on the checkout page (thx Damiel for findig this)
The plugin itself is now declared as stable. This means that it should work with most WordPress instances.
From now on each version will include features labeled as:
- Beta: the feature has been proven to work for several users but it can still have some bugs
- Experimental: new feature that needs proper testing with more users
- Deprecated: this feature will be removed in a future version
If you see any issue with beta or experimental functions just disable the checkbox. Using this error messages should disappear.
Please report all bugs found in my plugin using the contact form on my website.
- Fixed: wrong GTM container code when renaming default dataLayer variable name (thx Vassilis Papavassiliou)
- Fixed: Enhanced Ecommerce product click data was “undefined” in some cases (thx Sergio Alen)
- Fixed: wrong user role detection while adding visitorType to the dataLayer (thx Philippe Vachon-Rivard)
- Changed: only add visitorId to the dataLayer if there is a logged in user
- Added: feature labels so that you can see beta, experimental and deprecated features
- Deprecated: outbound click, email click and download click events. You should use GTM trigger events instead
- Fixed: PHP error message: missing get_shipping function using WooCommerce 2.3.x
- Added: visitorId dataLayer variable with the ID of the currently logged in user to track userID in Google Analytics
- Added: WordPress filter hook so that other templates and plugins can get access to the GTM container code before outputting it
- Fixed: ‘variation incorrect’ issue by Sharken03
- Fixed: error messages in WooCommerce integration when product has no categories
- Fixed: add_inline_js errors in newer versions of WooCommerce
- Fixed: error message when some device/browser/OS data could not be set
- Fixed: tracking Twitter events was broken
- Fixed: broken links when listing subcategories instead of products (thanks Jon)
- Fixed: wheather/weather typo (thanks John Hockaday)
- Fixed: wrong usage of get_the_permalink() instead of get_permalink() (thanks Szepe Viktor)
- Fixed: PHP error in enhanced ecommerce implementation when using layered nav widget
- Updated: Added subtabs to the admin UI to make room for new features 🙂
- Updated: WhichBrowser library to the latest version
- Added: You can now dismiss plugin notices permanently for each user
- Added: weather data. See updated plugin description for details
- Added: Enhanced E-commerce for WooCommerce (experimental!)
- Fixed: PHP notice in frontend.php script. Credit to Daniel Sousa
- Fixed: WooCommerce 2.1.x compatibility
- Updated/Fixed: dataLayer variables are now populated at the end of the head section. Using this the container code can appear just after the opening body tag, thus Webmaster Tools verification using Tag Manager option will work
- Added: blacklist or whitelist tags and macros to increase security of your Tag Manager setup
- Updated: better add-to-cart events for WooCommerce, it includes now product name, SKU and ID
- Added: browser, OS and device data to dataLayer variables
- Added: postCountOnPage and postCountTotal dataLayer variables to track empty categories/tags/taxonomies
- Fixed: WooCommerce integration did not work on some environments
- Added: scroll tracking
- Fixed: social tracking option on the admin panel was being shown as an edit box instead of a checkbox
- Fixed: WooCommerce transaction data was not included in the dataLayer if you selected “Custom” code placement
- Fixed: do not do anything if you enabled WooCommerce integration but did not activate WooCommerce plugin itself
- Updated: do not re-declare dataLayer variable if it already exists (because another script already created it before my plugin was run)
- Added: you can now select container code placement. This way you can insert the code snippet after the opening body tag. Please read FAQ for details
- Added: initial support for social event tracking for Facebook and Twitter buttons. Please read FAQ for details
- Updated: event name on successful WooCommerce transaction: OrderCompleted -> gtm4wp.orderCompleted
- Fixed: frontend JS codes did not load on some WordPress installs
- Updated: admin page does not show an alert box if Tag Manager ID or dataLayer variable name is incorrect. Instead it shows a warning line below the input field.
- Updated: rewritten the code for WooCommerce dynamic remarketing. Added tag for homepage and order completed page.
- ! BACKWARD INCOMPATIBLE CHANGE ! – Names of Tag Manager click events has been changed to comply with naming conventions:
- ContactFormSubmitted -> gtm4wp.contactForm7Submitted
- DownloadClick -> gtm4wp.downloadClick
- EmailClick -> gtm4wp.emailClick
- OutboundClick -> gtm4wp.outboundClick
- AddProductToCart -> gtm4wp.addProductToCart
- Updated: click events are now disabled by default to reflect recently released Tag Manager auto events. I do not plan to remove this functionality. You can decide which solution you would like to use 🙂
- Updated: language template (pot) file and Hungarian translation
- Added: new form move events to track how visitors interact with your (comment, contact, etc.) forms
- Added: event names to admin options page so that you know what events to use in Google Tag Manager
- Added: Google Tag Manager icon to admin settings page
- Added: Settings link to admin plugins page
- Fixed: null value in visitorType dataLayer variable if no logged in user exists (now ‘visitor-logged-out’)
- First beta release