=== GTM for WooCommerce FREE ===
Contributors: Tag Concierge
Tags: google tag manager, GA4, ecommerce events, Google Analytics, Facebook Pixel, Microsoft UET, consent mode
Requires at least: 5.1.0
Tested up to: 6.5
Requires PHP: 7.0
Stable tag: 1.10.32
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Enable new growth channels for your WooCommerce with GA4 and Consent Mode ready GTM integration. Use packages GTM presets for quick installation.

== Description ==

Looking to accelerate the growth of your WooCommerce shop? Uncertain about complex tagging requirements to start tracking customer activities and optimizing paid sales campaigns?

Discover our plugin, that seamlessly integrates WooCommerce with Google Tag Manager (GTM), pushing standard eCommerce data to the GTM Data Layer. Once integrated, you gain the flexibility to utilize any analytics or marketing tool, even if you're undecided on your choice.

To speed up the process, our plugin offers pre-packaged integrations for GA4 and Facebook Pixel. You can be up and running in minutes, bypassing the need for extensive GTM configuration. See how it works here:

https://youtu.be/5s5_tCGuKu4


Check [live demo here](https://demo-woocommerce.tagconcierge.com/) (perform typical shop activities - add to cart, purchase - to see how events are triggered). This demo showcase all PRO plugin features - FREE version is limited to 2 events listed below.

More information and documentation can be found [here](https://docs.tagconcierge.com/).

## Example scenarios

1. Analyse eCommerce behaviors and study your sales funnel in Google Analytics (**GA4 supported**)
2. Get most out of Facebook and Instagram paid campaigns with conversion tracking
3. Optimise your Google Ads campaigns with enhanced conversion (requires PRO version)
4. Expand to new platforms with TikTok, Pinterest and Microsoft UET presets (requires PRO version)


## Supported events

After the plugin is installed it automatically tracks the following events:

- Add To Cart
- Purchase

Which are a great base for **conversion measurements** and building **sales funnels** related to cart behavior.

**For full eCommerce events coverage, improved handling and professional support [buy PRO version](https://tagconcierge.com/google-tag-manager-for-woocommerce/).**

## Advantage over alternative solutions

### Only single plugin needed

Without GTM for WooCommerce plugin, you would need a separate plugin for each of those integrations. And each additional plugin may make your Wordpress setup more complex.
With GTM for WooCommerce, all data is sent in standardized Google format to GTM and everything else is configured there.

### Reporting consistency

A common problem when trying to use other GTM and Google Analytics plugins is that data can be sent twice corrupting analytics reporting. Using DataLayer is a standard way to ensure your tracking information stays consistent.

### Cookies opt-in

Using GTM and dataLayer allows to build more complex scenarios, such as only processing the data after obtaining user consent. Other plugin directly pipe events into target system no matter if required permission was given or not. This is a more advanced scenario that requires manual changes in Google Tag Manager, but out-of-box support may be added in this plugin in future.


== Installation ==

1. Upload or install GTM for WooCommerce plugin from WordPress plugins directory.
2. Activate the plugin through the `Plugins` menu in WordPress.
3. That's it! If GTM is already implemented in your WordPress your eCommerce data will be pushed to GTM DataLayer. If not head to `Settings > Google Tag Manager` and paste in GTM snippets.
4. Go to your Google Tag Manager workspace and define what you want to do with the tracked data. We know that settings up the GTM workspace may be cumbersome. That's why the plugin comes with a GTM container presets that you can import to your GTM workspace to create all required Tags, Triggers, and Variables in few simple clicks.

### How to use JSON file with GTM container?

In order to perform such import go to `Settings > Google Tag Manager` and scroll down. There is a link to the JSON file with the GTM container. Save it as a JSON file on your computer.

Then in GTM go to the `Admin` panel of your workspace. Click `Import Container`. Choose the container file you have just downloaded. Decide which workspace it should go to. Then select `Merge` and `Overwrite conflicting tags, triggers and variables.` as import options.
Hit `Confirm` to create tags, variables, and triggers for pushing Ecommerce events to the GA4 property.

The last step is to define `GA4 Measurement ID`. Go to `Variables` find a variable with the `GA4 Measurement ID` name, click to edit it. Then paste your GA4 Measurement ID in the Value field.


If you are importing `Facebook Pixel` preset you can find the tracking ID in `FBP Pixel ID` variable.

Save and submit all the changes to make it live.

You can find more detailed guides [here](https://docs.tagconcierge.com/).

== Frequently Asked Questions ==

= How to inject GTM tracking snippet? =

By default this plugin push eCommerce information to the GTM DataLayer object that can be installed by other plugins or directly in the theme code.
It can also embed GTM snippets, go to settings to configure it.

= How to setup my GTM tags and triggers now? =

We know that settings up the GTM workspace may be cumbersome. That's why the plugin comes with GTM container presets that you can import to your GTM workspace to create all required Tags, Triggers, and Variables.

See the Installation tab above or [our guides](https://tagconcierge.com/google-tag-manager-for-woocommerce/) for details.

= What eCommerce events are supported? =

This version of the plugin supports just `purchase` and `add_to_cart` events.
Our PRO version available [here](https://tagconcierge.com/google-tag-manager-for-woocommerce/) supports more.

= Is GA4 supported? =

Yes! Just use the appropriate preset available in the settings screen of the plugin


== Screenshots ==

1. **GTM for WooCommerce** integrations
2. **GTM for WooCommerce** settings and GTM snippets
3. eCommerce results in GA4 property
4. eCommerce results in Universal Analytics property
5. `add_to_cart` event captured in GTM debugger
6. `purchase` event captured in GTM debugger
7. How to import the provided GTM container?
8. GTM workspace tags after importer provided JSON file



== Changelog ==

= 1.10.32 =

* added PHP types
* fix PHP errors and improve code linting
* tested against the latest versions of WordPress and WooCommerce

= 1.10.31 =

* tested against the latest version of WordPress
* add links to professional services

= 1.10.30 =

* add documentation links on presets gallery
* remove BETA badge from GTM server-side
* tested against the latest version of WooCommerce

= 1.10.29 =

* tested against the latest versions of WordPress and WooCommerce

= 1.10.28 =

* tested against the latest versions of WordPress and WooCommerce

= 1.10.27 =

* tested against the latest versions of WordPress and WooCommerce

= 1.10.26 =

* added 'discount' property to ecommerce item
* tested against the latest version of WooCommerce

= 1.10.25 =

* tested against the latest version of WooCommerce

= 1.10.24 =

* improved Google Analytics 4 events attributes

= 1.10.23 =

* tested against the latest versions of WordPress and WooCommerce

= 1.10.22 =

* fixed dynamic property in GtmEcommerceWoo\Lib\GaEcommerceEntity\Item object
* tested against the latest version of WooCommerce

= 1.10.21 =

* tested against the latest versions of WordPress and WooCommerce

= 1.10.20 =

* fixed events inspector's console z-index property

= 1.10.19 =

* added distinction for recently added presets in presets gallery

= 1.10.18 =

* fixed issue with product price in 'purchase' event
* tested against the latest version of WooCommerce

= 1.10.17 =

* tested against the latest version of WooCommerce

= 1.10.16 =

* changes priority of Google Tag Manager snippet loading on 'wp_head' hook
* removes 'ecommerce' key from event object, when there is no items and no value

= 1.10.15 =

* added new server-side tracking settings
* tested against the latest version of WooCommerce

= 1.10.14 =

* tested against the latest version of WooCommerce

= 1.10.13 =

* fixed 'gtm_ecommerce_woo_event_after_processing' filter
* tested against the latest version of WordPress

= 1.10.12 =

* added 'gtm_ecommerce_woo_event_after_processing' filter after event object data processing
* added Google Tag Manager dataLayer clearing before pushing ecommerce events
* added 'currency' property to ecommerce events
* tested against the latest version of WordPress

= 1.10.11 =

* tested against the latest version of WooCommerce

= 1.10.10 =

* tested against the latest version of WooCommerce

= 1.10.9 =

* declare compatibility with WooCommerce High-Performance Order Storage (HPOS)
* tested against latest versions of WordPress and WooCommerce

= 1.10.8 =

* fix issue with preset download

= 1.10.7 =

* adjust the name to WordPress directory requirements
* tested against latest versions of WordPress and WooCommerce
* adjust required PHP version

= 1.10.6 =

* tested against latest versions of WordPress and WooCommerce

= 1.10.5 =

* simplify loading the GTM Presets gallery
* removed missing WooCommerce notification
* removed 'data-cfasync' attribute as it was causing issues in certain scenarios

= 1.10.4 =

* enhanced add_to_cart event to work on dynamic product pages
* upgraded dependencies
* added 'data-cfasync' attribute
* ask for feedback to enhance user support

= 1.10.3 =

* fix picking up the quantity in add_to_cart event

= 1.10.2 =

* fix casting issue PHP 8.0

= 1.10.1 =

* updated documentation
* tested against latest versions of WordPress and WooCommerce

= 1.10.0 =

* add `value` property to all events
* introduce `gtm_ecommerce_woo_event` filter and extra properties
* improve handling product categories
* fix handling of add_to_cart
* test against latest WordPress and WooCommerce

= 1.9.4 =

* remove testing code
* test against latest WooCommerce and WordPress versions
* introduce secured endpoint for obtaining debugging info

= 1.9.3 =

* switch the monitoring API to edge endpoints for performance gains

= 1.9.2 =

* improve add_to_cart JS not to be blocked by other scripts (click vs submit)
* link to the new version of the theme validator

= 1.9.1 =

* show presets versions
* WordPress code styling applied

= 1.9.0 =

* tested with most recent versions of WordPress and WooCommerce
* moved purchase data into top level ecommerce property
* added Tag Concierge Monitoring integration

= 1.8.1 =

* tested with most recent versions of WordPress and WooCommerce

= 1.8.0 =

* fix handling taxes
* introduce filters to customize events and properties
* Theme Validator enhancements

= 1.7.0 =

* move injecting dataLayer down in wp_footer hook to allow loading jQuery in the footer
* safeguard add_to_cart event when non-product is loaded in the page
* tools for verifying tracking: Event Inspector & Theme Validator

= 1.6.0 =

* rework settings with tabs
* renamed the plugin to match PRO version
* presets in a grid for easier discovery and download
* supported events settings

= 1.5.8 =

* remove settings tabs

= 1.5.7 =

* added missing file

= 1.5.6 =

* release correct version

= 1.5.5 =

* fixed critical bug

= 1.5.4 =

* introduce Theme Validator that allows for remote tracking debugging
* improve jQuery callbacks

= 1.5.3 =

* Rely on core WordPress and WooCommerce hooks to cover more themes

= 1.5.2 =

* Update documentation

= 1.5.1 =

* Update documentation
* **Facebook Pixel preset!**
* Remove depratacted UA setting
* Update internal UUID for downloading presets

= 1.5.0 =

* Allow more complex GTM presets, **UA compatible preset available!**
* Fix order items without categories

= 1.4.4 =

* Force initializing dataLayer variable
* Fix products without categories

= 1.4.3 =

* Fix PHP 7.2 compatibility issue
* Fix add_to_cart on single page

= 1.4.2 =

* Fix embedding JS for DOM Ready triggers

= 1.4.1 =

* Fix missing JS file

= 1.4.0 =

* Replace JSON file with external GTM preset generator

= 1.3.1 =

* Fix missing GTM container JSON file

= 1.3.0 =

* Fixed settings sections
* Provide a GTM container to import in a workspace

= 1.2.0 =

* Document possible UA compatibility feature

= 1.1.0 =

* Fix disabling plugin

= 1.0.0 =

* Initial version