# WooCommerce server-side tracking plugin

> The WooCommerce plugin that sends your conversions to Meta, GA4 and Google Ads from the server. Retry queue, consent-aware, EU-hosted.

- Original page: https://server-side.datafirefly.com/en/woocommerce-server-side-tracking.html
- Language: en
- Updated: 2026-07-28
- Publisher: DataFirefly (Datafirefly Limited), https://server-side.datafirefly.com/en/

---

WordPress / WooCommerce plugin: version 2.0.1

Install the **datafirefly-serverside** plugin on your WooCommerce store and send the **full funnel, client + server** (page view, product, add to cart, checkout, purchase) to **Meta Conversions API (CAPI), GA4, TikTok, Pinterest and Microsoft Advertising**. Deduplication on a shared event ID, retry queue, Activity panel and GDPR consent gating. A single `dfss_` key, no pixel IDs to paste.

[Create an account](https://admin.datafirefly.com/pricing?lang=en) How to install the plugin

Client + server deduplication Automatic retry queue EU-hosted

The plugin installs from a ZIP uploaded in Plugins → Add New: WooCommerce HPOS compatible.

The flow, end to end

**Your WooCommerce store** datafirefly-serverside plugin: client + server, full-funnel

**DataFirefly dispatcher** EU-hosted in Germany: HMAC-authenticated channel

Meta CAPI GA4 TikTok Pinterest Microsoft Advertising

The problem

## Your WooCommerce browser tags are leaking sales

The Meta pixel, GA4 tag, or TikTok tag in your WordPress theme runs in the customer's browser: where it's increasingly blocked before it even gets to fire.

- **Ad-blockers**

  stop the tags from loading on the thank-you page: the purchase is never reported to your platforms.
- **Safari ITP**

  and similar protections shorten or remove the cookies your conversion tags depend on.
- **Cookie restrictions and consent friction**

  further reduce what browser-side tracking can capture across the whole purchase journey.

The result: incomplete WooCommerce conversions, degraded match quality, and campaigns optimising on a partial view. You're paying for sales you can't fully measure.

The solution

## Complete WooCommerce tracking, client + server

The **datafirefly-serverside** plugin injects a lightweight client layer that tracks the whole funnel, and mirrors every conversion with a **server-side event sent directly to each platform's conversion API** (CAPI). The server-side purchase is the source-of-truth conversion, resistant to ad-blockers.

### Recovered conversions

The server-side purchase is delivered even when an ad-blocker kills the client pixel: you recover conversions that would otherwise be lost.

### Zero double-counting

The client pixel and server event share an event ID (`order_<id>`): the destinations deduplicate and count each conversion only once.

### Nothing gets lost

A retry queue with a 5-minute cron replays delivery failures: a brief dispatcher outage costs you no conversion.

How it works on WooCommerce

## Three steps to full-funnel tracking

1

### Install the WooCommerce plugin

Upload **datafirefly-serverside-2.0.1.zip** in Plugins → Add New → Upload Plugin, then activate. Activation creates the retry-queue table and the 5-minute cron.

2

### Paste your connection key

In Settings → DataFirefly Server-Side, paste your single key (`dfss_...`) from "Connect your shop" in /app. It enables full tracking and consent, and runs a test.

3

### Events go out server-side

Every funnel step travels to the dispatcher, which fans it out to all your destinations. The deduplicated server-side purchase is the source-of-truth conversion.

What the plugin does

## The server-side connector for WooCommerce, in detail

### Full-funnel client + server tracking

Injects lightweight client tags and tracks page view, product, add to cart, checkout and purchase, mirrored with server-side events.

### Dedup on a shared event ID

A single event ID (`order_<id>`) per conversion: the destinations count once, even when client and server both fire.

### Idempotent server-side purchase

The purchase is idempotent across the payment_complete / processing / completed hooks via an optimistic lock: the source-of-truth conversion, resistant to ad-blockers.

### Retry queue + 5-min cron

Retryable delivery failures are replayed automatically: a brief dispatcher outage never loses a conversion.

### DataFirefly Activity panel

Connection status, deliveries over 24h, pending retries, and a live table (refreshed every 30s) of recent events and their status.

### Multi-CMP consent

Auto-detects WP Consent API, Complianz, Cookiebot, IAB TCF v2 and [DataFirefly Cookie Consent](https://www.datafirefly.com/product/datafirefly-cookie-consent-rgpd-consent-mode-v2/). Nothing fires without marketing consent.

### Single dfss\_ key, zero pixels

One connection key configures client and server. The dispatcher supplies the destination IDs: you never paste a pixel ID.

### WooCommerce HPOS compatible

Support for High-Performance Order Storage (HPOS) custom order tables is declared, for high-volume stores.

Destinations

## Meta CAPI, GA4, TikTok, Pinterest and Microsoft Advertising from WooCommerce

The WooCommerce funnel is delivered server-side to your platforms' conversion APIs. Configure it once in your DataFirefly account.

[![Meta logo: Meta Conversions API (CAPI) server-side destination](https://server-side.datafirefly.com/assets/logos/meta.svg) Meta Conversions API CAPI](https://server-side.datafirefly.com/en/woocommerce-meta-capi-server-side-tracking.html) [![GA4 logo: Google Analytics 4 destination via Measurement Protocol](https://server-side.datafirefly.com/assets/logos/ga4.svg) GA4 Measurement Protocol](https://server-side.datafirefly.com/en/woocommerce-ga4-server-side-tracking.html) [![TikTok logo: TikTok Events API server-side destination](https://server-side.datafirefly.com/assets/logos/tiktok.svg) TikTok Events API](https://server-side.datafirefly.com/en/tiktok-events-api-server-side-tracking.html) [![Pinterest logo: Pinterest Conversions API server-side destination](https://server-side.datafirefly.com/assets/logos/pinterest.svg) Pinterest Conversions API](https://server-side.datafirefly.com/en/pinterest-conversions-api-server-side-tracking.html) [![Google Ads logo: destination via Google Ads Data Manager API](https://server-side.datafirefly.com/assets/logos/google-ads.svg) Google Ads Data Manager API](https://server-side.datafirefly.com/en/woocommerce-google-ads-server-side-tracking.html) [![Microsoft Advertising logo: destination via Microsoft Advertising Conversions API](https://server-side.datafirefly.com/assets/logos/microsoft-ads.svg) Microsoft Advertising Conversions API](https://server-side.datafirefly.com/en/microsoft-ads-conversions-api-server-side-tracking.html)

Google Ads (Data Manager API) is available at the platform level. The WooCommerce plugin 2.0.1 delivers the funnel to Meta CAPI, GA4, TikTok, Pinterest and Microsoft Advertising.

Installation

## Install the server-side plugin on WooCommerce

Requirements: WordPress 5.8+, WooCommerce 5.0+ (HPOS supported), PHP 7.4+, a DataFirefly server-side account and outbound HTTPS access to serverside.datafirefly.com.

1

### Get your connection key

In "Connect your shop" in your DataFirefly account (/app), copy your **connection key** (a single string that starts with `dfss_`). It encodes Tenant ID, HMAC secret and endpoint.

2

### Upload the ZIP in WP Admin

Plugins → Add New → **Upload Plugin**, select **datafirefly-serverside-2.0.1.zip**, install then **Activate**. Activation creates the retry queue and schedules the 5-minute cron.

3

### Connect with the single key

Settings → DataFirefly Server-Side → **Connect your shop**: paste the `dfss_...` key and click **Connect**. Full tracking and consent turn on, the config is pulled from the dispatcher, and a test runs automatically.

4

### Verify in Activity + Inspector

Click **Send test event**, then open **Settings → DataFirefly Activity** to see live status. Place a test order and confirm a `purchase` row marked "Delivered", then verify in the Inspector (/app).

Behind a CDN or reverse proxy, supply the real client IP via the `dfss_client_ip` filter for better rate limiting and better CAPI match quality.

Pricing

## Simple pricing that scales with your store

One subscription covers your whole account: all of its WooCommerce stores: on a single consolidated invoice. Move up a tier for more sites and more monthly events.

### Free

Free while you stay under the monthly allowance: nothing breaks if you go over.

€0 / month

**1** site included

Up to **10,000** events / month

No credit card required

[Start free](https://server-side.datafirefly.com/en/free.html)

### Starter

For a single WooCommerce store getting server-side tracking in place.

**€39** / month (Monthly) · **€32** / month (Yearly 2 months free)

Billed €390 per year: 12 months commitment, no pro-rata refund.

**1** site included

Up to **500K** events / month

One consolidated invoice

[Choose Starter](https://admin.datafirefly.com/pricing?lang=en&plan=starter)

Most popular

### Growth

For merchants and small agencies running up to five stores.

**€119** / month (Monthly) · **€99** / month (Yearly 2 months free)

Billed €1 190 per year: 12 months commitment, no pro-rata refund.

**5** sites included

Up to **2M** events / month

One consolidated invoice

[Choose Growth](https://admin.datafirefly.com/pricing?lang=en&plan=growth)

### Scale

For agencies and portfolios managing up to twenty stores at higher volume.

**€349** / month (Monthly) · **€290** / month (Yearly 2 months free)

Billed €3 490 per year: 12 months commitment, no pro-rata refund.

**20** sites included

Up to **10M** events / month

One consolidated invoice

[Choose Scale](https://admin.datafirefly.com/pricing?lang=en&plan=scale)

The WooCommerce plugin is included in every plan. See the [full pricing on the homepage](https://server-side.datafirefly.com/en/#pricing).

Trust & GDPR

## Built for European privacy standards

**EU-hosted (Germany)**

Your data is processed in the EU.

**Multi-CMP consent**

WP Consent API, Complianz, Cookiebot, IAB TCF v2, DataFirefly Cookie Consent.

**Hardened beacon endpoint**

Per-IP rate limiting, size cap, per-field sanitisation, server-side identity.

**HMAC secret never exposed**

The signing key never leaves the server; nor do the destination tokens.

**Reliable delivery**

Retry queue + 5-min cron: a passing outage loses no conversion.

**99.5% availability target**

Measured and tracked in real time on our [public status page](https://serverside.datafirefly.com/status), in line with our SLA.

FAQ

## Frequently asked questions: WooCommerce plugin

### What is the server-side tracking plugin for WooCommerce?

The **datafirefly-serverside** plugin (version 2.0.1) delivers complete tracking for WooCommerce: client + server, full-funnel (page view, product view, add to cart, checkout, purchase). Events are sent to each platform's conversion API (Meta CAPI, GA4, TikTok, Pinterest, Microsoft Advertising). The server-side purchase is the source-of-truth conversion, resistant to ad-blockers.

### Will the plugin count my WooCommerce conversions twice?

No. Every conversion carries a shared event ID (`order_<id>` for purchases). The injected client pixel and the server-side event are deduplicated by the destinations on that ID: the conversion is counted only once, even when both fire, and the server path delivers it when an ad-blocker kills the client pixel.

### How does the WooCommerce plugin connect?

With a single key. From "Connect your shop" in your DataFirefly account (/app), copy your connection key (it starts with `dfss_`) and paste it into Settings → DataFirefly Server-Side. It encodes Tenant ID, HMAC secret and endpoint, enables full tracking and consent, and runs a test automatically. You never paste any pixel ID.

### Does the plugin handle consent and CMPs (GDPR)?

Yes. With **Require consent** (on by default), the plugin gates both layers on marketing consent and auto-detects your stack: WP Consent API, Complianz, Cookiebot, IAB TCF v2 and DataFirefly Cookie Consent. The browser tracker injects nothing until consent is granted, and the server endpoint applies a second consent check.

### Is the plugin compatible with HPOS and high load?

Yes. WooCommerce HPOS compatibility (custom order tables) is declared. A retry queue with a 5-minute cron automatically replays retryable delivery failures: a brief dispatcher outage loses no conversion. A **DataFirefly Activity** panel shows the status in real time.

On PrestaShop instead? [Discover the PrestaShop server-side tracking module](https://server-side.datafirefly.com/en/prestashop-server-side-tracking.html).

## Move your WooCommerce store's tracking server-side

Send the complete, deduplicated funnel server-side to Meta CAPI, GA4, TikTok, Pinterest and Microsoft Advertising, with a retry queue, Activity panel, EU-hosted and consent-aware.

[Create an account](https://admin.datafirefly.com/pricing?lang=en) [Talk to us](https://server-side.datafirefly.com/en/contact.html)
