DataFirefly Google Tag Manager Pro: volledige handleiding

Overzicht en vereisten

DataFirefly Google Tag Manager Pro pusht een volledige GA4 ecommerce dataLayer voor uw WooCommerce-winkel en laat u vervolgens met één klik een importklare Google Tag Manager-container genereren die al op die dataLayer is aangesloten. De plugin verzorgt ook server-side tracking (Meta Conversions API, GA4 Measurement Protocol) met automatische deduplicatie, Consent Mode v2, en een modus waarin de pixels rechtstreeks worden geladen voor winkels die geen GTM gebruiken.

• WordPress 5.8 en hoger, getest tot 7.0.
• WooCommerce 7.0 en hoger, getest tot 9.6, compatibel met HPOS en Cart/Checkout Blocks.
• PHP 7.4 en hoger.
• Meertalig (FR/EN/ES/DE/IT), compatibel met Polylang en WPML.
• Geen enkele tracking in de beheeromgeving, in feeds of in de customizer.

Installatie

1. Download het archief datafirefly-gtm-pro-1.1.0.zip vanuit uw klantaccount.
2. Ga in het WordPress-beheer naar Plugins > Nieuwe plugin > Plugin uploaden en plaats daar het archief.
3. Klik op Activeren.
4. Open Tag Manager Pro in het beheermenu om bij de instellingen te komen.

Bij activering legt de plugin haar standaardinstellingen vast. Daarna kunt u tabblad voor tabblad uw container en verbindingen invullen en de server-side tracking inschakelen.

Tabblad Algemeen: container en dataLayer

Dit tabblad bepaalt hoe de container wordt geladen en hoe de dataLayer eruitziet:

• Container-ID: uw GTM-ID in het formaat GTM-XXXXXXX. Zolang dit leeg is, wordt er aan GTM-zijde niets geladen (de dataLayer en de directe modus blijven wel beschikbaar).
• Naam van de dataLayer: standaard dataLayer. Wijzig dit alleen als uw installatie dat vereist.
• Plaatsing: head plus body (noscript), alleen head of alleen body.
• Uitvoerprioriteit: standaard of hoog (de container wordt vroeg in de head-tag geschreven).

Tabblad Verbindingen: uw platformen

Vul hier de identificaties in van de platformen die u gebruikt. Deze gegevens voeden zowel de gegenereerde GTM-container als de directe pixels en de server-side gebeurtenissen. Laat leeg wat u niet gebruikt.

• Google Analytics 4: Measurement ID (G-XXXXXXXXXX).
• Google Ads: Conversion ID (AW-XXXXXXXXX), conversielabel voor aankopen, dynamische remarketing (optioneel).
• Meta: Pixel ID, Conversions API-token, CAPI-testcode (optioneel).
• TikTok: Pixel ID, Events API-token (optioneel).
• Pinterest: Tag ID. Snapchat: Pixel ID. LinkedIn: Partner ID.
• Microsoft Advertising (UET): Tag ID. X: Pixel ID.
• Hotjar: Site ID. Microsoft Clarity: Project ID.

Onderaan het tabblad bepaalt de instelling Pixelverspreiding de modus: via Google Tag Manager (aanbevolen, u importeert de gegenereerde container) of rechtstreeks laden (de plugin laadt de pixels zelf).

Tag Pilot: de GTM-container genereren en importeren

Het tabblad Tag Pilot bouwt op basis van uw verbindingen een complete Google Tag Manager-container en biedt die aan als download. Het genereert onder meer:

• de Google-configuratietag voor GA4 en per ingeschakelde gebeurtenis een GA4-eventtag (met verzending van de ecommercegegevens vanuit de dataLayer);
• de Conversion Linker, de aankoopconversie en de dynamische remarketing van Google Ads;
• de Meta-pixel en de standaardgebeurtenissen daarvan (ViewContent, AddToCart, InitiateCheckout, AddPaymentInfo, Purchase, Search);
• Custom HTML-tags voor TikTok, Pinterest, Snapchat, LinkedIn, Microsoft UET, X, Hotjar en Clarity;
• de bijbehorende Data Layer Variables en aangepaste eventtriggers.

Zo importeert u de container:

1. Klik op GTM-container downloaden (.json).
2. Open in Google Tag Manager Beheer > Container importeren.
3. Selecteer het JSON-bestand, kies uw werkruimte en klik daarna op Samenvoegen (behoudt uw bestaande tags) of Overschrijven.
4. Bekijk het voorbeeld en klik daarna op Verzenden en publiceren.

Directe pixelmodus (zonder GTM)

