Google Tag Pro (GTM & GA4) — Guide complet

Google Tag Pro (module dfgtagmanager) installe un tracking e-commerce complet et fiable sur votre boutique : 16 événements GA4 Enhanced Ecommerce, Consent Mode v2, Enhanced Conversions, suivi des conversions Google Ads, pixels publicitaires, Server-side GTM et un système de Conversion Recovery qui rejoue les conversions perdues. Ce guide couvre l’installation, chaque section de configuration et le dépannage.

Prérequis

• PrestaShop 8.0 à 9.0 (PHP 8.1 à 8.4 recommandé).
• Un compte Google Tag Manager avec un conteneur Web (ID au format GTM-XXXXXXX).
• Une propriété Google Analytics 4 (ID de mesure au format G-XXXXXXXXXX).
• Facultatif : un compte Google Ads (ID de conversion AW-XXXXXXXXX), Google Merchant Center, et/ou un serveur sGTM.

Installation

1. Dans le back-office, allez dans Modules > Module Manager, cliquez sur Installer un module et sélectionnez le fichier dfgtagmanager.zip.
2. Une fois installé, cliquez sur Configurer.
3. Le module crée ses tables (journal des conversions et des événements) et enregistre ses hooks automatiquement.

1. Configuration Google Tag Manager

Dans la section Google Tag Manager – Configuration :

• Activer GTM : active l’injection du conteneur sur le front-office.
• ID Conteneur GTM : votre identifiant GTM-XXXXXXX. Tant qu’il est vide, le module n’injecte rien.
• ID de mesure GA4 : votre identifiant G-XXXXXXXXXX. Il est utilisé pour pré-remplir le tag GA4 dans l’export du conteneur.

Le module pousse les données dans le dataLayer avant le chargement de GTM, afin que tous vos tags disposent immédiatement des données de page et e-commerce.

2. Événements de tracking (GA4 Enhanced Ecommerce)

Une fois activé, le module envoie automatiquement jusqu’à 16 événements conformes au schéma GA4 officiel :

• Découverte : view_item, view_item_list, select_item
• Panier & checkout : add_to_cart, remove_from_cart, view_cart, begin_checkout, add_shipping_info, add_payment_info
• Conversion : purchase (avec items[], value, tax, shipping, coupon, transaction_id)
• Utilisateur & marketing : login, sign_up, search, add_to_wishlist, view_promotion, select_promotion

Les événements panier, checkout, promotions et recherche sont déclenchés côté navigateur (interception AJAX et IntersectionObserver), l’événement purchase est construit côté serveur à la confirmation de commande.

Réglages associés dans la section Événements de tracking : activez/désactivez GA4 Enhanced Ecommerce, les données utilisateur (user_data), la recherche interne, login, inscription, promotions, wishlist et le remarketing dynamique.

3. Consent Mode v2 (RGPD / DMA)

Le Consent Mode v2 est obligatoire depuis mars 2024 pour mesurer les conversions Google dans l’EEE. Dans la section Consent Mode v2 :

• Activer Consent Mode v2 : injecte les valeurs de consentement par défaut avant GTM.
• analytics_storage / ad_storage par défaut : laissez sur Refusé (recommandé RGPD) ; le consentement sera mis à jour par votre bannière.

Le module active aussi url_passthrough et ads_data_redaction pour maximiser la modélisation des conversions en l’absence de consentement.

Connecter votre bandeau cookies (CMP)

Quand le visiteur accepte ou refuse, appelez la fonction fournie par le module depuis votre CMP (Tarteaucitron, Axeptio, Cookiebot, etc.) :

DFGTM.updateConsent({
  analytics_storage: 'granted',
  ad_storage: 'granted',
  ad_user_data: 'granted',
  ad_personalization: 'granted'
});

4. Enhanced Conversions

Lorsqu’ils sont activés, les Enhanced Conversions améliorent l’attribution Google Ads. Le module hashe côté serveur en SHA-256 les données du client (e-mail, nom, téléphone, ville) et les transmet via le dataLayer. Les données ne sont jamais transmises en clair ; le code postal et le pays sont envoyés non hashés, conformément aux spécifications Google.

5. Conversions Google Ads & Merchant Center

Dans la section Google Ads – Suivi des conversions :

• Activer Google Ads Conversion : ajoute le Conversion Linker, le tag de conversion d’achat et le remarketing dynamique à l’export GTM.
• Conversion ID : votre identifiant AW-XXXXXXXXX.
• Conversion Label (Achat) : le label de la conversion « Achat » (chaîne alphanumérique).
• Merchant Center ID + pays et langue du flux : requis pour les « conversions avec données du panier ».
• Source de l’ID produit : choisissez le format correspondant au champ id de votre flux Merchant Center (ID + séparateur + déclinaison, référence/SKU, ID seul, EAN13, UPC ou MPN).

