Skip to content
Connect your store

WooCommerce server-side tracking and profit bidding (POAS)

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.

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 on Pro (Billing), and editor or admin access.

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

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 in Tracking opens each of these in turn:

You should see: the badge next to Tracking read Tracking active. Then check tracking works.

Set it up with AI

Connect your assistant

First time? Add the Product Metrics MCP server to your assistant, then paste the prompt below.

In Claude, choose Add custom connector; in ChatGPT, Settings → Apps & Connectors. Paste this URL:

https://www.productmetrics.io/mcp

Claude Code: run this in your terminal.

claude mcp add --transport http product-metrics https://www.productmetrics.io/mcp

CodexAll clients and details →

Paste the prompt into your assistant.

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

How it works on WooCommerce

On WooCommerce
InstallWordPress plugin plus a one-time setup token; store at the domain root over HTTPS
Order sentWhen it reaches a status you marked as paid
Product costWooCommerce Core COGS or a product meta key; payment and actual shipping from order meta keys, or your additional costs
ConsentOneTrust, Cookiebot, Usercentrics or Osano
Customer identityCustomer account, or billing email for guests
RefundsWooCommerce updates the order; Product Metrics reads it again and adjusts the conversion
RemoveWooCommerce → 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:

Troubleshooting

ProblemFix
“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 refusedIt 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 warningsUsually 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 fileThe download was incomplete. Download the plugin from Product Metrics again and reinstall.
Fewer conversions than WooCommerce ordersOnly your paid statuses are sent. Check 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.

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

On the website: ad blocker conversion tracking check, Product Metrics for WooCommerce, Full Signal Tracking, Product Segmentation, pricing

Developers: do the same with the CLI or the API.