> ## Documentation Index
> Fetch the complete documentation index at: https://5332bee-productmetrics.manicule.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.
> For every page in one file, fetch https://5332bee-productmetrics.manicule.dev/docs/llms-full.txt (large).
> To search and read these docs as tools, connect the MCP server at https://5332bee-productmetrics.manicule.dev/docs/api/mcp.
> Every agent surface: https://5332bee-productmetrics.manicule.dev/docs/.well-known/llms-manifest.json

# WooCommerce server-side tracking and profit bidding (POAS) (/docs/platforms/woocommerce)

<!-- agent-signals: reading_time_min: 11 · est_tokens: 4847 · updated: 2026-11-17 -->
Related: [Connect your store: Shopify, WooCommerce, Magento, Lightspeed, Shopware or any website](/docs/platforms/overview.md), [Shopify server-side tracking and profit bidding (POAS)](/docs/platforms/shopify.md), [Magento server-side tracking and profit bidding (POAS)](/docs/platforms/magento.md), [Lightspeed eCom server-side tracking and profit bidding (POAS)](/docs/platforms/lightspeed.md), [Shopware server-side tracking and profit bidding (POAS)](/docs/platforms/shopware.md), [Server-side tracking and profit bidding on any website (Cloudflare)](/docs/platforms/cloudflare.md)

> Connect your WooCommerce store with the Product Metrics plugin, get server-side conversion tracking live in Google Ads, Meta and ChatGPT Ads, and bid on profit, new customers or lifetime value.

The **Product Metrics for WooCommerce** plugin reads every **paid order** (the statuses you choose) with its product costs and customer, and serves tracking from your own WordPress domain. Product Metrics adds **profit**, **new or returning customer** and **lifetime value**, and sends it server-side to each ad channel. No theme code, no Google tag, no DNS change.



* **Install:** the WordPress plugin and a one-time setup token. No code.
* **Product cost:** WooCommerce Core COGS or a product meta key.
* **Consent banner:** OneTrust, Cookiebot, Usercentrics or Osano.

## Set it up with AI



Setting it up with AI takes one prompt and 60 seconds: paste it into your assistant.



