About this plugin
SouqMetrics Attribution preserves known campaign parameters and advertising click identifiers across a WooCommerce journey and attaches attribution evidence to WooCommerce orders.
Version 3 uses browser-first acquisition capture so cached or CDN-served landing pages do not depend on a WordPress PHP request to preserve attribution. It also tracks first-party page views and WooCommerce funnel events while preserving backwards-compatible cookie and order-meta keys from version 2.
Features include:
- Immediate browser-side landing attribution capture, including a Cloudflare Rocket Loader opt-out for the critical head scripts.
- First-party page-view events.
- UTM, Meta, Google, TikTok, Microsoft, Pinterest and SouqMetrics campaign identifiers.
- Safe landing URL and external referrer storage with query strings and fragments removed.
- WooCommerce native order-attribution recovery when browser attribution state is interrupted during checkout navigation.
- Random client and attribution-touch identifiers; no browser fingerprinting.
- Classic WooCommerce checkout support.
- WooCommerce Cart and Checkout Blocks / Store API support.
- HPOS-compatible WooCommerce order metadata via WC_Order CRUD.
- Stable checkout and purchase deduplication identifiers.
- Verified WooCommerce order-key check before browser purchase events.
- Non-AJAX and AJAX add-to-cart coverage.
- Site Health and WooCommerce diagnostics.
- Optional WP Consent API compatibility when that API is installed by the merchant.
External service
This plugin sends attribution and ecommerce funnel events to the SouqMetrics event service at:
co/functions/v1/track-pixel-event-v2
The service is required for SouqMetrics attribution reporting. The plugin sends a random client ID, event ID, safe page URL, safe external referrer, known campaign parameters/click identifiers, store domain, checkout token when applicable, WooCommerce product metadata for product/cart events, and WooCommerce order ID for verified purchase events.
The plugin is designed not to read or send shopper names, email addresses, phone numbers, billing addresses, shipping addresses or payment details through browser tracking. Page and referrer URLs are stripped of query strings and fragments before being sent.
SouqMetrics service information, Privacy Policy and Terms of Service are published at:
co/