-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathreadme.txt
497 lines (299 loc) · 13.6 KB
/
readme.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
=== Tag Pilot FREE - Google Tag Manager Integration for WooCommerce ===
Contributors: tagconcierge
Tags: google tag manager, GA4, WooCommerce, Facebook Pixel, Consent Mode
Requires at least: 5.1.0
Tested up to: 6.7.1
Requires PHP: 7.0
Stable tag: 1.12.3
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html
Complete GTM plugin for WooCommerce (consent Mode v2 and server-side GTM). Ready for GA4 and FB Pixel. Product feed for Google Merchant Center.
== Description ==
Tracking eCommerce events via Google Tag Manager and DataLayer makes adding new growth channels a straighforward task. Regardless of a number of connected platforms the data quality and events coverage stays the same.
https://youtu.be/tTluZ8l94VA
This plugin, once activated, starts pushing standard GA4 eCommerce events into GTM DataLayer. Once the data is there you can leverage Google Tag Manager containers to connect virtually any analytics o marketing platform, even if you're still 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 time-consuming GTM configuration. See how it works here:
Check [live demo here](https://demo2-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 4
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 analysing **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/).**
## PRO Version
The paid version covers following events:
- view_item_list
- select_item
- view_item
- add_to_cart
- view_cart
- remove_from_cart
- begin_checkout
- add_billing_info
- add_payment_info
- add_shipping_info
- purchase
- user_data
Comes with presets for:
- Google Ads (Enhanced Conversions)
- Google Ads Dynamic Remarketing
- Facebook Pixel (Advanced Matching)
- Microsoft UET / Bing Ads
- Pinterest
- TikTok
- Consent Mode
- Server-side GTM
Additonally, works with 3rd party plugins:
- WooCommerce Brands
- Yith Brands
- WooCommerce Quick View
- WooCommerce Wishlists
- WPC Smart Wishlist
- WooCommerce Multilingual
- WPML
- Polylang
## Advantage over alternative solutions
### Only one plugin needed
Without a GTM plugin, you would need a separate plugin for each of those integrations. Each plugin can track events differently. They can cause conflicts and slow-down on the front-end
With a dedicated GTM plugin, all data is sent in standardized Google format to Google Tag Manager which forwards events to multiple destination services.
### 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 across all connected tools.
### Google Consent Mode v2
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.
== 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 click `GTM Presets` tab. Look for GTM Preset that you would like to install. 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. Plugin tracked `add_to_cart` and `purchase` events
2. **GTM for WooCommerce** settings and GTM snippets
3. Available events in PRO version
4. GTM Presets gallery
5. Google Tag Manager import preview
6. Google Ads Conversion status
7. Complete purchase journey in GA4 (requires PRO)
8. Event and Cart Data tools
9. Server-side tools
== Changelog ==
= 1.12.3 =
* improved order monitor statistics
= 1.12.2 =
* fixed error with undefined `wc_get_container` WooCommerce function
= 1.12.1 =
* orders monitor improvements
= 1.12.0 =
* introduced orders monitor
* events inspector enhancements
= 1.11.0 =
* added product feed generator
* added default consent mode state
* added server-side GTM snippet modifier
* added ability to add extra parameters to ecommerce object
* introduced tools gallery
* improved styling of events inspector
= 1.10.34 =
* removed unnecessary code
* tested against the latest versions of WordPress and WooCommerce
= 1.10.34 =
* tested against the latest versions of WordPress and WooCommerce
* documentation and wording adjustments
= 1.10.33 =
* push `ecommerce: null` to dataLayer before every event
* send product name without variant attribute as the main product name
= 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