Plugin voor Shopware 6.5 / 6.6: versie 1.0.0

Shopware server-side tracking-plugin

Installeer de module DatafireflyServerSide plugin op je Shopware 6-webshop en stuur de aankoopconversie server-side, rechtstreeks naar Meta Conversions API (CAPI), GA4, TikTok, Pinterest en Microsoft Advertising. HMAC-ondertekening per webshop, faalveilig van opzet zodat een trackingfout de checkout nooit breekt, en een instelbare toestemmingsoptie voor de AVG. Eén verbindingssleutel, geen pixel-ID's om in Shopware te plakken.

Faalveilig: de checkout wordt nooit onderbroken HMAC-ondertekening per webshop Gehost in de EU

De plugin installeer je als elke Shopware-extensie: een ZIP die je uploadt bij "Mijn extensies" in de administratie, FTP-toegang is niet nodig.

De volledige route
Jouw Shopware-webshop plugin DatafireflyServerSide: event bij plaatsing van de bestelling
DataFirefly-dispatcher Gehost in Duitsland: HMAC-geauthenticeerd kanaal
Meta CAPI GA4 TikTok Pinterest Microsoft Advertising
Het probleem

Je Shopware-browsertags laten omzet weglekken

De Meta-pixel, de GA4-tag of de TikTok-tag in je Shopware-thema draait in de browser van de klant, waar die steeds vaker geblokkeerd wordt nog vóór hij kan afvuren.

  • Adblockers

    zorgen dat de tags niet laden op de orderbevestigingspagina: de aankoop wordt dan nooit doorgegeven aan je platformen.

  • Safari ITP

    en vergelijkbare beschermingen verkorten of verwijderen de cookies waarvan je conversietags afhankelijk zijn.

  • Cookiebeperkingen en frictie rond toestemming

    beperken verder wat tracking in de browser kan vastleggen op het moment van aankoop.

Het gevolg: onvolledige Shopware-conversies, slechtere match quality en campagnes die op een half beeld optimaliseren. Je betaalt voor omzet die je niet volledig kunt meten.

De oplossing

De Shopware-aankoopconversie, server-side verstuurd

De module DatafireflyServerSide plugin legt de aankoop vast op het moment dat de bestelling wordt geplaatst (checkout.order.placed event), server-side, en verstuurt hem server-to-server verstuurd, rechtstreeks naar de conversie-API van elk platform (CAPI): het kanaal dat gebouwd is voor betrouwbare first-party conversiedata.

Teruggewonnen aankopen

De aankoopconversie hangt niet langer af van browsertags die adblockers en ITP overleven, dus win je omzet terug die anders verloren was gegaan.

Betere match quality

De plugin legt de beschikbare browseridentificatoren vast (_fbp, _fbc, _ttp, GA clientId) voor een rijker en betrouwbaarder matchsignaal.

Geen enkel risico voor de checkout

Faalveilig van opzet: strakke time-outs en volledige foutafhandeling. Een trackingfout wordt gelogd, maar onderbreekt de bestelling nooit.

Hoe het werkt op Shopware

Drie stappen naar volledige aankooptracking

1

Installeer de Shopware-plugin

Upload de DatafireflyServerSide ZIP via Extensies → Mijn extensies → Extensie uploaden en activeer hem daarna. Shopware registreert de event subscriber voor bestellingen automatisch.

2

Plak je verbindingssleutel

Open de configuratie van de plugin en plak je verbindingssleutel (dfss_…), gekopieerd uit "Koppel je webshop" in je DataFirefly-account (/app). Er zijn geen pixel-ID's in te vullen.

3

De aankoop gaat server-side de deur uit

Bij elke geplaatste bestelling wordt het aankoopevent HMAC-ondertekend en afgeleverd bij de dispatcher, die het verdeelt over alle bestemmingen die je hebt ingesteld. Eén installatie, alle platformen.

Wat de plugin doet

De server-side connector voor Shopware, in detail

Server-side aankoopconversie

Verstuurt het aankoopevent zodra de bestelling wordt geplaatst, rechtstreeks naar de conversie-API's.

