Shopware
The X3 Growth plugin for Shopware 6.6 and 6.7 does everything in one installation: the tracker on every storefront page (theme-agnostic, no theme build), e-commerce events, its own group in Shopware's cookie consent manager, server-side purchases and refunds, and – optionally – the sync of customers, companies and orders to the Sales Engine.
Install
- Download the plugin in the dashboard: Website verbinden › Webflow / Shopify / Shopware / GTM › Shopware ›
Plugin herunterladen (
x3-shopware.zip). - Shopware administration › Extensions › My extensions › Upload extension, choose the zip, then Install and Activate. On the command line:
bin/console plugin:refresh
bin/console plugin:install --activate X3Growth
bin/console cache:clear- Shopware › Settings › Extensions › X3 Growth › Verbindung › Mit X3 verbinden: sign in to X3, choose the project and confirm the shop's host. X3 sends the shop back with a one-time code; the plugin exchanges it (PKCE) for a key limited to that project with exactly the rights it needs, takes the publishable key and adds the shop's domains to the project's domains and allowed origins. You need to be an admin of the project.
- Without a sign-in in the browser (headless setups): create a secret key (Team › Schlüssel › Neuer Schlüssel) with
analytics:read,project:admin,conversions:write,events:writeandleads:write– for the Sales Engine alsocontacts:read,contacts:write,activities:write,deals:readanddeals:write– and paste it under Schlüssel einfügen.
Every outbound call runs in Shopware's message queue – nothing slows down the checkout. Production shops run the
worker (bin/console messenger:consume async) and the scheduled tasks, as Shopware recommends anyway.
Verify
- Open the shop in a private window; the network tab shows
POST {{API_ORIGIN}}/v1/e→ 204. - X3 Growth › Status shows „Letztes Ereignis empfangen“ within a minute, the dashboard's live view the visit.
- Place a test order (switch on Testmodus in the plugin settings on a staging shop): the purchase appears with its order number; Status shows „Letzter Kauf gemeldet“.
Proxy (optional)
Not needed: the plugin sends purchases from the server. For a first-party tracking path put a Cloudflare Worker or the nginx proxy in front of the shop and enter its address as Growth-Intelligence-API under Verbindung › Erweitert.
Consent
X3 is its own group in Shopware's cookie consent manager („Reichweitenmessung und Werbeerfolg (X3)“). Default:
cookieless measurement for everyone, upgraded after consent (session across reloads, visitor id, ad click ids,
matching data for the server-side purchase). The setting Cookie-Einwilligung › Erst nach Einwilligung messen loads
the tracker only after consent. Decisions in the cookie settings are forwarded to x3("consent", …) right away.
Events
| Shopware page | Events |
|---|---|
| Product | product_viewed {product, value, currency} |
| Category | category_viewed {category} |
| Search | search {results} – never the search term |
| Add to cart (any buy button) | add_to_cart {product, quantity} |
| Cart, address, confirm, finish | funnel_step {funnel: "checkout", step: cart · address · confirm · finish} |
| Confirm | checkout_started {value, currency, items} |
| Finish | purchase {value, currency, order_id, items} |
The browser purchase waits for the server confirmation of the same order number
(Shop purchases), so browser and server count once. The plugin stores the
visit's session id with the order, so the server-side purchase keeps the visit's channel, campaign and click ids.
Cancellations and refunds (order cancelled, payment refunded) reduce the revenue through
POST /v1/projects/{project}/purchases/refunds. The trigger of the purchase is order placed (default) or
payment paid.
Register purchase as a goal with a value to get revenue per channel and ROAS on the ads report.