=== TraceSignals Conversion Tracking ===
Contributors: tracesignals
Tags: analytics, conversion tracking, google analytics, woocommerce, facebook pixel, enhanced conversions, ga4, google ads, ai tracking
Requires at least: 4.6
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Accurate, Enhanced ecommerce tracking for WooCommerce with AI referral tracking. Connect GA4, Google Ads, and Meta Pixel in minutes with zero coding.

== Description ==

TraceSignals is the ultimate marketing and conversion tracking plugin for WooCommerce. Gain crystal clear visibility into your store's performance with built-in **GA4 Enhanced Ecommerce**, **Google Ads Enhanced Conversions**, **Meta (Facebook) Pixel**, and groundbreaking **AI Referral Tracking**. 

Say goodbye to broken pixels and wasted ad spend. TraceSignals fixes your tracking in under 5 minutes without touching a single line of code.

**Powerful Features & Supported Platforms**

* **GA4 (Google Analytics 4):** Sends full Enhanced Ecommerce data including view_item, view_item_list, add_to_cart, begin_checkout, and purchase events automatically.
* **Google Ads Enhanced Conversions:** Boost your ad attribution with secure, hashed first-party customer data (email, phone, address). TraceSignals automatically captures and safely hashes WooCommerce checkout data to bypass ad-blockers and iOS tracking prevention. Also supports dynamic remarketing.
* **Meta (Facebook) Pixel:** Automatically tracks PageView, ViewContent, AddToCart, InitiateCheckout, and Purchase events with dynamic revenue values.
* **AI Referral Engine (Exclusive):** AI is the new search engine. TraceSignals accurately detects and attributes hidden traffic from ChatGPT, Claude, Gemini, Perplexity, and other AI platforms directly into your GA4 reports.

**One-Click Setup & No-Code Tracking**

Simply enter your Google Measurement ID, Google Ads ID, or Meta Pixel ID into the beautiful TraceSignals dashboard, click save, and you're done. No developers required.

**Multi-Pixel Support**

Track all your enabled platforms simultaneously from a single, lightweight settings screen.

**Comprehensive WooCommerce Funnel Tracking**

TraceSignals seamlessly integrates with WooCommerce to track every critical step of the buyer journey:
* **Product Views (`view_item`)** — Fires when a shopper views a specific product.
* **Category Views (`view_item_list`)** — Fires on your shop and category pages.
* **Add to Cart (`add_to_cart`)** — Fires when an item is added to the cart.
* **Begin Checkout (`begin_checkout`)** — Fires when the checkout process is initiated.
* **Purchase (`purchase`)** — Fires on a completed order, including full order revenue, tax, shipping, and item-level data.

**Built for Performance and Security**

* Extremely lightweight — will not slow down your storefront.
* No external dependencies or heavy bloated libraries.
* Follows strict WordPress coding standards.
* Secure data hashing for Google Ads Enhanced Conversions.

= External services =

This plugin connects to external analytics services (Google Analytics and Meta/Facebook Pixel) to track user interactions and conversions on your site.

Depending on your configuration, it sends page views, product interactions, and eCommerce purchase data (including order totals and product IDs) to these services when users browse your storefront. This data is required to provide conversion attribution and remarketing capabilities.

* **Google Analytics / Google Ads:** Data is sent directly to Google's servers. See the [Google Terms of Service](https://policies.google.com/terms) and [Google Privacy Policy](https://policies.google.com/privacy).
* **Meta (Facebook) Pixel:** Data is sent directly to Meta's servers. See the [Meta Terms of Service](https://www.facebook.com/legal/terms) and [Meta Privacy Policy](https://www.facebook.com/privacy/policy/).

By using this plugin you acknowledge that the data described above is transmitted to the third-party services you configure.

== Installation ==

1. Upload the `tracesignals-conversion-tracking` folder to your `/wp-content/plugins/` directory, or install the plugin through the WordPress Plugins screen directly.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Go to **TraceSignals** in the admin sidebar.
4. Enter your Measurement ID or Pixel ID.
5. Check the enable box and click **Save**.

== Frequently Asked Questions ==

= Do I need an analytics account? =

Yes. You should have an account with a supported analytics provider (Google Analytics / Google Ads or Meta) before configuring the plugin.

= Is this privacy compliant? =

The plugin uses standard data anonymization by default. You are responsible for managing user consent according to the regulations that apply to you (such as GDPR or CCPA). The plugin does not store personal data in your local database — all tracking happens client-side via your chosen analytics platform.

= Does this slow down my site? =

No. The tracking scripts load asynchronously and are extremely lightweight.

= Does it work with WooCommerce? =

Yes. eCommerce event tracking (product views, add to cart, checkout, and purchase conversions with revenue) is built for WooCommerce stores.

== Changelog ==

= 1.0.1 - 2025-07-01 =
* Enables Google Consent Mode v2.
* AI Referral Tracking.

= 1.0.0 - 2025-05-10 =
* Initial release.
* Analytics tracking with automatic script injection.
* eCommerce event tracking: product/page views, add to cart, view cart, remove from cart, begin checkout, and purchase (with revenue).
* Multi-site network support.

== Upgrade Notice ==

= 1.0.0 =
Initial release of TraceSignals Conversion Tracking.