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.
The Shopware plugin, paired to one sales channel with a token.
The purchase price on each order line.
Shopware’s cookie manager, or a supported banner.
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.
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. The app shows 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.
Open Ecommerce platforms
Go to Integrations → Ecommerce platforms and select Connect on Shopware 6.
Start the setup
The Shopware 6 page lists three steps: connect your store, install and pair the extension, and link a property. Select Connect Shopware 6.
Enter your shop URL
Enter the Shopware 6 store URL (your storefront’s HTTPS address) and select Create connection. Check the hostname under Confirm Shopware 6 hostname and copy the one-time pairing token.
Install the plugin
Select Setup guide for how to install the Product Metrics plugin in Shopware, pair it with the token and choose the sales channel.
You should see: the connection read 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
- 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.
- 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.
- 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.
3. Check pairing and link a property
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:
- Consent: leave Not configured to use Shopware’s own cookie manager, or choose OneTrust, Cookiebot, Usercentrics or Osano if your shop shows one. See Consent.
- Channels: connect Google Ads, Meta and ChatGPT Ads (OpenAI).
- Google Ads conversion actions: create them.
- Additional costs: product costs come from Shopware; add payment fees, returns and the rest.
Step by step in Tracking:
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.
Follow the next step
Once your store is connected and linked, the checklist opens the next open step. Each step says what it does.
Configure consent
Under Configure consent, pick the cookie consent platform your storefront uses. The storefront script collects nothing until the visitor agrees.
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.
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.
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.
Check storefront collection
Storefront & data collection shows how tracking runs on your site and which consent and profit settings apply.
Review the Google Ads destination
The Google Ads panel shows the connection, the conversion actions, profit tracking and the enhanced conversions terms.
Check that tracking is live
When every step is done, the badge next to Tracking reads Tracking active, and Tracking shows how many conversion actions receive orders.
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.
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/mcpClaude Code: run this in your terminal.
claude mcp add --transport http product-metrics https://www.productmetrics.io/mcpPaste 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).How it works on Shopware
| On Shopware | |
|---|---|
| Install | Shopware plugin, one sales channel per installation, paired with a one-time token |
| Order sent | Paid orders from the paired sales channel only |
| Product cost | Purchase price on each order line; you add payment fees, returns and the rest |
| Consent | Shopware’s own cookie manager (Not configured), or OneTrust, Cookiebot, Usercentrics or Osano |
| Customer identity | Per sales channel: customer account or guest email |
| Refunds | Shopware’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 |
| Uninstall | Uninstalling or deactivating ends the connection for good; reconnect with a new connection and token |
What you get on Shopware
Each feature, its channels and the Shopware guide for each:
Troubleshooting
| Problem | Fix |
|---|---|
| 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.
Does it work with Shopware’s own cookie manager?
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
Connect Google Ads and Merchant Center.
Send purchases through the Meta Conversions API.
Send purchases through the OpenAI Conversions API.
The checks to run after your first order.
Every platform and channel.
Every setup task and where to find it.
On the website: ad blocker conversion tracking check, Product Metrics for Shopware, Full Signal Tracking, Product Segmentation, pricing