Descripción
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:
https://frgzxxszpzclhnkgmkuw.supabase.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:
https://www.souqmetrics.co/
Instalación
New installation
- Make sure WooCommerce is installed and active.
- In your WordPress dashboard, go to Plugins > Add Plugin.
- Search for «SouqMetrics Attribution».
- Click Install Now, then click Activate.
- Go to WooCommerce > SouqMetrics Attribution to review the local diagnostics.
No manual ZIP upload is required when installing from the official WordPress.org Plugin Directory.
Updating an existing installation
- In your WordPress dashboard, go to Plugins > Installed Plugins.
- Find SouqMetrics Attribution.
- Click Update Now when a newer version is available. Do not uninstall the existing plugin first.
- After updating, clear any page cache or CDN cache so the newest browser tracking assets are served immediately.
- Go to WooCommerce > SouqMetrics Attribution to confirm the diagnostics are healthy.
FAQ
-
Does this work with full-page caches and CDNs?
-
Yes. Version 3 captures the landing URL parameters and external referrer in first-party browser code. PHP capture remains only as a backwards-compatible fallback. The acquisition-critical head scripts also opt out of Cloudflare Rocket Loader deferral.
-
Does it support WooCommerce Blocks?
-
Yes. It listens for the WooCommerce Blocks add-to-cart success event and bridges attribution into orders through the Store API checkout order-meta hook.
-
Does it support HPOS?
-
Yes. Order metadata is written through WC_Order CRUD methods and HPOS compatibility is declared to WooCommerce.
-
Does this plugin collect customer PII?
-
The browser tracker is designed not to read or send checkout names, email addresses, phone numbers, addresses, payment details or arbitrary URL query strings. It sends known attribution identifiers and ecommerce event metadata.
-
What happens if a consent plugin uses WP Consent API?
-
When WP Consent API is present, SouqMetrics Attribution waits for the configured statistics/service consent before activating browser tracking. Without WP Consent API, the plugin behaves as first-party analytics immediately after load.
Reseñas
No hay valoraciones para este plugin.
Colaboradores y desarrolladores
«SouqMetrics Attribution» es un software de código abierto. Las siguientes personas han colaborado con este plugin.
Colaboradores
Traduce «SouqMetrics Attribution» a tu idioma.
¿Interesado en el desarrollo?
Revisa el código , echa un vistazo al repositorio SVN o suscríbete al registro de desarrollo por RSS.
Registro de cambios
3.0.1
- Added a WooCommerce-native attribution recovery safety net for orders where browser attribution state is interrupted between product, cart and checkout pages.
- Recovers only allow-listed UTM and advertising click identifiers from WooCommerce order-attribution metadata; arbitrary URL parameters are not copied.
- Supports both classic WooCommerce checkout and Store API / Checkout Blocks order processing.
- Keeps internal WooCommerce URLs as evidence containers rather than incorrectly treating them as external marketing referrers.
3.0.0
- Browser-first acquisition persistence for cached/CDN storefronts.
- Added first-party page_viewed event.
- Added safe landing URL and attribution-touch persistence.
- Fixed client-ID fallback continuity when localStorage is unavailable.
- Mirrored client ID into a first-party cookie for Woo order bridging.
- Preserved all v2 attribution cookie and order-meta keys.
- Added full known attribution-key parity between browser and PHP capture.
- Stripped query strings/fragments from page and referrer URLs.
- Added verified Woo order-key check before checkout_completed browser events.
- Added deterministic checkout and purchase deduplication IDs.
- Added non-AJAX add-to-cart success bridge.
- Retained classic Woo checkout, Store API Blocks checkout and HPOS compatibility.
- Added WooCommerce diagnostics and Site Health tests.
- Added suggested WordPress privacy-policy text and WP Consent API integration.
- Corrected plugin/readme version alignment.
2.0.1
- Host-only cookie handling and attribution improvements.