DataFirefly Google Tag Manager Pro — Guide complet

Présentation et prérequis

DataFirefly Google Tag Manager Pro pousse un dataLayer GA4 ecommerce complet pour votre boutique WooCommerce, puis vous permet de générer en un clic un conteneur Google Tag Manager prêt à importer, déjà câblé sur ce dataLayer. Le plugin gère aussi le suivi server-side (Meta Conversions API, GA4 Measurement Protocol) avec déduplication automatique, le Consent Mode v2, et un mode d’injection directe des pixels pour les boutiques qui n’utilisent pas GTM.

• WordPress 5.8 et supérieur, testé jusqu’à 7.0.
• WooCommerce 7.0 et supérieur, testé jusqu’à 9.6, compatible HPOS et Cart/Checkout Blocks.
• PHP 7.4 et supérieur.
• Multilingue (FR/EN/ES/DE/IT), compatible Polylang et WPML.
• Aucun suivi émis en back-office, dans les flux ou le customizer.

Installation

1. Téléchargez l’archive datafirefly-gtm-pro-1.1.0.zip depuis votre compte client.
2. Dans l’admin WordPress, allez dans Extensions > Ajouter > Téléverser une extension et déposez l’archive.
3. Cliquez sur Activer.
4. Ouvrez Tag Manager Pro dans le menu d’administration pour accéder aux réglages.

À l’activation, le plugin enregistre ses réglages par défaut. Vous pouvez ensuite renseigner votre conteneur, vos connexions et activer le server-side onglet par onglet.

Onglet Général — conteneur et dataLayer

Cet onglet pilote l’injection du conteneur et la forme du dataLayer :

• Identifiant du conteneur : votre ID GTM au format GTM-XXXXXXX. Tant qu’il est vide, rien n’est injecté côté GTM (le dataLayer et le mode direct restent disponibles).
• Nom du dataLayer : dataLayer par défaut. À ne modifier que si votre installation l’exige.
• Placement : head + body (noscript), head seul ou body seul.
• Priorité de sortie : standard ou haute (le conteneur est écrit tôt dans le head).

Onglet Connexions — vos plateformes

Saisissez ici les identifiants des plateformes que vous utilisez. Cette base alimente à la fois le conteneur GTM généré, les pixels directs et les événements server-side. Laissez vide ce que vous n’utilisez pas.

• Google Analytics 4 : Measurement ID (G-XXXXXXXXXX).
• Google Ads : Conversion ID (AW-XXXXXXXXX), libellé de conversion d’achat, remarketing dynamique (option).
• Meta : Pixel ID, jeton Conversions API, code de test CAPI (option).
• TikTok : Pixel ID, jeton Events API (option).
• Pinterest : Tag ID — Snapchat : Pixel ID — LinkedIn : Partner ID.
• Microsoft Advertising (UET) : Tag ID — X : Pixel ID.
• Hotjar : Site ID — Microsoft Clarity : Project ID.

En bas de l’onglet, le réglage Diffusion des pixels détermine le mode : via Google Tag Manager (recommandé, vous importez le conteneur généré) ou injection directe (le plugin charge lui-même les pixels).

Tag Pilot — générer et importer le conteneur GTM

L’onglet Tag Pilot construit un conteneur Google Tag Manager complet à partir de vos connexions et l’offre en téléchargement. Il génère notamment :

• la balise Google de configuration GA4 et un tag d’événement GA4 par événement activé (avec envoi des données ecommerce depuis le dataLayer) ;
• le Conversion Linker, la conversion d’achat et le remarketing dynamique Google Ads ;
• le pixel Meta et ses événements standard (ViewContent, AddToCart, InitiateCheckout, AddPaymentInfo, Purchase, Search) ;
• des tags Custom HTML pour TikTok, Pinterest, Snapchat, LinkedIn, Microsoft UET, X, Hotjar et Clarity ;
• les Data Layer Variables et les déclencheurs d’événements personnalisés correspondants.

Pour l’importer :

1. Cliquez sur Télécharger le conteneur GTM (.json).
2. Dans Google Tag Manager, ouvrez Administration > Importer un conteneur.
3. Sélectionnez le fichier JSON, choisissez votre espace de travail, puis Fusionner (conserve vos tags existants) ou Écraser.
4. Prévisualisez, puis Envoyer et publier.

Mode pixel direct (sans GTM)

