=== Pixel Manager for WooCommerce – Track Conversions and Analytics, Google Ads, TikTok and more ===
Contributors: alekv, wolfbaer, freemius
Tags: woocommerce, google analytics, google ads, facebook pixel, conversion tracking
Requires at least: 3.7
Tested up to: 6.9
Requires PHP: 7.3
Stable tag: 1.54.1
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/)

> Pixel Manager for WooCommerce is the go-to plugin for both tech wizards and casual users.

[says @chxz](https://wordpress.org/support/topic/the-go-to-plugin-tracking-everything/)

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>News</strong>

[youtube https://www.youtube.com/watch?v=1_SoAVwU-Mw]

<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)
* X (Twitter) Ads Pixel (Pro)

<strong>Highlights</strong>

* Google Tag Gateway for Advertisers
* 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 Tag Gateway for Advertisers
* 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>

* Adroll Ads
* Contentsquare Statistics
* LinkedIn Ads
* Microsoft Ads
* Outbrain Ads
* Pinterest Ads
* Reddit Ads
* Snapchat Ads
* Taboola Ads
* TikTok Ads
* X (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/)
* [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.

= How can I report security bugs? =

You can report security bugs through the Patchstack Vulnerability Disclosure Program. The Patchstack team helps validate, triage, and handle any security vulnerabilities. [Report a security vulnerability.]( https://patchstack.com/database/vdp/9e5fb86a-6813-46f6-90e8-79d46b61cf46 )

== Screenshots ==

1. Settings page

== Changelog ==

= 1.54.1  =
*Release date - 15.12.2025*

* Tweak: Added a missing check for Contentsquare

= 1.54.0  =
*Release date - 15.12.2025*
* Tweak: Admin UX improvements in the settings page.
* Tweak: Refactored opportunity card output: sort by impact level and streamline dismissed opportunities
* Tweak: Enhanced client IP address handling
* Tweak: Add external object cache detection and enhance debug info output
* Tweak: Enhanced transient handling: add verification for transient storage to improve reliability with external object caches

= 1.53.0  =
*Release date - 09.12.2025*

* New: Implement Google Tag Gateway Proxy for proxying requests to Google's First-Party Servers
* Tweak: Added support for loading deprecated functions with user toggle in settings
* Tweak: Simplified documentation link retrieval by removing unnecessary parameters
* Tweak: Added notification badges
* Tweak: Enhanced Facebook Pixel script loading and user data caching
* Tweak: Added multiple enhancement opportunity notifications for various settings
* Tweak: Added crossDomain option to AJAX requests
* Tweak: Replaced jQuery.ajax with native script loading for improved performance and error handling
* Tweak: Removed unused code and files

= 1.52.1  =
*Release date - 03.12.2025*

* Tweak: Added new documenation links.
* Tweak: Updated the GA4 tag ID format.
* Tweak: Updated Google tag ID suppression logic in functions.js
* Tweak: Implemented public front-end API for third-party integrations with event dispatching and consent context

= 1.52.0  =
*Release date - 01.12.2025*

* Tweak: Bumped up WP version compatibility to 6.9
* Tweak: Filter out non-existent or unpublished products from transient data
* Tweak: Refactored pixel file structure to unify server-side and browser-side handling, implementing a centralized pixel registry for improved management and automatic detection of active pixels.
* Tweak: Added validations for some input data.

= 1.51.1  =
*Release date - 27.11.2025*

* Fix: Fixed chunk loading compatibility with script optimization plugins (that combine JavaScript) by setting the .js public path dynamically (with an absolute instead of a relative path).
* Fix: Disabled the Composer APCU optimization since it caused loading issues on a small subset of servers.

= 1.51.0  =
*Release date - 25.11.2025*

* New: Event filtering system.
* Tweak: Added error handling in the queue runner.
* Tweak: Added null and undefined check in visitor permission logic.
* Tweak: Updated the documentation links.
* Tweak: Bumped up Facebook CAPI API version to v24.0.
* Fix: Fixed chunk loading compatibility with script optimization plugins (SiteGround Optimizer, Autoptimize, WP Rocket, etc.) by implementing webpack runtime publicPath configuration.

= 1.50.1 =
*Release date - 19.11.2025*

* Fix: Fixed undefined check for visitorAllowed cache.

= 1.50.0  =
*Release date - 16.11.2025*

* New: Split the tracking library into chunks to only load the necessary code for the active pixels and features.
* Tweak: Switched bot detection from IP based to user-agent based for better accuracy, flexibility, and much smaller file size.
* Tweak: Added support in the pmw_google_ads_conversion_identifiers filter for multiple labels for the same Google Ads conversion ID.
* Tweak: Updated vendor packages.
* Tweak: Added filter to take over control of the Reddit tracking pixel in case the Reddit pixel is active in the Pixel Manager and the official Reddit for WooCommerce plugin is also active.

= 1.49.3  =
*Release date - 06.11.2025*

* Tweak: Replaced Cody widget with Chatbase widget.
* Tweak: Added chatbot widget with side panel.
* Fix: Fixed product ID validation and filtered unpublished products in get_products_for_datalayer_by_product_ids. (CVE-2025-12545)

= 1.49.2  =
*Release date - 07.10.2025*

* Tweak: Expanded consent mode regions by adding entries for 11 additional U.S. states.
* Tweak: Updated the `add-to-cart` URL parameter handling to include an optional `quantity` parameter.
* Tweak: Added payment type details to Google Analytics events.
* Tweak: Refactored order item price handling for Google Ads cart items to always exclude tax.
* Tweak: Automatically detect disabled Google tags after combining Google tags and prevent running a config command for them.
* Tweak: Updated vendor packages.
* Tweak: Refactored gateway analysis calculations for improved clarity and accuracy.
* Tweak: Bumped up WC version compatibility to 10.2
* Fix: Moved the GLA activation filter to the init hook. It prevented other Pixel Manager filters from being applied.

= 1.49.1  =
*Release date - 18.06.2025*

* Tweak: Updated plugin URI to SweetCode site.
* Tweak: Automatic options backup on plugin upgrades.
* Fix: Fixed edge-case XSS vulnerabilities related to unquoted product ID injection in post-editing scenarios. Exploitation required specific conditions and permissions.
* Fix: Fixed the "Show recent log file" link in the logs tab.

= 1.49.0  =
*Release date - 10.06.2025*

* New: Added a new queue runner _pmwq for developers who want to run Pixel Manager functions, no matter when the Pixel Manager is loaded.
* New: Added a new automatic settings backup feature.
* Tweak: Updated Wistia embed script and styling for better integration.
* Tweak: Various admin UX improvements.
* Tweak: Added a health check for the Google Tag Gateway.
* Tweak: Removed some unused code.
* Tweak: Added method to convert LTV order values to base currency when the shop uses specific multi-currency plugins.
* Tweak: Improved payment gateway retrieval logic.
* Tweak: Bumped up WC version compatibility to 9.9

= 1.48.0  =
*Release date - 22.05.2025*

* New: Support for Google tag gateway for advertisers.
* Tweak: Many code improvements to reduce Plugin Check warnings and errors.
* Tweak: Bumped up WP version compatibility to 6.8
* Tweak: Bumped up WC version compatibility to 9.8
* Tweak: Added filter to declare WP Consent API compatibility.
* Tweak: Removed some cruft.
* Tweak: Added console log for Meta (Facebook) custom event tracking.
* Tweak: Updated vendor packages.
* Tweak: Optimized the show_variation event listener to prevent issues on small subset of themes.
* Tweak: Added optional fallback URL for the script loader.
* Tweak: Optimized filter loading.
* Tweak: Optimized the event script for Google shortcodes.
* Tweak: Improved the cache purge logic to also purge transients that cache certain options.
* Fix: Removed a possible recursion to prevent a memory overallocation error in some edge cases in class-opportunties.php.
* Fix: Fixed the facebook_for_woocommerce_integration_pixel_enabled filter.

= 1.47.1  =
*Release date - 17.04.2025*

* New: Released the free version of the plugin on the woocommerce.org marketplace.

= 1.47.0  =
*Release date - 31.03.2025*

* Tweak: Cast permission callback return values to prevent semgrep warnings.
* Tweak: Added a feature to show the PMW pro features demo in the wp.org playground.
* Tweak: Removed some cruft.
* Tweak: Added new pmw_options filter that allows to filter the options array before it is used.
* Tweak: Added order extra details output that helps with debugging.
* Tweak: Improved the loading logic to prevent fatal errors if several versions of the plugin are activated at the same time.
* Tweak: Numerous code syntax improvements.
* Tweak: Improved variation name output for GA4.
* Tweak: Added support fo the new WooCommerce internal brand feature.
* Tweak: Improved the update_cart event listener.

= 1.46.1  =
*Release date - 27.01.2025*

* Tweak: Cast permission_callback input variable into bool.
* Tweak: Workaround for a rare Google tracking ID URL bug.
* Tweak: Added a safeguard to prevent a fatal error in some edge cases when third-party code changes the data output from a string to an array in prepare_custom_rest_handlers.
* Tweak: Bumped up WC version compatibility to 9.6

= 1.46.0  =
*Release date - 09.01.2025*

* New: Added support for the Cookiefirst CMP.
* Tweak: Added safeguard to get_payment_gateways method to prevent a fatal error in some edge cases when a payment gateway is not following the WooCommerce standard.
* Tweak: Added data collection placeholder for gateway analysis when the analysis is run when no orders have been processed through the Pixel Manager yet.
* Tweak: Bumped up WC version compatibility to 9.5
* Tweak: Bumped up WP version compatibility to 6.7
* Tweak: Switched gtag.js ID priority from GA4 to Google Ads, as GA4 in rare cases is buggy and returns a 404.
* Tweak: Prevent double logging of payment method change.
* Tweak: Reactivated the AI support chat bot.

= 1.45.0  =
*Release date - 29.10.2024*

* Tweak: Allow shop managers to access the settings page.
* Tweak: Updated vendor packages.

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