Requirements
- Shopware 6.5, 6.6 or 6.7.
- The plugin zip, downloaded from the Modules page of your client area.
- Your site's connection key.
Installation
- Shopware admin: Extensions > My extensions > Upload extension, then install and activate the plugin.
- Or by CLI:
bin/console plugin:install --activate DatafireflyServerSide
Configuration
- Open the plugin configuration and paste the
dfss_...connection key. - Enable Enable tracking.
The module recognises the common consent tools on its own (DataFirefly Cookie Consent, IAB TCF v2, Cookiebot, Didomi, Usercentrics, CookieYes, Iubenda, OneTrust, Cookiehub, Osano, Borlabs, Klaro, tarteaucitron), in the browser and on the server, the same list as the WooCommerce and PrestaShop modules. Leave Consent cookie name empty for that automatic detection; fill it in only to force a specific cookie (for example CookieConsent and marketing:true), which then takes priority.
Verify
- Run
bin/console datafirefly:serverside:test. - The test event must show as Delivered in your client area's Monitoring.
Retry queue
Applies to version 1.23.0 and later.
- A failed delivery is queued, then replayed every 5 minutes by a Shopware scheduled task.
- Purchases and refunds go first, then the most recent events.
- An event leaves the queue only when it is more than 7 days old and has been waiting for more than 7 days. It is then counted as expired: nothing disappears silently.
- If DataFirefly does not answer (network failure, HTTP 429 or 5xx), the shop stops sending directly for 60 seconds and puts events straight into the queue. An outage on our side therefore never slows down your shop or its checkout. The replay keeps trying, and as soon as it succeeds, direct sending resumes.
- Your site page in the client area shows the state of this queue. The states are explained in the troubleshooting guide.
If something goes wrong
- Logs in
var/log/, prefix[DataFirefly SS]. - If you run a plugin version older than 1.9.0, update: recent versions fix a possible double count of purchases in GA4.
- The other frequent causes are listed in the troubleshooting guide.
Updated: September 1, 2026