=== GGL Suite - WooCommerce GA4, Google Ads & Product Feeds ===
Contributors: pluginbros, freemius
Tags: woocommerce, google tag manager, ga4, google ads, product feed
Requires at least: 6.5
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 2.0.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

WooCommerce GA4 and Google Ads tracking, Consent Mode v2, product feeds, Customer Match and diagnostics.

== Description ==

= Turn WooCommerce activity into trustworthy growth data =

GGL Suite connects WooCommerce with GTM, GA4 ecommerce, Google Ads, Merchant Center, Customer Match and tracking verification.

**Free is not a demo.** It includes complete browser-side WooCommerce tracking, one daily Merchant Center feed with unlimited eligible products, one daily Customer Match audience with unlimited eligible customers, Consent Mode v2, attribution and Tracking Health. No license or mandatory account is required.

[Compare Free, Pro and Agency](https://www.pluginbros.com/ggl-suite/) | [Documentation](https://www.pluginbros.com/ggl-suite/docs/) | [Support](https://www.pluginbros.com/contact/)

= Complete WooCommerce ecommerce tracking =

GGL Suite emits structured data for classic WooCommerce, AJAX interactions, variations, product lists and supported Blocks flows.

* view_item_list and select_item.
* view_item, add_to_cart and remove_from_cart.
* view_cart and begin_checkout.
* add_shipping_info and add_payment_info.
* purchase with durable transaction and event IDs.
* refund through an authenticated Free browser dispatcher.
* view_promotion and select_promotion.
* Checkout-error and payment-failure diagnostics.
* Optional scroll, form, outbound-click, download, video, registration and login events.

Payloads include the product, pricing, list, coupon, tax, shipping, currency and order data available for each event.

= Google Ads, attribution and privacy =

* Google Ads purchase conversion data and dynamic remarketing parameters.
* Consent-aware browser Enhanced Conversions with normalized SHA-256 user data.
* New-customer status and Google click identifiers.
* First/last-touch attribution, landing page, referrer, UTM parameters, gclid, gbraid, wbraid and fbclid.
* Consent Mode v2 denied defaults and non-essential event suppression.
* Paths for WordPress Consent API, Complianz, CookieYes, Cookiebot and Borlabs.

Google output remains disabled until an administrator configures and enables it.

= Merchant Center feed included in Free =

Free includes one secure Google Merchant Center XML feed, generated daily.

* Unlimited eligible products and variations.
* Core Shopping fields including price, sale price, brand, identifiers, item group and Google category.
* Basic field mapping, Shopping-readiness checks and Catalog Health.
* Secure feed URL and downloadable preview.

Pro adds multiple feeds, advanced rules, profit labels, market variants, WPML/Polylang resolution, currency conversion, flexible schedules and SFTP.

= Customer Match audience included in Free =

Free includes one secure daily audience from all eligible WooCommerce customers.

* Unlimited eligible customers with historical order backfill.
* Consent-aware filtering.
* Normalized and SHA-256 hashed email and phone identifiers.
* Secure export URL and CSV download.

Pro adds multiple audiences, flexible schedules and advanced commerce, lifetime-value and gross-margin segments.

= Verify what really works =

* Weighted Tracking Health with actionable findings.
* Exact browser-event acknowledgements.
* Duplicate GTM and purchase detection.
* Conversion-coverage windows, event inspector, payload validation and logs.
* Guided setup, personalized GTM JSON, snapshots and rollback.

= Optional Pro and Agency =

Pro adds Purchase Protection, server delivery, retries, deduplication, server-side Enhanced Conversions, multiple feeds/audiences, profit values, campaign reporting, POAS, alerts and priority support.

Pro costs **$149 or EUR 149 per year for one site**. Try it for **14 days without a payment method**. Paid plans have a 30-day money-back guarantee.

[Start the optional Pro trial](https://www.pluginbros.com/ggl-suite/#pricing)

Agency costs **$349 or EUR 349 per year** and adds multisite visibility, site-allowance reporting, neutral branding, client-safe output and reusable configuration templates without secrets.

Paid editions are distributed separately. Premium code is not included in this WordPress.org package and cannot be unlocked with a license key.

== Installation ==

1. Install and activate WooCommerce 8.2 or newer.
2. Install GGL Suite through Plugins > Add New.
3. Open PluginBros > GGL Suite.
4. Run setup or enter your GTM container ID.
5. Review Consent & Privacy before enabling output.
6. Import the personalized container into a new GTM workspace.
7. Replace placeholder IDs and verify with GTM Preview, GA4 DebugView and GGL Suite Verify.

== Frequently Asked Questions ==

= Is Free a limited demo? =

No. Free includes complete browser-side ecommerce tracking, Google Ads data, browser Enhanced Conversions, Consent Mode v2, attribution, Tracking Health, one unlimited-product daily feed and one unlimited-customer daily audience.

= Does it replace Google Tag Manager? =

No. GGL Suite can load GTM and pushes structured WooCommerce dataLayer events. You control tags, triggers, consent and destinations. You can instead let another plugin or theme load GTM while keeping the GGL Suite dataLayer enabled.

= Which ecommerce events are included? =

view_item_list, select_item, view_item, add_to_cart, remove_from_cart, view_cart, begin_checkout, add_shipping_info, add_payment_info, purchase, refund, view_promotion and select_promotion, plus checkout-error and payment-failure diagnostics.

= Are feeds and audiences included in Free? =

Yes: one secure daily Merchant Center feed with unlimited eligible products and one secure daily Customer Match audience with unlimited eligible customers. Pro adds multiple definitions, advanced rules, schedules, destinations and segmentation.

= Does the Pro trial require a card? =

No. The optional 14-day Pro trial requires no payment method. Configuration remains if the trial ends while Pro-only automation pauses.

= Are support diagnostics sent automatically? =

No. Diagnostics require preview and explicit administrator consent.

== Screenshots ==

1. Dashboard with tracking, feed, audience and optimisation outcomes.
2. Controls for GA4 ecommerce, Google Ads and Enhanced Conversions.
3. Tracking Health and conversion-coverage diagnostics.
4. Merchant Center Feed and Catalog Health.
5. Customer Match audience status and consent controls.

== Changelog ==

= 2.0.1 =
* Fixed access to GGL Suite tabs and editor routes under the shared PluginBros menu.

= 2.0.0 =
* Added the complete GA4 ecommerce event contract for classic WooCommerce, Blocks, variations, lists, promotions, refunds and checkout/payment errors.
* Added Tracking Health, duplicate detection, conversion coverage, migration rollback and GTM setup assistance.
* Added Merchant Center feeds, Catalog Health and Customer Match audiences by edition.
* Added Purchase Protection, cost/profit tooling, trials and Agency workflows.
* Improved reliability with atomic delivery claims, checkpoints and batched background processing.
* Redesigned administration under PluginBros and fixed editor navigation.

= 1.2.0 =
* Added native support tickets, encrypted rotating tokens and consent-based diagnostics.

== External Services ==

External services are used only when an administrator configures or invokes them.

Google Tag Manager may load the configured container and receive enabled ecommerce, attribution, consent and event data. Terms: https://policies.google.com/terms Privacy: https://policies.google.com/privacy

Google Analytics 4 may receive enabled data through configured GTM tags or optional Pro server delivery. Terms: https://marketingplatform.google.com/about/analytics/terms/us/ Privacy: https://policies.google.com/privacy

Google Ads may receive configured conversions, Enhanced Conversions, remarketing parameters or administrator-submitted Customer Match exports. Terms: https://payments.google.com/payments/apis-secure/u/0/get_legal_document?ldo=0&ldt=buyertos Privacy: https://policies.google.com/privacy

PluginBros Support Bridge requests public configuration from https://www.pluginbros.com/wp-json/pluginbros-support/v1/. Submitted support forms may send contact and installation details, ticket content and attachments. Diagnostics require review and consent. Terms: https://www.pluginbros.com/termsandconditions/ Privacy: https://www.pluginbros.com/privacypolicy/

== Privacy and Data Storage ==

Depending on settings, GGL Suite processes product, cart, order, event, attribution, cost and Customer Match data. Customer Match email/phone values are normalized and SHA-256 hashed. Store owners remain responsible for lawful configuration and consent.

It may store settings, logs, attribution cookies, order metadata, generated files and scheduled hooks. Retention is configurable. Support messages and diagnostics are not stored locally.

== Uninstall ==

Ordinary plugin data is kept by default to prevent accidental loss; encrypted support credentials are always removed. Disable the keep-data setting before uninstalling to request cleanup of remaining plugin data and files.
