=== ROAS Tool Kits for Meta (Post & Product Catalogue) ===
Contributors: roasmetatools
Donate link: https://debtfixer.co.uk/
Tags: woocommerce, meta, pixel, tracking, catalog, feed
Requires at least: 6.0
Requires PHP: 8.0
Tested up to: 6.5
Stable tag: 1.4.5
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Maximize ad performance on Meta and Google with dynamic article feeds, product catalogs, and anti-bot CAPI deduplication.

== Description ==

ROAS Tool Kits for Meta helps digital publishers and eCommerce stores align their WordPress site with advertising networks. Maximize your return on ad spend (ROAS) with dynamic multi-feed catalogs and reliable conversion tracking.

Key Features:
* **Dynamic Content Feeds:** Generate specialized XML catalogs (`/feed/meta-catalog/`) designed for content arbitrage and dynamic ads on Meta.
* **E-commerce Catalog Support:** Synchronize standard WooCommerce product data for Google Merchant Center and Meta Commerce Manager.
* **Conversion API (CAPI) and Server-Side Deduplication:** Prevent double-counting of events with smart browser-to-server matching.
* **SEO Title Injection:** Automatically pull custom titles from Yoast SEO or Rank Math for superior feed optimization.

== Installation ==

1. Upload the `roas-tool-kits-for-meta` folder to the `/wp-content/plugins/` directory.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Navigate to **ROAS Tool Kits** in your WordPress dashboard to configure your identifiers and tracking pixels.
4. For the Pro version, add your tracking keys and enable server-side deduplication in the integration settings.

== Frequently Asked Questions ==

= Does the content feed work on Google Merchant Center? =
The article feed is designed primarily for Meta Advantage+ campaigns. E-commerce product catalogs are fully supported for both platforms.

= How do I prevent internal bot tracking? =
The plugin has a built-in anti-bot engine which blocks crawl requests from platforms like Google lighthouse, preserving your CAPI data quality.

== Screenshots ==

1. **ROAS Tool Kits - Lite Dashboard**
   Displays the main setup area for the free version. Shows the XML feed generator configuration and the standard Meta Pixel initialization panel.

2. **ROAS Tool Kits - Catalog Integration**
   Demonstrates Meta Commerce Manager successfully ingesting article post data as products, allowing digital publishers to run dynamic campaigns.

3. **ROAS Tool Kits - Pro Features Dashboard**
   Shows the unified pro control center. All options—including CAPI settings, advanced matching, and anti-bot filters—are visible on a single page.

4. **ROAS Tool Kits - Custom Events Engine**
   Illustrates the event-firing screen, highlighting high-intent engagement triggers such as scroll depth and 3+ page-view sessions.

5. **ROAS Tool Kits - Server-Side Deduplication**
   Displays the server-to-browser bridge, showing Event IDs matching and deduplicating events without reliance on external servers.

== Changelog ==

= 1.4.5 =
* Added support for Yoast and Rank Math SEO titles in dynamic catalogs.
* Integrated anti-bot verification for server-side CAPI.
* Updated standard feed paths for content and product management.
* Hardened data hashing routines for WooCommerce Advanced Matching.

= 1.4.0 =
* Initial release of the split post & product catalog engine.