> ## Documentation Index
> Fetch the complete documentation index at: https://c1ae7e1-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://c1ae7e1-productmetrics.manicule.dev/docs/llms-full.txt (large).
> To search and read these docs as tools, connect the MCP server at https://c1ae7e1-productmetrics.manicule.dev/docs/api/mcp.
> Every agent surface: https://c1ae7e1-productmetrics.manicule.dev/docs/.well-known/llms-manifest.json

# Shopware server-side tracking and profit bidding (POAS) (/docs/platforms/shopware)

<!-- agent-signals: reading_time_min: 11 · est_tokens: 4800 · 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), [WooCommerce server-side tracking and profit bidding (POAS)](/docs/platforms/woocommerce.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), [Server-side tracking and profit bidding on any website (Cloudflare)](/docs/platforms/cloudflare.md)

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



* **Install:** the Shopware plugin, paired to one sales channel with a token.
* **Product cost:** the purchase price on each order line.
* **Consent banner:** Shopware's cookie manager, or a supported 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 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."

**Claude Code or Codex:** "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)."

## 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](/docs/using/create-a-workspace) on Pro ([Billing](/docs/using/billing)), editor or admin access, and a property for the orders.

## In the app

### 1. Connect your store

Go to **Integrations → 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**.



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

   ![Ecommerce platforms under Integrations, listing the supported store platforms with a Connect button on Shopware 6.](/docs/_assets/b9dd8ce181beb76f3d219f10f87e3a54557d5a0b598ac58719538c290eb0d83c)

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

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

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

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

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

   ![The Shopware 6 setup guide panel in Product Metrics: Download Word document, Before you begin (Shopware administration access, workspace access and a property, the sales channel's public HTTPS URL, running scheduled tasks and message workers), then setup steps 1 Create the Shopware connection and 2 Confirm the hostname and copy the token.](/docs/_assets/933688cce7a95acf180ea7f0bfefe3b1e8988ccf03a05bca024291927c72d04b)

**You should see:** the connection read **Setup required** until the plugin pairs.



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

### 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](/docs/using/overview#find-the-next-step) 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](/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**: product costs come from Shopware; [add payment fees, returns and the rest](/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 Configure consent step in the tracking checklist, with the list of consent platforms to choose from.](/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.](/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.

   ![The Add your additional costs step in Tracking, prefilled for your country: shipping, handling, returns and payment fee fields, a Product cost fallback (%) field and the Activate additional costs button.](/docs/_assets/9aa53f961b1d7a0f43c3ebdccb7dfda4cb044d52cf5c7d4cd3b10fc95a7083fb)

**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](/docs/using/check-tracking), or ask your assistant whether the order arrived.



1. **Check storefront collection.** **Storefront & data collection** shows how tracking runs on your site and which consent and profit settings apply.

   ![The WooCommerce installation panel from Storefront & data collection in Tracking: Active, northwind-outfitters.example collecting visits, carts and checkouts on this domain, and storefront tracking managed by the WooCommerce plugin, with no Cloudflare setup or manual script tag required. An Advanced collection settings button.](/docs/_assets/360f30f6ea7a26ac41a96d240ec9e7d99f1f6bea85d7d728a315ab3452f3fd12)

   *Example data.*

2. **Review the Google Ads destination.** The **Google Ads** panel shows the connection, the conversion actions, profit tracking and the enhanced conversions terms.

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

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



**Features and guides on Shopware**

| Feature                                                                | Channels                                                                                                                                                                                | On this platform                                                                        |
| ---------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- |
| [Server-side conversion tracking](/docs/features/ad-blocker-proof-tracking) | [Google Ads](/docs/tracking/server-side/shopware-google-ads) · [Meta](/docs/tracking/server-side/shopware-meta) · [ChatGPT Ads](/docs/tracking/server-side/shopware-openai)                            | Paid orders from the paired sales channel; the script loads from a random path.         |
| [Enhanced Conversions](/docs/features/enhanced-conversions)                 | [Google Ads](/docs/tracking/enhanced-conversions/shopware-google-ads) · [Meta](/docs/tracking/enhanced-conversions/shopware-meta) · [ChatGPT Ads](/docs/tracking/enhanced-conversions/shopware-openai) | Email, phone, name, postcode and country from the order; cookie manager choice applies. |
| [Customer lists](/docs/features/customer-list)                              | [Google Ads](/docs/tracking/customer-lists/shopware-google-ads)                                                                                                                              | Six Customer Match lists, filled from your Shopware orders.                             |
| [POAS and ROAS bidding](/docs/features/poas-bidding)                        | [Google Ads](/docs/bidding/poas/shopware-google-ads) · [Meta](/docs/bidding/poas/shopware-meta) · [ChatGPT Ads](/docs/bidding/poas/shopware-openai)                                                    | Purchase price per order line at order time; later price changes don't rewrite profit.  |
| [New customer bidding](/docs/features/new-customer-bidding)                 | [Google Ads](/docs/bidding/new-customers/shopware-google-ads) · [Meta](/docs/bidding/new-customers/shopware-meta)                                                                                 | No earlier paid order in the same sales channel, by account or guest email.             |
| [Returning customer bidding](/docs/features/returning-customer-bidding)     | [Google Ads](/docs/bidding/returning-customers/shopware-google-ads) · [Meta](/docs/bidding/returning-customers/shopware-meta)                                                                     | An earlier paid order in the same sales channel.                                        |
| [LTV bidding](/docs/features/ltv-bidding)                                   | [Google Ads](/docs/bidding/ltv/shopware-google-ads) · [Meta](/docs/bidding/ltv/shopware-meta) · [ChatGPT Ads](/docs/bidding/ltv/shopware-openai)                                                       | Observed value from paid orders within the paired sales channel.                        |

## 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](/docs/using/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



* [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 Shopware](https://www.productmetrics.io/platforms/shopware), [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/tracking-get-shopware6-status).
