Skip to content
Connect your store

Shopware server-side tracking and profit bidding (POAS)

Connect a Shopware sales channel 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 plugin reads every paid order from the sales channel you pair, with the purchase price on each line, and serves tracking from a random path on your own Shopware domain. Product Metrics adds profit, new or returning customer and lifetime value, and sends it server-side to each ad channel. No theme code and no Google tag.

Prerequisites

  • Shopware 6.7 with PHP 8.2 or later (the plugin is built for 6.7.14.0; Shopware 5 is not supported), with its scheduled tasks and message workers running: pairing and order sync use them.
  • A Shopware administrator login that can upload and activate extensions, and the sales channel to track, with its public HTTPS address under Sales Channels → your channel → Domains. One installation tracks one sales channel.
  • A workspace on Pro (Billing), editor or admin access, and a property for the orders.

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 Shopware 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 pairing token from the app myself.
Connect my Shopware 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 pairing token from the app myself.
Connect my Shopware 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 pairing 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 Shopware 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 pairing 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 Shopware 6, enter the Shopware 6 store URL (your storefront’s HTTPS address) and select Create connection.

You should see Connection created with the hostname Product Metrics verified and a download link. Check that Verified Shopware 6 hostname is your storefront and select Confirm Shopware 6 hostname to reveal the one-time pairing token. Copy it, download the ZIP, then select Continue to connection. The connection reads Setup required until the plugin pairs.

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

2. Install and pair the plugin in Shopware

  1. Install the plugin from the Shopware Store, or: Extensions → My extensions → Upload extension, Confirm, choose the ZIP without unzipping, Install, and turn its switch on.
  2. Select your sales channel. Select Configure on the Product Metrics card and choose the channel that serves your verified hostname (for example Storefront), not All Sales Channels. Select Unlink inheritance next to Enable this sales channel, Primary HTTPS storefront URL and One-time pairing token.
  3. Pair. Turn on Enable this sales channel, set Primary HTTPS storefront URL to exactly the verified address, paste the token into One-time pairing token, Save.

You should see Configuration saved; the token field clears once pairing finishes in the background.

In Product Metrics, select Verify connection until the store reads Active, then choose the property that should receive the orders. Setup required means the scheduled task hasn’t paired it yet; Pending / Waiting for runtime publication means pairing is done and publication is still running. Allow a few sync cycles and verify again.

You should see the store paired. Until the plugin is installed and paired, it reads Setup required. Once paired, you see the sync status, pending and quarantined jobs, and the last success and error.

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

5. Check it works

Place a test order through the paired sales channel with your payment provider’s test mode and allow a few minutes for sync. Then follow Check tracking, or ask your assistant whether the order arrived.

You should see your test order arrive. With Shopware’s own cookie manager, your banner lists Product Metrics measurement, with Product Metrics analytics and Product Metrics advertising attribution.

How it works on Shopware

On Shopware
InstallShopware plugin, one sales channel per installation, paired with a one-time token
Order sentPaid orders from the paired sales channel only
Product costPurchase price on each order line; you add payment fees, returns and the rest
ConsentShopware’s own cookie manager (Not configured), or OneTrust, Cookiebot, Usercentrics or Osano
Customer identityPer sales channel: customer account or guest email
RefundsShopware’s refund records become a refund on the same order; a cancelled order is marked cancelled. A daily check over the last seven days picks up anything missed
UninstallUninstalling or deactivating ends the connection for good; reconnect with a new connection and token

What you get on Shopware

FeatureChannelsOn this platform
Server-side conversion trackingGoogle Ads · Meta · ChatGPT AdsPaid orders from the paired sales channel; the script loads from a random path.
Enhanced ConversionsGoogle Ads · Meta · ChatGPT AdsEmail, phone, name, postcode and country from the order; cookie manager choice applies.
Customer listsGoogle AdsSix Customer Match lists, filled from your Shopware orders.
POAS and ROAS biddingGoogle Ads · Meta · ChatGPT AdsPurchase price per order line at order time; later price changes don’t rewrite profit.
New customer biddingGoogle Ads · MetaNo earlier paid order in the same sales channel, by account or guest email.
Returning customer biddingGoogle Ads · MetaAn earlier paid order in the same sales channel.
LTV biddingGoogle Ads · Meta · ChatGPT AdsObserved value from paid orders within the paired sales channel.

Troubleshooting

Stays “Setup required” or “Pending”

Pairing runs through Shopware’s scheduled tasks and message workers. Check both run without errors and the storefront is reachable over HTTPS, then verify again.

The token has expired

Open the connection in the app and select Generate one-time setup token. Paste it into One-time pairing token for your sales channel and Save.

The pairing settings are greyed out

They inherit from All Sales Channels. Select Unlink inheritance next to each of the three settings.

Fewer conversions than Shopware orders

Only paid orders from the paired sales channel are sent. Check consent: a banner your shop doesn’t show means the choice reads as not given.

FAQ

Do I need a developer to set it up on Shopware?

No. You install the plugin in Shopware Administration and paste a one-time pairing token; no theme code and no Google tag. Shopware’s scheduled tasks and message workers do need to be running.

Does Product Metrics work with Shopware 5?

No. The plugin needs Shopware 6.7 with PHP 8.2 or later.

Yes. Leave consent on Not configured and Product Metrics follows Shopware’s cookie manager, which then lists Product Metrics measurement. If your shop shows OneTrust, Cookiebot, Usercentrics or Osano, choose that instead.

Does one installation cover all my sales channels?

No. Each installation tracks one sales channel, and only paid orders from that channel are sent.

Where next

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