> ## Documentation Index
> Fetch the complete documentation index at: https://85b42a7-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://85b42a7-productmetrics.manicule.dev/docs/llms-full.txt (large).
> To search and read these docs as tools, connect the MCP server at https://85b42a7-productmetrics.manicule.dev/docs/api/mcp.
> Every agent surface: https://85b42a7-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: 7 · est_tokens: 3061 · updated: 2026-11-16 -->
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.

## 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.

## Set it up with AI



Paste the prompt 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)."

## In the app

### 1. Connect your store

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

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**.

### 4. Test and import

On **General**, select **Test configuration** (checks up to five recent paid orders). When it passes, select **Send initial orders** once.

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

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).

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

| 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

### "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), [Meta](/docs/channels/meta) and [ChatGPT Ads (OpenAI)](/docs/channels/openai)
* [Check tracking works](/docs/using/check-tracking)
* [Ad blocker conversion tracking check](https://www.productmetrics.io/ad-blocker-conversion-tracking)
* [Overview of every setup task](/docs/using/overview)
* On the website: [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).