6. Pixels publicitaires (Meta, TikTok, Pinterest)

Dans la section Pixels publicitaires, saisissez vos identifiants Facebook/Meta, TikTok et Pinterest. Ils sont intégrés à l’export du conteneur GTM avec les événements e-commerce mappés automatiquement (Purchase, AddToCart, ViewContent, InitiateCheckout, Search / CompletePayment / checkout selon la plateforme).

7. Export du conteneur GTM

Plutôt que de créer manuellement des dizaines de tags, le module génère un conteneur prêt à importer :

1. Dans la section Export conteneur GTM, cliquez sur Exporter le conteneur GTM (JSON).
2. Dans Google Tag Manager, allez dans Admin > Importer le conteneur.
3. Sélectionnez le fichier JSON, choisissez un espace de travail, et l’option Fusionner (ou Écraser sur un conteneur vide).
4. Vérifiez l’aperçu puis Publiez votre conteneur.

L’export contient le tag GA4 Configuration et tous les événements Enhanced Ecommerce, les variables DataLayer, les déclencheurs Custom Event, le Consent Mode v2, ainsi que les tags Google Ads et pixels activés.

8. Server-Side GTM (sGTM)

Dans la section Server-Side GTM, activez l’option et renseignez l’URL de votre serveur (par ex. https://sgtm.votre-domaine.com). Le module charge alors le script GTM et le noscript depuis votre serveur au lieu de googletagmanager.com, ce qui contourne les ad-blockers et améliore la fiabilité du tracking.

9. Conversion Recovery

C’est la fonctionnalité clé du module. À la confirmation de chaque commande, la conversion est enregistrée en base. Un contrôle asynchrone vérifie que GTM a bien reçu l’événement purchase ; sinon (ad-blocker, redirection de paiement, erreur réseau), l’événement est rejoué automatiquement à la prochaine visite du client. Aucune configuration n’est requise ; laissez l’option activée dans Options avancées.

10. Options avancées

• Cross-domain tracking : listez les domaines concernés (séparés par des virgules).
• Exclure les taxes / frais de livraison du revenu : ajuste le calcul de value pour purchase.
• Mode debug : affiche chaque push dataLayer dans la console du navigateur (préfixe coloré « DataFirefly GTM »). À désactiver en production.

11. Tableau de bord de monitoring

En haut de la page de configuration, un tableau de bord affiche sur 30 jours : le nombre de conversions trackées, celles poussées avec succès, celles en attente de recovery, le revenu tracké, le taux de réussite du tracking et le top des événements sur 7 jours. Un bouton Rejouer permet de re-marquer les conversions en échec pour un nouvel essai.

Compatibilité PrestaShop 9

Depuis la version 1.2.0, le module est compatible PrestaShop 8 et 9 (Symfony 6.4, PHP 8.1 à 8.4). Le formatage des prix passe par la Locale (l’ancienne méthode Tools::displayPrice a été retirée de PS9), le suivi de recherche est côté client, et les sessions comme le téléchargement de l’export ont été sécurisés pour le kernel Symfony. Aucune action n’est requise lors de la mise à niveau ; le script d’upgrade nettoie les hooks obsolètes automatiquement.

Dépannage

Aucune donnée ne remonte dans GTM / GA4

Vérifiez que Activer GTM est coché et que l’ID conteneur est renseigné. Le module n’injecte rien tant que ces deux conditions ne sont pas remplies. Utilisez l’aperçu de GTM (Preview) et le mode debug du module pour voir les pushes dataLayer.

Les conversions Google Ads ne se déclenchent pas

Assurez-vous d’avoir importé et publié le conteneur exporté après avoir renseigné l’ID de conversion et le label. Vérifiez le format AW-XXXXXXXXX et le label d’achat.

Les données du panier (Merchant Center) sont absentes

Renseignez le Merchant Center ID, le pays et la langue du flux, et vérifiez que la source de l’ID produit correspond au champ id de votre flux.

Le consentement reste « refusé »

Reliez votre CMP en appelant DFGTM.updateConsent() lors de l’acceptation. Sans cet appel, seules des données modélisées sont collectées.

Le fichier d’export est vide ou corrompu

Désactivez temporairement les modules de cache/optimisation HTML et réessayez ; l’export nettoie les buffers de sortie mais un module tiers peut injecter du contenu avant le téléchargement.