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