DataFirefly Server-Side: volledige handleiding
De gratis plugin DataFirefly Server-Side installeren en koppelen, het volledige WooCommerce-traject aan client- en serverzijde aansluiten, de deduplicatie via event_id begrijpen, de onblokkeerbare aankoop aan serverzijde, het beheer van de toestemming (waaronder Cookie Consent v2), de herstelwachtrij en het abonnement op de dienst.
DataFirefly Server-Side is de gratis WooCommerce-connector voor de dienst DataFirefly Server-Side Tracking. De plugin vangt de gebeurtenissen van uw winkel op en ondertekent ze; de dienst verspreidt ze vervolgens aan de serverzijde naar uw advertentie- en analyseplatformen. Deze handleiding behandelt de installatie, de koppeling, de werking van het traject aan client- en serverzijde, de deduplicatie, de aankoopgebeurtenis aan de serverzijde, de keuze van de clientbestemmingen, het beheer van de toestemming, de betrouwbaarheid en het abonnement.
Model met gratis plugin en betaalde dienst. De plugin kost niets en blijft gratis. Om uw gebeurtenissen daadwerkelijk te versturen, hebt u een abonnement op de dienst DataFirefly Server-Side nodig (vanaf 39 euro per maand), die de opname en de verspreiding aan de serverzijde verzorgt.
Vereisten
- WordPress 5.8 of hoger
- WooCommerce 5.0 of hoger (compatibel met HPOS, de high performance order storage)
- PHP 7.4 of hoger
- Een werkende WordPress-cron (of een echte systeemcron) voor de herstelwachtrij en de uitgestelde verzending
- Een abonnement op DataFirefly Server-Side om uw koppelsleutel te krijgen
Installatie
- Haal het bestand
datafirefly-serverside-2_2_0.zipop uit uw DataFirefly-klantomgeving. - Ga in het WordPress-beheer naar Plugins → Nieuwe plugin → Plugin uploaden, selecteer de ZIP en klik op Nu installeren.
- Activeer de plugin. Er verschijnt een nieuw menu DataFirefly Server-Side in het beheer.
Koppelen met één sleutel
De module wordt met één enkele koppelsleutel ingesteld, die tegelijk het volgen aan clientzijde en aan serverzijde inschakelt.
- Kopieer in uw DataFirefly-klantomgeving de koppelsleutel (die begint met
dfss_). - Plak die in het daarvoor bestemde veld op het scherm Koppeling van de plugin.
- Klik op Koppelen. De module schakelt het volgen aan client- en serverzijde in, stuurt een testgebeurtenis naar de dispatcher en plaatst de clienttags voor de ingestelde bestemmingen.
- Controleer of de status op Gekoppeld ✓ springt en gebruik de knop Gebeurtenis testen om te bevestigen dat er iets doorkomt.
De sleutel dfss_… bevat uw tenant, een geheim en het endpoint van de dispatcher. Ze is beperkt tot hosts op datafirefly.com via HTTPS: een sleutel die naar een ander domein wijst, wordt geweigerd.
Geavanceerde modus (handmatige invoer)
Wilt u de enkele sleutel liever niet gebruiken, dan kunt u in de geavanceerde modus de tenant, het geheim en het endpoint handmatig invullen. Houd die modus voor bijzondere configuraties: de modus met één sleutel dekt vrijwel alle gevallen.
Volledig traject aan client- en serverzijde
De plugin volgt het hele traject aan de browserzijde, terwijl de aankoopconversie vanaf de server vertrekt.
- Aan browserzijde:
page_view,view_content(productweergave),add_to_cart,initiate_checkoutenadd_payment_info. - Aan serverzijde:
purchase, geactiveerd vanuit de WooCommerce-bestelhooks.
Beide lagen delen dezelfde gebeurtenisidentificatie, wat deduplicatie mogelijk maakt.
Merchandisinggebeurtenissen (sinds v2.1.1)
De tracker dekt ook de merchandising van uw catalogus: view_item_list (weergave van een productlijst, bijvoorbeeld een categorie of zoekresultaten), select_item (klik op een product in een lijst), view_promotion en select_promotion (weergave en klik op een promotie). De bijbehorende context (identificatie en naam van de lijst, identificatie en naam van de promotie, creatief en plaatsing) gaat mee naar de serverzijde om uw analyses van het klanttraject te verrijken.
Deduplicatie via event_id
Per bestelling dragen de gebeurtenis aan clientzijde en die aan serverzijde hetzelfde event_id, opgebouwd uit de bestelidentificatie (bijvoorbeeld order_1042). Meta, GA4 en de andere platformen gebruiken dat om elke conversie maar één keer te tellen. Zo haalt u de conversies binnen die de browser laat lopen, zonder dubbeltelling.
De clientbestemmingen kiezen (Meta, GA4, TikTok)
Sinds versie 2.2.0 schakelt u elke clienttag afzonderlijk in of uit bij de instellingen van de plugin, in de rij Clientbestemmingen:
- Meta (Facebook-pixel,
fbevents.js) - Google Analytics 4 (
gtag.js) - TikTok (TikTok-pixel)
Een uitgevinkte bestemming laadt haar script van derden nooit in de browser van uw bezoekers en plaatst nooit haar cookies. Gebruikt u Meta niet? Vink het uit: minder JavaScript, minder verzoeken, een snellere en soberder pagina. Bestemmingen die niet op uw DataFirefly-account zijn ingesteld, worden op het instellingenscherm aangegeven.
Deze vakjes gaan alleen over de clienttags. De verspreiding aan de serverzijde naar Meta CAPI, GA4, TikTok, Pinterest en Google Ads blijft aangestuurd door de configuratie van uw account in de DataFirefly-klantomgeving. Let op: schakelt u GA4 uit, dan plaatst de plugin de cookie _ga niet meer, wat de matchkwaliteit van GA4 aan de serverzijde verlaagt. Dat is logisch als u GA4 toch niet gebruikt.
Aankoop aan serverzijde: betrouwbaar en niet te vervalsen
De aankoopconversie wordt geactiveerd door de WooCommerce-bestelhooks (betaling voltooid, in behandeling, afgerond), en dat op een idempotente manier: een vergrendeling (_dfss_sent) zorgt ervoor dat dezelfde aankoop nooit twee keer wordt verstuurd, ook niet als meerdere hooks afgaan.
- Omdat de gebeurtenis vanaf de server vertrekt, kan geen enkele advertentieblokkering of ITP haar tegenhouden.
- Omgekeerd sluit het publieke verzamelendpoint (de beacon) de gebeurtenis
purchasebewust uit: het is onmogelijk om vanuit de browser een valse aankoop in te sturen om uw omzet in Meta of GA4 op te blazen. - De context van de gebeurtenis (waarde, valuta, producten) is aan de serverzijde bepalend: de browser “raadt” niets.
Om de attributie ook via een betaaldienst met omleiding betrouwbaar te houden, legt de plugin bij het afrekenen de cookies _fbp, _fbc, _ga en _ttp vast en koppelt ze aan de bestelling. Ze plaatst ook first-party click-id-cookies (90 dagen) om fbc, ttclid en gclid tot aan de aankoop mee te dragen.
Beheer van de toestemming
De toestemmingspoort staat standaard aan: er wordt niets verstuurd zolang er geen marketingtoestemming is gegeven.
Ingebouwde compatibiliteit met Cookie Consent v2
De plugin herkent de module DataFirefly Cookie Consent, AVG en Google Consent Mode v2 ingebouwd en leest haar toestemmingscookie (dfcc_consent) rechtstreeks aan de serverzijde. Is de categorie marketing geweigerd, dan wordt de gebeurtenis geweerd, wat de browser ook beweert. Dat is de aanbevolen combinatie: banner, Consent Mode v2 en tracking aan de serverzijde spreken dezelfde taal.
Andere toestemmingsoplossingen
Hebt u geen Cookie Consent v2, dan ondersteunt de plugin ook WP Consent API, Complianz, Cookiebot en IAB TCF v2. U kunt uw huidige banner behouden en het volgen daarop aansluiten.
Betrouwbaarheid: herstelwachtrij en activiteitenlogboek
Een gebeurtenis die niet kon worden afgeleverd, gaat niet verloren: ze komt in de wachtrij en wordt automatisch opnieuw verstuurd door een cron die elke 5 minuten loopt.
Het activiteitenlogboek toont in realtime en zonder jargon wat is afgeleverd, wat in de wachtrij staat en wat is geweigerd, met de HTTP-code en het aantal pogingen. Dat is uw eerste diagnosemiddel.
De WordPress-cron gaat alleen af bij verkeer. Stel bij een winkel met weinig bezoekers een echte systeemcron in die wp-cron.php aanroept, zodat de herstelwachtrij regelmatig leegloopt.
Beveiliging
- Geen enkel geheim in de browser: aan de clientzijde worden alleen publieke identificaties (pixel, measurement id) blootgesteld.
- Het handtekeninggeheim en uw bestemmingsgegevens blijven aan de serverzijde.
- Elke gebeurtenis wordt met HMAC ondertekend voordat ze de dispatcher bereikt, die in de EU wordt gehost (Duitsland).
- De plugin wordt verspreid onder de licentie GPLv2 of later en volgt de coderingsstandaarden van WordPress.
Abonnement op de dienst DataFirefly Server-Side
De plugin vangt op en ondertekent; de dienst DataFirefly Server-Side Tracking neemt op en verspreidt aan de serverzijde naar vijf bestemmingen: Meta CAPI, GA4 (Measurement Protocol), TikTok Events API, Pinterest Conversions API en Google Ads. De dispatcher staat in Duitsland, de opname is met HMAC ondertekend, persoonsgegevens worden gemaskeerd en het afgaan van gebeurtenissen respecteert de toestemming. Eén integratie, één gebundelde factuur, meerdere sites mogelijk.
Bekijk de formules en abonneer u op server-side.datafirefly.com:
- Starter: 39 euro per maand, 1 site, tot 500.000 gebeurtenissen
- Growth: 119 euro per maand, 5 sites, tot 2 miljoen gebeurtenissen
- Scale: 349 euro per maand, 20 sites, tot 10 miljoen gebeurtenissen
Probleemoplossing
De status blijft op “Niet gekoppeld”
Controleer of de sleutel wel met dfss_ begint en volledig is gekopieerd. Een sleutel die naar een ander domein wijst dan datafirefly.com (HTTPS) wordt geweigerd. Probeer daarna opnieuw met de knop Gebeurtenis testen.
De aankoop komt niet door
De aankoop vertrekt vanuit de bestelhooks: zorg dat de bestelling een betaalstatus bereikt (voltooid, in behandeling of afgerond). Kijk in het activiteitenlogboek of de gebeurtenis in de wachtrij staat of is geweigerd, en controleer de cron als er gebeurtenissen blijven hangen.
Het script van Meta (of GA4, TikTok) laadt niet
Twee mogelijke oorzaken: de bestemming is uitgevinkt bij Clientbestemmingen (het bedoelde gedrag sinds v2.2.0), of ze is niet ingesteld op uw DataFirefly-account, wat het instellingenscherm dan aangeeft. Gebruik na een wijziging aan de accountzijde de knop Bestemmingsidentificaties verversen.
Conversies worden dubbel geteld
Controleer of geen andere trackingplugin al een concurrerende purchase verstuurt zonder gedeelde event_id. Met DataFirefly Server-Side alleen garandeert het op de bestelling gebaseerde event_id de deduplicatie.
Er vertrekt niets terwijl de toestemming lijkt te zijn gegeven
De poort staat standaard aan. Controleer of de categorie marketing wel is aanvaard in uw toestemmingsoplossing, en of die wordt herkend (Cookie Consent v2, WP Consent API, Complianz, Cookiebot of IAB TCF v2).
Hulp nodig? Neem contact op met de DataFirefly-support vanuit uw klantomgeving en voeg een schermafbeelding van het activiteitenlogboek toe (HTTP-code plus aantal pogingen).