Vereisten
- Shopware 6.5, 6.6 of 6.7.
- De zip van de plugin, te downloaden via de pagina Modules van uw klantomgeving.
- De verbindingssleutel van uw site.
Installatie
- Shopware-admin: Extensions > My extensions > Upload extension, installeer en activeer daarna de plugin.
- Of via CLI:
bin/console plugin:install --activate DatafireflyServerSide
Configuratie
- Open de configuratie van de plugin en plak de verbindingssleutel
dfss_.... - Schakel Enable tracking in.
De module herkent de gangbare toestemmingstools zelf (DataFirefly Cookie Consent, IAB TCF v2, Cookiebot, Didomi, Usercentrics, CookieYes, Iubenda, OneTrust, Cookiehub, Osano, Borlabs, Klaro, tarteaucitron), in de browser en op de server, dezelfde lijst als de WooCommerce- en PrestaShop-modules. Laat Consent cookie name leeg voor die automatische herkenning; vul het alleen in om een bepaalde cookie af te dwingen (bijvoorbeeld CookieConsent en marketing:true), die dan voorrang krijgt.
Controleren
- Voer
bin/console datafirefly:serverside:testuit. - Het testevent moet als Delivered verschijnen in de Monitoring van uw klantomgeving.
Wachtrij voor opnieuw verzenden
Geldt vanaf versie 1.23.0.
- Een mislukte verzending komt in de wachtrij en wordt elke 5 minuten opnieuw verstuurd door een geplande taak van Shopware.
- Aankopen en terugbetalingen gaan voor, daarna de meest recente events.
- Een event verlaat de wachtrij pas als het ouder is dan 7 dagen en al meer dan 7 dagen wacht. Het wordt dan als verlopen geteld: er verdwijnt niets ongemerkt.
- Antwoordt DataFirefly niet (netwerkfout, HTTP 429 of 5xx), dan stopt de winkel 60 seconden met direct verzenden en zet de events meteen in de wachtrij. Een storing aan onze kant vertraagt uw winkel of de checkout dus nooit. Het opnieuw verzenden blijft proberen, en zodra dat lukt, wordt weer direct verzonden.
- De pagina van uw site in de klantenomgeving toont de status van deze wachtrij. De statussen worden uitgelegd op de pagina Probleemoplossing.
Bij problemen
- Logboeken in
var/log/, voorvoegsel[DataFirefly SS]. - Gebruikt u een pluginversie ouder dan 1.9.0, werk dan bij: recente versies verhelpen een mogelijke dubbeltelling van aankopen in GA4.
- De andere veelvoorkomende oorzaken vindt u in de gids probleemoplossing.
Bijgewerkt: 1 september 2026