First connect the Product Metrics MCP server ([https://www.productmetrics.io/mcp](https://www.productmetrics.io/mcp); see [Connect your assistant](/docs/mcp/connect)).

**Claude or ChatGPT:** "Connect my WooCommerce store to Product Metrics. Check my setup status first, walk me through each open step, and give me the link when I need to click something; I'll copy the setup token from the app myself."

**Claude Code or Codex:** "Connect my WooCommerce store to Product Metrics and walk me through each open setup step, giving me the link when I need to click something; I'll copy the setup token from the app myself. Use the Product Metrics MCP server, or the productmetrics CLI with --json and the Product Metrics skills if they are installed (run `productmetrics help agents` first)."

## Prerequisites

* A WordPress administrator login, PHP 8.1 or later, WordPress 6.4 or later, and WP-Cron running (the plugin publishes your settings with it).
* Your shop address, starting with `https://`, at the root of the domain: not in a subfolder, no custom port. And a test payment method.
* A [workspace](/docs/using/create-a-workspace) on Pro ([Billing](/docs/using/billing)), and editor or admin access.

## In the app

### 1. Connect your store

Go to **Integrations → Ecommerce platforms → Connect WooCommerce**, enter the shop address and select **Create connection**.



1. **Open Ecommerce platforms.** Go to **Integrations → Ecommerce platforms** and select **Connect** on **WooCommerce**.

   ![The store platform list in Ecommerce platforms: WooCommerce, Magento, Shopware 6, Lightspeed and Custom Store / Webhook Integration, each with a Connect button, with WooCommerce outlined.](/docs/_assets/2ebc5d1cd4423cf2d768fbd96f1313b1766af14df17a4b1549c8fc6319b7a31a)

2. **Start the setup.** The WooCommerce page lists three steps: connect your store, install and connect the plugin, and link a property. Select **Connect WooCommerce**.

   ![The WooCommerce page under Integrations → Ecommerce platforms: 0 of 3 steps done, step 1 Connect your store with the Connect WooCommerce button, then Install and connect the plugin and Link a property.](/docs/_assets/6bf466ca0781081f0c33d4bc5a0ac4efd114540ed8d9521da9bfb016178117d5)

3. **Enter your store URL.** Enter your WooCommerce shop address, starting with `https://`, and select **Create connection**.

   ![The Connect WooCommerce dialog: an empty store URL field and the Cancel and Create connection buttons.](/docs/_assets/7357f34add2e34d551543aa2425c2a017bc05caf12a31e281443f7311e174fb6)

4. **Install and pair the plugin.** Download the plugin ZIP and install it in WordPress Admin, then paste the one-time setup token from this page under **WooCommerce → Product Metrics** and select **Connect store**. The page updates by itself once WooCommerce confirms the connection.

5. **Follow the setup guide.** Select **Setup guide** for every step in WordPress and WooCommerce, with screenshots. You can also download it as a Word document.

   ![The WooCommerce setup guide panel in Product Metrics: a Download Word document button, then Before you begin: a WordPress administrator login, access to your Product Metrics workspace, your shop's web address starting with https:// and a test payment method.](/docs/_assets/207d0b6c5ee392d3400cc9163d1e7178cd68cebfce41c2641d47cdbf4d1d11d2)

6. **Link a property.** With the store connected, choose which Product Metrics property receives its orders under **Link property**. Then authorise Google Ads conversions.

   ![The WooCommerce page under Integrations → Ecommerce platforms for northwind-outfitters.example, Active, 2 of 3 steps done: Connect your store and Install and connect the plugin are done, and Link a property is next, with the Default storefront scope.](/docs/_assets/9d7e72f61e863c6773b2f12d4d99b41449da26142596bb5dd930bbc36ad8fbf8)

   *Example data.*

**You should see:** a **one-time setup token** for the plugin. It expires, but you can make a new one (below).



> **Warning:** The setup token is a secret. Copy it from the app and never paste it into a chat: Claude and ChatGPT never see it.

### 2. Install the plugin in WordPress

Get **Product Metrics for WooCommerce** from the WooCommerce.com Marketplace, or download the ZIP from Product Metrics. In WordPress Admin: **Plugins → Add Plugin → Upload Plugin**, choose the ZIP (don't unzip it), **Install Now**, **Activate Plugin**.

Then open **WooCommerce → Product Metrics**, paste the token into **One-time setup token** and select **Connect store**.

**You should see:** **Store connected successfully.** and **Webhooks: 2 of 2 active**.

Token expired, or the plugin reinstalled? Ask your assistant to make a new setup token, then copy it from the app.

### 3. Choose orders and costs

Under **Orders & product data**:

1. **Paid order statuses**: select the statuses that mean paid, usually **Processing** and **Completed**.
2. **Product identity**: keep **Variation or product ID (recommended)**, unless your product feed uses **SKU** or another identifier.
3. **Product cost**: **WooCommerce Core COGS (recommended)**, a **Product meta key** for a cost plugin, or **Do not import product cost**. Optional: **Payment cost** and **Actual shipping cost** from an **Order meta key** (what you pay the carrier, not what the customer pays).

Select **Save changes**. When you see **Product Metrics settings were saved**, select **Manage connection** to return to **General**.

**You should see:** **Configuration saved** on **General**.

### 4. Test and import

On **General**, select **Test configuration** (checks up to five recent paid orders). If it reports a problem, fix that setting, save and test again. When it passes, select **Send initial orders** once: you should see **Initial import queued**, and the import continues in the background.

Then select **Verify with next paid order**, place and pay for a test order within ten minutes, and select **Refresh connection status**. If ten minutes pass first, select **Verify with next paid order** again and place another order.

**You should see:** **Live order delivery: Verified**.

### 5. Send the store's orders to a property

In Product Metrics, open **Ecommerce platforms**, select the store (it should say **Active**) and choose the property.

**You should see:** the store ready to track, or what is still left to set up.

### 6. Finish tracking setup

The [setup checklist](/docs/using/overview#find-the-next-step) in **Tracking** opens each of these in turn:

* **Consent**: choose your banner (OneTrust, Cookiebot, Usercentrics or Osano), then clear any full-page cache. See [Consent](/docs/using/consent).
* **Channels**: connect [Google Ads](/docs/channels/google-ads), [Meta](/docs/channels/meta) and [ChatGPT Ads (OpenAI)](/docs/channels/openai).
* **Google Ads conversion actions**: [create them](/docs/using/conversion-actions).
* **Additional costs**: [add what WooCommerce doesn't report](/docs/using/costs).

Step by step in **Tracking**:



1. **Open Tracking.** Go to **Integrations → Tracking**. The checklist shows six steps: start by connecting your store, or use Cloudflare Tracking if you have no store platform.

   ![Tracking in Product Metrics with the Complete your tracking setup checklist of six steps, starting with Connect your store.](/docs/_assets/09a584afb1797a0439b68310c4d6085412eafebba1524c019f42a90f3ed4ea37)

2. **Follow the next step.** Once your store is connected and linked, the checklist opens the next open step. Each step says what it does.

   ![The Complete your tracking setup checklist in Tracking: 3 of 6 essential steps completed, with Connect your store, Link the store to this property and Install storefront tracking ticked, and Configure consent open as step 4 with the consent platform still Not configured.](/docs/_assets/b385237058280a34dca53f7f1e42704faa9a8aee59024bd5baafc2211e201e7e)

3. **Configure consent.** Under **Configure consent**, pick the cookie consent platform your storefront uses. The storefront script collects nothing until the visitor agrees.

   ![The Consent management panel in Tracking: the storefront script collects nothing until your cookie banner says the visitor agreed, a Not configured status, and the Consent platform dropdown.](/docs/_assets/f0a8d61eaa086657ce840c85899df48d5f3a7a52fb6c552710f93b1482b90e72)



1. **Create Google Ads conversions.** Under **Create Google Ads conversions**, select **Create 8 conversion actions**. Product Metrics manages one Google Ads conversion action per purpose; they start as secondary goals, and you choose the primary goal in Google Ads.

   ![The Conversion actions page in Product Metrics, opened from Tracking: Not configured, 0 of 8 managed and the Create 8 conversion actions button. Below it, Customer types (New customer revenue and profit, Returning customer revenue and profit) and Order value (Order revenue, Order profit), each Missing with Google goal status Unknown, and the Lifetime value group heading.](/docs/_assets/816fdc81f1068f5d013a17d0d26166a0834cc61c69943d0c05d5171b557e0652)



1. **Add your additional costs.** Product costs come from your store where it reports them. Under **Add your additional costs**, add shipping, handling, returns and payment fees, set **Product cost fallback (%)** and select **Activate additional costs**, so the profit conversions carry real profit.

**You should see:** the badge next to **Tracking** read **Tracking active**. Then [check tracking works](/docs/using/check-tracking).

## How it works on WooCommerce

|                       | On WooCommerce                                                                                                          |
| --------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| **Install**           | WordPress plugin plus a one-time setup token; store at the domain root over HTTPS                                       |
| **Order sent**        | When it reaches a status you marked as paid                                                                             |
| **Product cost**      | WooCommerce Core COGS or a product meta key; payment and actual shipping from order meta keys, or your additional costs |
| **Consent**           | OneTrust, Cookiebot, Usercentrics or Osano                                                                              |
| **Customer identity** | Customer account, or billing email for guests                                                                           |
| **Refunds**           | WooCommerce updates the order; Product Metrics reads it again and adjusts the conversion                                |
| **Remove**            | **WooCommerce → Product Metrics → Disconnect store**, then deactivate and delete the plugin. Reinstall with a new token |

## What you get on WooCommerce

Each feature, its channels and the WooCommerce guide for each:



**Features and guides on WooCommerce**

| Feature                                                                | Channels                                                                                                                                                                                         | On this platform                                                                      |
| ---------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------- |
| [Server-side conversion tracking](/docs/features/ad-blocker-proof-tracking) | [Google Ads](/docs/tracking/server-side/woocommerce-google-ads) · [Meta](/docs/tracking/server-side/woocommerce-meta) · [ChatGPT Ads](/docs/tracking/server-side/woocommerce-openai)                            | Orders in your paid statuses; endpoint on your WordPress domain; HPOS supported.      |
| [Enhanced Conversions](/docs/features/enhanced-conversions)                 | [Google Ads](/docs/tracking/enhanced-conversions/woocommerce-google-ads) · [Meta](/docs/tracking/enhanced-conversions/woocommerce-meta) · [ChatGPT Ads](/docs/tracking/enhanced-conversions/woocommerce-openai) | Billing email, phone, name, postcode and country; only with ad user data consent.     |
| [Customer lists](/docs/features/customer-list)                              | [Google Ads](/docs/tracking/customer-lists/woocommerce-google-ads)                                                                                                                                    | Six Customer Match lists, filled from your WooCommerce orders.                        |
| [POAS and ROAS bidding](/docs/features/poas-bidding)                        | [Google Ads](/docs/bidding/poas/woocommerce-google-ads) · [Meta](/docs/bidding/poas/woocommerce-meta) · [ChatGPT Ads](/docs/bidding/poas/woocommerce-openai)                                                    | Core COGS or meta keys for product, payment and shipping costs; recorded when read.   |
| [New customer bidding](/docs/features/new-customer-bidding)                 | [Google Ads](/docs/bidding/new-customers/woocommerce-google-ads) · [Meta](/docs/bidding/new-customers/woocommerce-meta)                                                                                    | Earlier paid orders by account or guest billing email; only your paid statuses count. |
| [Returning customer bidding](/docs/features/returning-customer-bidding)     | [Google Ads](/docs/bidding/returning-customers/woocommerce-google-ads) · [Meta](/docs/bidding/returning-customers/woocommerce-meta)                                                                        | Matched the same way: by account, or guest billing email.                             |
| [LTV bidding](/docs/features/ltv-bidding)                                   | [Google Ads](/docs/bidding/ltv/woocommerce-google-ads) · [Meta](/docs/bidding/ltv/woocommerce-meta) · [ChatGPT Ads](/docs/bidding/ltv/woocommerce-openai)                                                       | Observed value from paid WooCommerce orders, not a prediction.                        |

## Troubleshooting

| Problem                                                       | Fix                                                                                                                                                                                                                      |
| ------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **"Could not connect the store"**                             | The setup token is wrong or expired. Make a new one (step 2), paste it and select **Connect store**.                                                                                                                     |
| **"The store was claimed, but webhook setup did not finish"** | Select **Retry webhook setup**. If webhooks later drop below **2 of 2 active**, use **Repair webhooks** under **Advanced connection tools**.                                                                             |
| **The shop address is refused**                               | It must start with `https://`, sit at the domain root and have no custom port. `https://example.com/shop` is not accepted.                                                                                               |
| **"Configuration test failed" or warnings**                   | Usually the product identity doesn't match your products, or a cost field is empty. Fix it in **Orders & product data**, save and test again before sending initial orders.                                              |
| **The plugin says it is missing its environment file**        | The download was incomplete. Download the plugin from Product Metrics again and reinstall.                                                                                                                               |
| **Fewer conversions than WooCommerce orders**                 | Only your paid statuses are sent. Check [consent](/docs/using/consent): without a supported banner, or with **Not configured**, Product Metrics treats the choice as not given. Clear your full-page cache after changing it. |

## FAQ

### Do I need a developer to set it up on WooCommerce?

No. You install the plugin in WordPress Admin, paste a one-time setup token and choose your paid statuses and cost source. No theme code, no Google tag and no DNS change.

### How is Product Metrics billed on WooCommerce?

Connecting WooCommerce needs Pro, paid through a Stripe subscription. Pro is a graduated share of your rolling 30-day Google Shopping spend, the first €10K each month is free, and server-side tracking is included.

### Where do product costs come from on WooCommerce?

From WooCommerce Core COGS, or a product meta key if a cost plugin stores them. Payment and actual shipping cost can come from order meta keys; anything else you add as [additional costs](/docs/using/costs).

### Does it work with my cookie banner?

Yes, with OneTrust, Cookiebot, Usercentrics or Osano. Choose it in **Configure consent**, then clear any full-page cache so visitors get the new setting.

## Where next



* [Google Ads](/docs/channels/google-ads): connect Google Ads and Merchant Center
* [Meta](/docs/channels/meta): send purchases through the Meta Conversions API
* [ChatGPT Ads (OpenAI)](/docs/channels/openai): send purchases through the OpenAI Conversions API
* [Check tracking works](/docs/using/check-tracking): the checks to run after your first order
* [Server-side conversion tracking](/docs/features/ad-blocker-proof-tracking): every platform and channel
* [Overview of every setup task](/docs/using/overview): every setup task and where to find it

On the website: [ad blocker conversion tracking check](https://www.productmetrics.io/ad-blocker-conversion-tracking), [Product Metrics for WooCommerce](https://www.productmetrics.io/platforms/woocommerce), [Full Signal Tracking](https://www.productmetrics.io/server-side-tracking), [Product Segmentation](https://www.productmetrics.io/product-segmentation), [pricing](https://www.productmetrics.io/pricing)

Developers: do the same with the [CLI](/docs/cli/commands#stores-and-tracking) or the [API](/docs/api/stores-and-tracking/stores-create-woocommerce-setup-claim).
