Ratul Ads Conversion Tracker (Ratul-ACT) is a self-hosted, enterprise-grade first-party Conversion API (CAPI) and browser tracking gateway for WordPress and WooCommerce.
Designed to bypass ad-blockers and privacy regulations (iOS 14+, Safari ITP), Ratul-ACT routes tracking events directly through your own domain. It synchronizes browser event ids and server dispatches to provide Meta, Google, and TikTok with perfect deduplication data. By eliminating dependency on expensive external tag containers like Stape.io or Google Cloud GTM, it acts as a direct, self-hosted CAPI engine on your WordPress server.
| Feature | Description | Business Benefit |
|---|---|---|
| First-Party Cookie Engine | Issues first-party Set-Cookie headers directly via PHP, protecting tracking identifiers (fbclid, gclid) from Safari's 7-day script caps. |
Extends attribution lifespans to 2 years |
| Ad-Blocker Resilience | Proxies client-side events through a local WordPress REST endpoint. | Recovers up to 20–30% of lost checkout signals |
| Signal Enrichment | Extracts IP, City, State, ZIP, and User-Agent parameters dynamically on the client, with fallbacks for Cloudflare and Nginx. | Maximizes Meta Event Match Quality (EMQ) |
| Anti-Fraud Approval | Prevents automatic purchase tracking, allowing manual confirmation and fraud checks from the admin order screen. | Prevents fake/refunded orders from polluting ad algorithms |
| Fail-Safe Retry Queue | Exponential back-off retry loop that automatically resends failed platform payloads. | Guarantees delivery of server-side conversions |
Both client-side browser triggers and server-side CAPI webhooks report matching Event IDs, allowing Meta to successfully deduplicate actions:
- View Content:
- Add to Cart:
- Initiate Checkout:
Inspect event metrics, health stats, API response logs, and queue retries in real-time.
Loop dispatches to multiple Meta Pixels with toggle controls for PII parameter hashing.
Configure extended WooCommerce triggers (order lifecycle status, wishlist opt-ins) and toggle Manual Purchase Verification.
- Upload the
ratul-ads-conversion-trackerdirectory to/wp-content/plugins/. - Activate the plugin via Plugins → Installed Plugins.
- Go to Ratuls-ACT → Settings to set up your ad platform access tokens.
- Monitor active events and match metrics in Ratuls-ACT → Dashboard.
To explore the deeper mechanics of the plugin, refer to the accompanying documentation files:
- 🛠️ ARCHITECTURE.md: Details the codebase design, data flows, database deduplication engine, and ITP cookie bypass logic.
- 🛡️ COMPLIANCE.md: Explains GDPR/CCPA cookie consent manager integrations (CookieYes, Complianz) and the data security PII blocklist.
Licensed under GPL-2.0-or-later. Created and maintained by MD. Yaser Ahmmed Ratul.