HMAC-SHA256-ondertekening

Elk verzoek wordt per webshop ondertekend (headers X-Dfss-Tenant, X-Dfss-Timestamp, X-Dfss-Signature). De inloggegevens van de bestemmingen komen nooit in de browser.

Faalveilig van opzet

Strakke HTTP-time-outs en volledige foutafhandeling: een trackingfout breekt de checkout nooit. Mislukkingen worden gelogd.

Toestemmingscontrole

Optie "Toestemming vereist": de aankoop wordt alleen verstuurd als de toestemmingscookie die je opgeeft aanwezig is. Naam en waarde zijn instelbaar zodat ze bij je CMP passen, en worden server-side gecontroleerd.

Betere match quality

Legt de beschikbare browseridentificatoren vast (_fbp, _fbc, _ttp, GA clientId) naast de bestel- en klantgegevens.

Ingebouwd testevent

Controleer de verbinding en de ondertekening met één consolecommandobin/console datafirefly:serverside:test), nog vóór je een echte testbestelling plaatst.

Eén sleutel, geen blootgestelde secrets

De verbindingssleutel (dfss_…) blijft server-side. De tokens van de bestemmingen staan bij de dispatcher, nooit in de storefront.

Gehost in de EU

De dispatcher draait in Duitsland: je data blijft in de EU.

Bestemmingen

Meta CAPI, GA4, TikTok, Pinterest en Microsoft Advertising vanuit Shopware

De Shopware-aankoopconversie wordt server-side afgeleverd bij de conversie-API's van je platformen. Je stelt het één keer in je DataFirefly-account in.

Meta Conversions API CAPI GA4 Measurement Protocol
TikTok Events API
Pinterest Conversions API
Google Ads Data Manager API
Microsoft Advertising Conversions API

Google Ads (Data Manager API) is beschikbaar op platformniveau. De Shopware-plugin 1.0.0 levert de aankoop af bij Meta CAPI, GA4, TikTok, Pinterest en Microsoft Advertising.

Installatie

Installeer de server-side plugin op Shopware

Vereisten: Shopware 6.5 of 6.6, een DataFirefly server-side account en uitgaande HTTPS-toegang tot serverside.datafirefly.com.

1

Haal je verbindingssleutel op

Kopieer in "Koppel je webshop" in je DataFirefly-account (/app) je verbindingssleutel (met voorvoegsel dfss_…). Die bevat alles wat de plugin nodig heeft: tenant, HMAC-secret en endpoint zitten er al in, er zijn geen andere instellingen in te vullen.

2

Upload de ZIP in de administratie

Shopware-administratie → Extensies → Mijn extensiesExtensie uploaden, selecteer daarna de ZIP van de plugin. Klik vervolgens op Activeren. Op de commandoregel: bin/console plugin:install --activate DatafireflyServerSide.

3

Stel de plugin in

Open de configuratie van de plugin. Plak je verbindingssleutel (dfss_…). Gebruik je een CMP, zet dan Toestemming vereist (standaard uit) aan en geef de naam en waarde op van de toestemmingscookie die gecontroleerd moet worden. Zet tracking op ingeschakeld en sla op.

4

Controleer de verbinding

Voer bin/console datafirefly:serverside:testuit: een bevestiging geeft aan dat sleutel en ondertekening geldig zijn. Plaats daarna een echte testbestelling en open de Inspector in /app om te bevestigen dat het aankoopevent binnenkomt (bedrag, valuta, referentie).

Afleverfouten worden gelogd in de Shopware-logs (regels met het voorvoegsel [DataFirefly SS]). Een mislukte tracking wordt gelogd, maar onderbreekt de bestelling nooit.

Tarieven

Eenvoudige tarieven die met je webshop meegroeien

Eén abonnement dekt je hele account en al zijn Shopware-webshops, op één gebundelde factuur. Ga een niveau hoger voor meer sites en meer events per maand.

Gratis

Gratis zolang je onder de maandlimiet blijft: er gaat niets stuk als je eroverheen gaat.

€0 / maand
1 site inbegrepen
Tot 10,000 events / maand
Geen creditcard nodig
Gratis beginnen