Wilt u niet van GTM afhankelijk zijn, zet de verspreiding dan op rechtstreeks laden in het tabblad Verbindingen. De plugin laadt dan zelf de basispixels (GA4, Meta en de andere ingestelde platformen) en speelt de ecommercegebeurtenissen uit de dataLayer door naar Meta, TikTok, Pinterest, Snapchat en GA4. Dezelfde dataLayer voedt beide benaderingen.

Server-side: Meta CAPI en GA4 Measurement Protocol

Schakel op het tabblad Server-side in dat aankopen rechtstreeks vanaf uw server worden verstuurd:

• Meta Conversions API: vereist het Pixel ID en een CAPI-token (tabblad Verbindingen). De gebeurtenis Purchase wordt verstuurd met klantgegevens gehasht in SHA-256, de cookies _fbp en _fbc, het IP-adres en de user-agent.
• GA4 Measurement Protocol: vereist het Measurement ID (Verbindingen) en een API-secret (GA4 > Beheer > Gegevensstromen > Measurement Protocol).

De browser en de server delen per bestelling hetzelfde deterministische event_id (dfgtm.purchase.<id>). Meta en GA4 gebruiken die identificatie om elke conversie maar één keer te tellen.

Consent Mode v2 en Enhanced Conversions

Het tabblad Consent activeert Consent Mode v2: vóór het laden van de container worden standaard toestemmingsstatussen op denied gezet, met scoping voor de EER en het VK, wait_for_update, URL passthrough en redactie van advertentiegegevens. Om de toestemming bij te werken naar de keuze van de bezoeker, koppelt u uw cookiebanner aan de meegeleverde JavaScript-API:

// Alles accepteren
window.dfgtmConsent.grantAll();
// Alles weigeren
window.dfgtmConsent.denyAll();
// Gedetailleerde update
window.dfgtmConsent.update({ ad_storage: 'granted', analytics_storage: 'granted' });

De Enhanced Conversions van Google Ads (tabblad GA4 Ecommerce) voegen klantgegevens gehasht in SHA-256 toe aan de aankoopgebeurtenis, voor een betere attributie.

GA4 ecommerce-gebeurtenissen

De plugin pusht de volgende GA4 ecommerce-gebeurtenissen, elk afzonderlijk in te schakelen, met volledige items-objecten (item_id op basis van de SKU of het ID, merk, categorieën tot 5 niveaus, variant, prijs, korting):

• view_item_list, view_item, select_item
• add_to_cart, remove_from_cart, view_cart
• begin_checkout, add_shipping_info, add_payment_info
• purchase (gededupliceerd: gaat per bestelling maar één keer af, ook bij het verversen van de pagina), search

Hooks voor ontwikkelaars

De plugin biedt filters op de belangrijkste punten om het gedrag uit te breiden zonder de kern aan te passen:

• dfgtm_export_container: de gegenereerde GTM-container aanpassen vóór het coderen.
• dfgtm_meta_capi_payload en dfgtm_ga4_mp_payload: de server-side payloads bijstellen.
• dfgtm_connections_registry: bestemmingen toevoegen of wijzigen.
• dfgtm_purchase_push en dfgtm_build_item: de aankoopgegevens en de opbouw van de items aanpassen.

Veelgestelde vragen en probleemoplossing

Er wordt niets geladen aan GTM-zijde

Controleer of het container-ID (GTM-XXXXXXX) is ingevuld op het tabblad Algemeen en of u niet bent ingelogd met een uitgesloten rol. De dataLayer en de directe modus werken ook zonder GTM-container.

Conversies worden dubbel geteld bij Meta

Zorg dat u dezelfde pixel niet zowel via de GTM-container als via rechtstreeks laden inschakelt. De server-side en de browser worden onderling wel automatisch gededupliceerd via event_id en vormen dus geen bron van dubbeltelling.

De aankoopgebeurtenis komt niet server-side binnen

Controleer of de betreffende optie is ingeschakeld op het tabblad Server-side en of de vereiste identificaties zijn ingevuld: Pixel ID plus CAPI-token voor Meta, Measurement ID plus API-secret voor GA4. De verzending vindt per bestelling één keer plaats.

De GA4-tag stuurt de ecommercegegevens niet mee

In de gegenereerde container lezen de GA4-eventtags de ecommercegegevens uit de dataLayer. Hebt u uw tags handmatig gebouwd, schakel dan “Ecommercegegevens verzenden” in en kies “dataLayer” als bron.

Wat gebeurt er bij het verwijderen?

Is de bijbehorende optie op het tabblad Geavanceerd ingeschakeld, dan worden de instellingen en de trackingmeta van de bestellingen verwijderd. Anders blijven ze bewaard voor een eventuele herinstallatie.