Ecommerce Configuration

Ecommerce tracking enables server-side order capture from Shopify and WooCommerce. Available on Clarity plans and above.

Accessing Ecommerce Settings

1. Go to Configuration in the sidebar
2. Select your domain
3. Click the Ecommerce tab

If you're on a Pulse or Signal plan, you'll see an upgrade prompt instead of the settings.

Shopify Integration

Webhook Setup

CleanClicks uses a Shopify webhook to receive order data server-side. This ensures conversions are captured even if the customer's browser closes before the confirmation page loads.

The Ecommerce tab provides:

• Webhook URL — copy this into Shopify
• Webhook Secret — used for secure verification

To configure in Shopify:

1. Go to Shopify Admin > Settings > Notifications > Webhooks
2. Click Create Webhook
3. Event: Order payment
4. Format: JSON
5. URL: paste the webhook URL from CleanClicks
6. Click Save

Custom Pixel

Shopify also needs the client-side Custom Pixel for capturing browsing events (page views, product views, cart actions). See Shopify Setup for pixel installation.

The webhook and pixel work together: the pixel captures the browsing journey, and the webhook ensures the purchase is always recorded.

WooCommerce Integration

WordPress Plugin

The CleanClicks WordPress plugin (v1.6.1) handles both client-side event tracking and server-side conversion capture. Install the plugin and the rest is automatic.

See WordPress Setup for the full plugin reference. Quick summary:

1. Download the plugin from this Ecommerce tab
2. Upload + activate in WordPress
3. Enter your Inbound API Key (from Configuration → Integrations tab) in Settings → CleanClicks → save

Server-Side Webhook (Automatic)

On activation, the plugin auto-creates a WooCommerce order.created webhook pointed at your CleanClicks proxy, signed with your Inbound API Key. No manual webhook configuration required.

Verify it in WordPress Admin → WooCommerce → Settings → Advanced → Webhooks — look for "CleanClicks Conversion Capture."

The plugin layers two additional server-side capture paths on top of the standard webhook: a woocommerce_payment_complete hook for subscription renewals and offsite checkout returns, and a configurable purchase_paths allowlist for custom thank-you pages. See WordPress Setup → Server-Side Conversion Capture for the full three-layer reference.

Webhook Status

The plugin settings page shows a live Webhook Status card. If the auto-created webhook is ever missing or in an error state, the card surfaces the reason and offers a Recreate Webhook button.

Plugin Download

The Ecommerce tab includes a download link for the CleanClicks WordPress plugin. This is the same plugin described in WordPress Setup.

What Gets Tracked

Both Shopify and WooCommerce integrations capture:

Customer emails are SHA-256 hashed before being sent to ad platforms. The raw email is never shared with third parties.

Attribution

When a webhook or server-side event arrives, CleanClicks looks up the associated visitor session to recover:

• Original click IDs from ad platforms
• UTM parameters
• Geographic data from the original visit
• Analytics session IDs (GA4, Usermaven)

This means server-side conversions get the same attribution quality as client-side events. Even if the visitor used an ad blocker or closed their browser, the conversion is attributed to the correct campaign and ad click.

---

Next: Advanced Settings