=== Pixel Manager for WooCommerce - Track Google Analytics, Google Ads, TikTok and more ===
Contributors: alekv, wolfbaer
Tags: woocommerce, google analytics, google ads, facebook pixel, conversion tracking
Requires at least: 3.7
Tested up to: 6.5
Requires PHP: 7.3
Stable tag: 1.43.5
License: GPLv3 or later
License URI: http://www.gnu.org/licenses/gpl-3.0.html

Track visitors and conversions for WooCommerce Google Analytics GA4, Google Ads, Meta (Facebook, Instagram), TikTok, Microsoft, and many more!

== Description ==

Boost your sales and cut advertising costs with the Pixel Manager, a plugin that excels in precise e-commerce tracking.

🚀 Endorsed by Google’s Tag Team – a big deal, right?

> This plugin was recommended to us by Google’s Tag Implementation Team. That should say enough.

[says @dpackert24](https://wordpress.org/support/topic/simple-easy-to-use-does-what-it-says-on-the-tin/)

> Saved me thousands...and top-notch support and docs.

[says @caesarsandiego](https://wordpress.org/support/topic/world-class-quality-solution/)

This plugin tracks WooCommerce shop visitors and collects valuable data for conversion optimization of your shop and paid ads, dynamic remarketing, and reporting. It's designed to boost sales and cut advertising costs through precise e-commerce tracking.

The Pixel Manager integrates smoothly with platforms like Google Analytics, Google Ads, Meta (Facebook, Instagram), Hotjar, Microsoft (Pro), and TikTok (Pro).

[youtube https://www.youtube.com/watch?v=BW0Tzyu2HaU]

<strong>Key Benefits</strong>

&#9989; User-friendly and intuitive.
&#9989; Customizable filters for even more precise tracking.
&#9989; GDPR-aligned with advanced data privacy features.
&#9989; Standardized data output across platforms.
&#9989; In-depth payment gateway reports – goodbye conversion drops.
&#9989; Lightweight JavaScript library for a speedy site.
&#9989; Auto Conversion Recovery (ACR) – catch those lost conversions (Pro).

This plugin goes beyond basic setup, offering comprehensive tracking of all e-commerce activities. Advanced features like Google Analytics Enhanced E-Commerce and dynamic remarketing events are included, with the pro version adding Meta CAPI, TikTok Events API, and much more.

<strong>Why the Pixel Manager?</strong>

Accuracy, simplicity, innovation.

There is an extensive feature range in the free and especially the pro version.

Unique tools like the [Payment Gateway Accuracy Report](https://sweetcode.com/docs/wpm/diagnostics?utm_source=wordpress.org&utm_medium=wpm-plugin-page&utm_campaign=pixel-manager-for-woocommerce-docs&utm_content=payment-gateway-accuracy-report#payment-gateway-tracking-accuracy-report) and [ACR](https://sweetcode.com/docs/wpm/features/acr?utm_source=wordpress.org&utm_medium=wpm-plugin-page&utm_campaign=pixel-manager-for-woocommerce-docs&utm_content=acr) (Pro).

<strong>Plugin Integrations</strong>

* Google Ads Pixel
* Google Analytics Pixel (GA4)
* HotJar Pixel
* Meta Ads Pixel
* LinkedIn Ads Pixel (Pro)
* Microsoft Ads Pixel (Pro)
* Outbrain Ads Pixel (Pro)
* Pinterest Ads Pixel (Pro)
* Reddit Ads Pixel (Pro)
* Snapchat Ads Pixel (Pro)
* Taboola Ads Pixel (Pro)
* TikTok Ads Pixel (Pro)
* Twitter Ads Pixel (Pro)

<strong>Highlights</strong>

* Google Consent Mode v2
* Effective order duplication prevention.
* Dynamic remarketing audience collection.
* Google Ads Cart Data tracking.
* Consent management platform compatibility.
* Google Analytics Enhanced E-Commerce.
* [Payment Gateway Accuracy Report](https://sweetcode.com/docs/wpm/diagnostics?utm_source=wordpress.org&utm_medium=wpm-plugin-page&utm_campaign=pixel-manager-for-woocommerce-docs&utm_content=payment-gateway-accuracy-report#payment-gateway-tracking-accuracy-report)
* Google Ads Enhanced Conversions (Pro)
* Server-side tracking for many platforms (Pro)
* Meta Conversion API (Pro)
* [Automatic Conversion Recovery (ACR)](https://sweetcode.com/docs/wpm/features/acr?utm_source=wordpress.org&utm_medium=wpm-plugin-page&utm_campaign=pixel-manager-for-woocommerce-docs&utm_content=acr) (Pro)

<strong>Free Features</strong>

* Google Consent Mode v2
* Google Ads Conversion Value Tracking
* Google Ads Dynamic Remarketing
* Google Ads Cart Item Tracking
* Google Shopping New Customer Parameter
* GA4 Enhanced E-Commerce
* Meta Pixel (Facebook Pixel)
* Meta Remarketing Events
* Hotjar Pixel
* Basic Order Duplication Prevention
* Many useful filters that help tweak the plugin output
* Works with lazy loaded product lists
* [Payment gateway accuracy report](https://sweetcode.com/docs/wpm/diagnostics?utm_source=wordpress.org&utm_medium=wpm-plugin-page&utm_campaign=pixel-manager-for-woocommerce-docs&utm_content=payment-gateway-accuracy-report#payment-gateway-tracking-accuracy-report)

Have a look at the full feature list over [here](https://sweetcode.com/docs/wpm/features).

<strong>Premium Pixels</strong>

* LinkedIn Ads
* Microsoft Ads
* Pinterest Ads
* Reddit Ads
* Snapchat Ads
* Taboola Ads
* TikTok Ads
* Twitter Ads
* VWO (Visual Website Optimizer) AB-testing tool

<strong>Premium Features</strong>

* [Automatic Conversion Recovery (ACR)](https://sweetcode.com/docs/wpm/features/acr?utm_source=wordpress.org&utm_medium=wpm-plugin-page&utm_campaign=pixel-manager-for-woocommerce-docs&utm_content=acr)
* Advanced Order Duplication Prevention
* Google Ads Enhanced Conversions
* Google Ads Conversion Adjustments
* Meta CAPI (Facebook CAPI)
* Pinterest APIC
* Snapchat CAPI
* Scroll Tracking
* Automatic Phone and Link Click Tracking

Have a look at the full feature list over [here](https://sweetcode.com/docs/wpm/features).

Are you interested in buying the [Pro version](https://sweetcode.com)? Come and visit us [here](https://sweetcode.com).

<strong>Documentation</strong>

Link to the full documentation of the plugin: [Open the documentation](https://sweetcode.com/docs/wpm/?utm_source=wordpress.org&utm_medium=wpm-plugin-page&utm_campaign=pixel-manager-for-woocommerce-docs)

<strong>Consent Management</strong>

The plugin uses data from several Consent Management plugins to manage approvals and disapproval for injecting of marketing pixels.

It works with the following Consent Management plugins out of the box:

* [Cookiebot](https://wordpress.org/plugins/cookiebot/)
* [Cookie Script](https://wordpress.org/plugins/cookie-script-com/)
* [Complianz GDPR/CCPA Cookie Consent](https://wordpress.org/plugins/complianz-gdpr/)
* [Cookie Notice](https://wordpress.org/plugins/cookie-notice/)
* [Cookie Notice & Compliance for GDPR / CCPA](https://wordpress.org/plugins/cookie-notice/)
* [Cookie Law Info](https://wordpress.org/plugins/cookie-law-info/)
* [GDPR Cookie Compliance](https://wordpress.org/plugins/gdpr-cookie-compliance/)
* [WP AutoTerms](https://wordpress.org/plugins/auto-terms-of-service-and-privacy-policy/)
* [Usercentrics](https://usercentrics.com/)
* [CookiePro by OneTrust](https://wordpress.org/plugins/cookiepro/)
* [Termly](https://wordpress.org/plugins/uk-cookie-consent/)
* [Iubenda](https://wordpress.org/plugins/iubenda-cookie-law-solution/)
* [WP Consent API](https://wordpress.org/plugins/wp-consent-api/)
* [WP Cookie Consent](https://wordpress.org/plugins/gdpr-cookie-consent/)

Please read the following for additional [setup information](https://sweetcode.com/docs/wpm/consent-management/platforms?utm_source=wordpress.org&utm_medium=wpm-plugin-page&utm_campaign=pixel-manager-for-woocommerce-docs&utm_content=cookie-consent-plugins)

<strong>Requirements</strong>

[List of requirements](https://sweetcode.com/docs/wpm/setup/requirements?utm_source=wordpress.org&utm_medium=wpm-plugin-page&utm_campaign=pixel-manager-for-woocommerce-docs&utm_content=requirements)

<strong>Security Review</strong>

Although we follow security best practices, we wanted to ensure that we didn't miss anything. So, we had the plugin reviewed by [Patchstack](https://patchstack.com/), a cybersecurity company specializing in WordPress security.

The summary of their report was: "We were unable to detect any vulnerabilities that would impact the security status of the plugin in a serious way."

<strong>Managed Vulnerability Disclosure Program</strong>

We are committed to ensuring the security of our customers and their data. If you believe you have found a security vulnerability in the Pixel Manager for WooCommerce, we encourage you to report it through Patchstack our security partner. Patchstack runs a managed Vulnerability Disclosure Program (mVDP) that helps us receive, triage, and respond to reported vulnerabilities. Patchstack also provides a reward for the responsible disclosure of security vulnerabilities. [Report a vulnerability](https://patchstack.com/database/vdp/woocommerce-google-adwords-conversion-tracking-tag)

== Installation ==

1. Upload the plugin directory into your plugin's directory `/wp-content/plugins/`

2. Activate the plugin through the 'Plugins' menu in WordPress

3. Get the Google Ads conversion ID and the conversion label. You will find both values in the Google Ads conversion tracking code. [Get the conversion ID and the conversion label](https://www.youtube.com/watch?v=p9gY3JSrNHU)

4. In the WordPress admin panel go to WooCommerce and then into the 'Google Ads Conversion Tracking' menu. Please enter the conversion ID and the conversion label into their respective fields.

5. Head over to our documentation and follow our installation guides. Here are some of our most popular guides:
 * [Google Ads](https://sweetcode.com/docs/wpm/plugin-configuration/google-ads)
 * [Google Analytics](https://sweetcode.com/docs/wpm/plugin-configuration/google-analytics)
 * [Meta (Facebook)](https://sweetcode.com/docs/wpm/plugin-configuration/meta)

6. And read through our [FAQ](https://sweetcode.com/docs/wpm/faq).

== Frequently Asked Questions ==

= Is there detailed documentation for the plugin? =

Yes. Head over to this link: [Documentation](https://sweetcode.com/docs/wpm/?utm_source=wordpress.org&utm_medium=wpm-plugin-page&utm_campaign=pixel-manager-for-woocommerce-docs)

= How do I check if the plugin is working properly? =

1. Turn off any kind of caching and / or minification plugins.
2. Log out of the shop.
3. Turn off any kind of ad or script blocker in your browser.
4. Search for one of your keywords and click on one of your ads.
5. Purchase an item from your shop.
6. Wait up to 48 hours until the conversion shows up in Google Ads. (usually takes only a few hours)

With the Google Tag Assistant you will also be able to see the tag fired on the thankyou page.

= HPOS (High Performance Orders Storage) =

The Pixel Manager is ready for the new WooCommerce [High Performance Orders Storage (HPOS)](https://developer.woocommerce.com/2022/09/14/high-performance-order-storage-progress-report/) feature.

= Plugin compatibility =

Our plugin is designed to work seamlessly with 99.99% of all other plugins. In the rare event of a conflict with a third-party plugin, we typically identify a fix or workaround quickly.

To illustrate its broad compatibility, here are a few examples of third-party plugins that work well with the Pixel Manager:

* Async Javascript
* Automptimize
* CartFlows
* Cloudflare Plugin
* Cost of Goods for WooCommerce (WPFactory)
* Doofinder for WooCommerce
* FlyingPress
* Hummingbird
* Litespeed Cache
* Litespeed ESI
* NitroPack
* Siteground Optimizer
* W3 Total Cache
* WooCommerce Brands
* WooCommerce Composite Products
* WooCommerce Cost of Goods (SkyVerge)
* WooCommerce Deposits
* WooCommerce Google Product Feed
* WooCommerce Subscriptions
* WooCommerce Wishlists
* Woo Discount Rules
* WP Fastest Cache
* WP Marketing Robot Feed Manager
* WP Optimize
* WP Rocket
* WP Super Cache
* YITH WooCommerce Brands
* YITH WooCommerce Wishlist

Rest assured, this is just a small sample, and the Pixel Manager should integrate smoothly with almost all other plugins you may use.

= Will the Pixel Manager slow down my site? =

No. The plugin is very lightweight and fast.

* The back-end features are small and efficient.
* Database queries are designed to be fast and are cached where possible.
* Larger tasks are executed during nighttime using the Action Scheduler.
* The front-end JavaScript library is compiled, minified and pre-compressed with gzip and brotli.
* The pro version even allows lazy loading of the JavaScript library.

= Do you have videos that show how to set up the plugin and get most out of it? =

Yes, they are part of the step by step documentation. Head over to this link: [Documentation](https://sweetcode.com/docs/wpm/)

= I get a fatal error and I am running old versions of WordPress and/or WooCommerce. What can I do? =

As this is a free plugin we don't support old versions of WordPress and WooCommerce. You will have to update your installation.

= I am using an offsite payment gateway and the conversions are not being tracked. What can I do? =

We don't support if an offsite payment gateway is in use. The reason is that those cases can be complex and time consuming to solve. We don't want to cover this for a free plugin. We do not recommend offsite payment gateways anyway. A visitor can stop the redirection manually which prevents at least some conversions to be tracked. Also offsite payment gateways are generally bad for the conversion rate.

= I've done everything right in the test, but it still doesn't work. What can I do? =

Here is a non-exhaustive list of causes that might interfere with the plugin code.

* Minification plugins try to minify the JavaScript code of the plugin. Not all minification plugins do this good enough and can cause problems. Turn off the JavaScript minification and try again.
* Caching could also cause problems if caching is set too aggressively. Generally don't ever enable HTML caching on a WooCommerce shop, as it can cause troubles with plugins that generate dynamic output.

= I see issues in the backend of my shop. Admin pages get rendered weird, and popups don't go away when I click to close them. How can I fix this? =

You probably have some script or ad blocker activated. Deactivate it and the issues should go away. Usually you can disable the blocker for just that particular site (your WooCommerce back end).

Our plugin injects tracking pixels on the front end of WooCommerce shops. As a consequence scripts of our plugin have been added to some privacy filter lists. The idea is to prevent the scripts running if a shop visitor has some ad blocker enabled and wants to visit the front end of the shop. This is totally ok for visitors of the front end of the shop. But, it becomes an issue for admins of the shop who have a blocker activated in their browser and visit the backend of the shop.

Unfortunately there is no way for us to generally approve our scripts in all blockers for the WooCommerce back end.

Therefore, we recommend admins of the shop to exclude their own shop from the blocker in their browser.

= Where can I report a bug or suggest improvements? =

Please post your problem in the Pixel Manager for WooCommerce Support forum: [Link](http://wordpress.org/support/plugin/woocommerce-google-adwords-conversion-tracking-tag)
You can send the link to the front page of your shop too if you think it would be of help.

= I found a security vulnerability. How do I report it? =

We are committed to ensuring the security of our customers and their data. If you believe you have found a security vulnerability in the Pixel Manager for WooCommerce, we encourage you to report it through Patchstack our security partner. Patchstack runs a managed Vulnerability Disclosure Program (mVDP) that helps us receive, triage, and respond to reported vulnerabilities. Patchstack also provides a reward for the responsible disclosure of security vulnerabilities. [Report a vulnerability](https://patchstack.com/database/vdp/woocommerce-google-adwords-conversion-tracking-tag)

== Screenshots ==

1. Settings page

== Changelog ==

= 1.43.5  =
*Release date - 16.07.2024*

* Tweak: Updated vendor packages.
* Tweak: Improved logic to detect orders overview page and order edit pages.
* Tweak: Renamed the pmw_custom_cogs_meta_key filter to pmw_custom_cogs_product_meta_key.

= 1.43.4  =
*Release date - 26.06.2024*

* Tweak: Added filters to adjust the output of the order value for statistics.
* Tweak: Few improvements in the admin scripts to avoid unnecessary console errors.
* Tweak: Bumped up WC version compatibility to 9.0
* Fix: Removed the experimental Polyfill.io feature as the service has been compromised. (This feature was not active by default and had to be enabled manually by enabling an experimental filter.)

= 1.43.3  =
*Release date - 18.06.2024*

* Tweak: Ensured `get_transient_identifiers()` returns an array.
* Tweak: Added a few semicolons into the JavaScript inline code output to bolster the code against subpar JavaScript "optimizers" that otherwise may break the code.
* Tweak: Added filters for Google Site Kit. If Google Ads and/or GA4 are enabled in the Pixel Manager, it will prevent Google Site Kit from adding its own tracking code.
* Fix: Moved some GA4 JavaScript library functions from the premium to the free version, as they are called in the free version as well.
* Fix: Added a safeguard to prevent a fatal error in case a parent product can't be loaded.
* Fix: Fixed a bug when consent was changed in a Termly CMP.

= Earlier versions =
For the changelog of earlier versions, please refer to the changelog in the /changelog-archive/ folder.