Si vous ne souhaitez pas dépendre de GTM, passez la diffusion en injection directe dans l’onglet Connexions. Le plugin injecte alors lui-même les pixels de base (GA4, Meta, et les autres plateformes configurées) et rejoue les événements ecommerce du dataLayer vers Meta, TikTok, Pinterest, Snapchat et GA4. Le même dataLayer alimente les deux approches.

Server-side — Meta CAPI et GA4 Measurement Protocol

Dans l’onglet Server-side, activez l’envoi des achats directement depuis votre serveur :

• Meta Conversions API : nécessite le Pixel ID et un jeton CAPI (onglet Connexions). L’événement Purchase est envoyé avec des données client hachées en SHA-256, les cookies _fbp/_fbc, l’adresse IP et le user-agent.
• GA4 Measurement Protocol : nécessite le Measurement ID (Connexions) et un secret d’API (GA4 > Admin > Flux de données > Protocole de mesure).

Le navigateur et le serveur partagent le même event_id déterministe par commande (dfgtm.purchase.<id>). Meta et GA4 utilisent cet identifiant pour ne compter chaque conversion qu’une seule fois.

Consent Mode v2 et Enhanced Conversions

L’onglet Consent active le Consent Mode v2 : des états de consentement denied sont posés par défaut avant le chargement du conteneur, avec scoping EEA/UK, wait_for_update, URL passthrough et redaction des données publicitaires. Pour mettre à jour le consentement au choix de l’utilisateur, branchez votre bandeau cookies à l’API JavaScript fournie :

// Tout accepter
window.dfgtmConsent.grantAll();
// Tout refuser
window.dfgtmConsent.denyAll();
// Mise à jour fine
window.dfgtmConsent.update({ ad_storage: 'granted', analytics_storage: 'granted' });

Les Enhanced Conversions Google Ads (onglet GA4 Ecommerce) ajoutent des données client hachées en SHA-256 sur l’événement d’achat, pour améliorer l’attribution.

Événements GA4 ecommerce

Le plugin pousse les événements ecommerce GA4 suivants, chacun activable individuellement, avec des objets items complets (item_id depuis le SKU ou l’ID, marque, catégories jusqu’à 5 niveaux, variante, prix, remise) :

• view_item_list, view_item, select_item
• add_to_cart, remove_from_cart, view_cart
• begin_checkout, add_shipping_info, add_payment_info
• purchase (dédupliqué : déclenché une seule fois par commande, même au rafraîchissement), search

Hooks développeur

Le plugin expose des filtres aux points clés pour étendre son comportement sans modifier le cœur :

• dfgtm_export_container : modifier le conteneur GTM généré avant encodage.
• dfgtm_meta_capi_payload et dfgtm_ga4_mp_payload : ajuster les charges utiles server-side.
• dfgtm_connections_registry : ajouter ou modifier des destinations.
• dfgtm_purchase_push et dfgtm_build_item : personnaliser la donnée d’achat et la construction des items.

FAQ et dépannage

Rien n’est injecté côté GTM

Vérifiez que l’identifiant du conteneur (GTM-XXXXXXX) est renseigné dans l’onglet Général et que vous n’êtes pas connecté avec un rôle exclu. Le dataLayer et le mode direct fonctionnent même sans conteneur GTM.

Les conversions sont comptées deux fois sur Meta

Assurez-vous de ne pas charger le même pixel à la fois via le conteneur GTM et en injection directe. Le server-side et le navigateur, eux, sont dédupliqués automatiquement par event_id : ce n’est pas une source de double comptage.

L’événement d’achat ne remonte pas en server-side

Vérifiez que l’option correspondante est activée dans l’onglet Server-side et que les identifiants requis sont saisis : Pixel ID + jeton CAPI pour Meta, Measurement ID + secret d’API pour GA4. L’envoi a lieu une seule fois par commande.

Le tag GA4 n’envoie pas les données ecommerce

Dans le conteneur généré, les tags d’événement GA4 lisent les données ecommerce depuis le dataLayer. Si vous avez construit vos tags manuellement, activez « Envoyer les données ecommerce » et choisissez « dataLayer » comme source.

Que se passe-t-il à la désinstallation ?

Si l’option correspondante est activée dans l’onglet Avancé, les réglages et les méta de suivi des commandes sont supprimés. Sinon, ils sont conservés pour une éventuelle réinstallation.