Starter

Voor één Shopware-webshop die server-side tracking opzet.

€39 / maand
1 site inbegrepen
Tot 500K events / maand
Eén gebundelde factuur
Kies Starter

Scale

Voor bureaus en portfolio's met maximaal twintig webshops en een hoger volume.

€349 / maand
20 sites inbegrepen
Tot 10M events / maand
Eén gebundelde factuur
Kies Scale

De Shopware-plugin zit in elk pakket. Bekijk de volledige tarieven op de homepage.

Vertrouwen & AVG

Gebouwd voor Europese privacynormen

Gehost in de EU (Duitsland)

Je data wordt in de EU verwerkt.

HMAC-geauthenticeerde ingestie

Elk aankoopverzoek wordt per webshop ondertekend (HMAC-SHA256).

Respecteert toestemming

Met "Toestemming vereist" wordt de aankoop alleen verstuurd als de ingestelde toestemmingscookie aanwezig is, server-side gecontroleerd.

Inloggegevens nooit blootgesteld

Tokens van bestemmingen blijven aan de kant van de dispatcher, nooit in de browser.

Eén verbindingssleutel

De sleutel dfss_… bevat alles: er staat nooit een token van een bestemming in de webshop.

Beschikbaarheidsdoel van 99,5%

In realtime gemeten en gevolgd op onze publieke statuspagina, in lijn met onze SLA.

FAQ

Veelgestelde vragen: Shopware-plugin

Wat is de server-side tracking-plugin voor Shopware?

De module DatafireflyServerSide plugin (versie 1.0.0, compatibel met Shopware 6.5 en 6.6) stuurt de aankoopconversie van je webshop server-to-server, rechtstreeks naar de conversie-API van elk platform (Meta CAPI, GA4, TikTok, Pinterest, Microsoft Advertising). Het aankoopevent vuurt af zodra de bestelling wordt geplaatst en wordt voor jouw webshop HMAC-ondertekend. De inloggegevens van de bestemmingen komen nooit door de browser.

Kan de plugin de checkout van mijn Shopware-webshop breken?

Nee. De plugin is faalveilig van opzet: strakke HTTP-time-outs en volledige foutafhandeling zorgen dat een trackingfout de bestelling of de checkout nooit kan onderbreken. Een mislukte aflevering wordt gelogd (met voorvoegsel [DataFirefly SS] in de Shopware-logs), maar de bestelling wordt altijd normaal afgerond.

Moet ik pixel-ID's in Shopware plakken?

Nee. Je plakt alleen een verbindingssleutel (dfss_…), gekopieerd uit het scherm "Koppel je webshop" in je DataFirefly-account (/app). De dispatcher weet naar welke bestemmingen hij moet verdelen. Je plakt nooit een pixel-ID of access token in de webshop.

Respecteert de plugin de AVG-toestemming?

Ja, via de optie Toestemming vereist (standaard uit). Zodra die aanstaat, wordt de aankoop alleen verstuurd als de toestemmingscookie die je opgeeft aanwezig is: naam en waarde zijn instelbaar en worden server-side gecontroleerd. Shopware 6 stelt geen enkele server-leesbare marketingtoestemmingscookie beschikbaar, dus past de plugin zich aan de toestemmingsoplossing van je webshop aan. De dispatcher is in de EU gehost (Duitsland) en persoonsgegevens worden geanonimiseerd.

Moet ik een server-side GTM-container hosten?

Nee. DataFirefly stuurt events rechtstreeks naar de conversie-API van elk platform: er is geen server-side GTM-container te hosten of te onderhouden. Het opzetten beperkt zich tot de Shopware-plugin en één verbindingssleutel.

Werk je met een ander platform? Ontdek de PrestaShop server-side tracking-module of de WooCommerce server-side tracking-plugin.

Verplaats de tracking van je Shopware-webshop naar server-side

Stuur de aankoopconversie server-side naar Meta CAPI, GA4, TikTok, Pinterest en Microsoft Advertising: HMAC-ondertekend, faalveilig voor de checkout, in de EU gehost en met respect voor toestemming.