Google Analytics GA4 : installation et aide

Suivez les étapes du Démarrage rapide.

Ouvrez "Configure" dans "Module Manager". Utilisez Paramètres pour les ID et contrôles de suivi, Diagnostic pour les vérifications. Des pages distinctes Licence, Assistance, Mettre à jour et "Integrity" sont présentes.

"Enhanced Conversions" hache e-mail, téléphone, prénom, nom, ville, région et code postal après suppression des espaces aux extrémités et passage en minuscules. Le code ISO du pays est envoyé sans hachage. Les champs d'adresse viennent de la première adresse du client si disponible. Cette option est distincte du suivi de l'ID client haché.

Engagement produit

Le traceur partagé reconnaît aussi les changements de variante et interactions avec les détails produit. Par défaut, il limite l'intention élevée à une fois par produit/session. Gardez cela distinct de votre configuration principale de conversion d'achat.

Lorsque Cookies Revolution est actif, le module le détecte et peut se placer en dernier sur displayHeader pour que la CMP initialise Consent Mode en premier. Utilisez Réparer l'ordre des hooks dans Diagnostic si nécessaire.

Sans cette CMP détectée, le module émet des valeurs Consent Mode refusant par défaut le stockage analytique, publicitaire, de données utilisateur publicitaires et de personnalisation, tout en autorisant le stockage de sécurité. C'est un extrait par défaut. Il ne crée pas de bannière et ne recueille pas de consentement. Configurez les mises à jour via votre outil de consentement.

Le contrôle d'admissibilité navigateur ignore les contrôleurs non frontaux, bots/outils d'audit reconnus, employés exclus et navigateurs avec mpr_notrack=1. Pour exclure un navigateur de test :

document.cookie = 'mpr_notrack=1; path=/; max-age=31536000; SameSite=Lax';

Les achats serveur nécessitent le consentement analytique enregistré de l’acheteur, ses ID client et de session GA d’origine, ainsi que l’autorisation pour ce module d’envoyer des données à la propriété GA4 configurée. Les refus de suivi du navigateur et les exclusions d’employés s’appliquent aussi. "Server-Side Purchase Fallback" est désactivé par défaut. Pour l’activer, saisissez des identifiants valides et indiquez dans "Purchase recovery hostname" le nom d’hôte HTTPS de votre boutique en production, sans protocole ni chemin.

Le module charge GA4 de façon asynchrone via displayHeader. Il envoie les événements e-commerce par ces voies :

Ce formulaire n'a pas d'options distinctes pour ces événements e-commerce standard. Leur présence dépend des hooks correspondants et du parcours du thème.

Les données d'achat incluent référence de commande comme transaction_id, valeur, devise, taxe, livraison, coupons et lignes d'articles. Les champs disponibles comprennent ID, nom, prix, quantité, marque, catégorie, variante et remise. Vérifiez ces valeurs avec une commande test utilisant votre configuration de taxes, remises et livraison.

"Track custom events" est désactivé par défaut. Le champ "Custom event rules" est initialement vide. Ajoutez des règles, activez l'option et enregistrez :

[
  {"event":"gallery_browse","trigger":"click","selector":".product-images img,.images-container img","params":{"component":"product_gallery"},"once":false},
  {"event":"checkout_page_seen","trigger":"url","contains":["/order"],"params":{"area":"checkout"},"once":true},
  {"event":"module_page_seen","trigger":"controller","controllers":["module"],"modules":["mprwishlist"]},
  {"event":"size_guide_opened","trigger":"event","dom_event":"shop:size-guide-opened","params":{"component":"size_guide"},"once":false}
]

document.dispatchEvent(new CustomEvent('shop:size-guide-opened'));

Utilisez des noms d'événements et paramètres commençant par une lettre, contenant lettres, chiffres ou traits de soulignement, avec au maximum 40 caractères. Les noms et préfixes réservés sont refusés. Les clés de paramètres ressemblant à des données personnelles sont filtrées. Les sélecteurs de clic peuvent atteindre 500 caractères. once vaut false par défaut pour les clics et true pour les règles URL, contrôleur et DOM. Adaptez les filtres contrôleur/module à votre route réelle.

La validation de commande enregistre les achats admissibles pour récupération. Après 30 minutes sans confirmation du navigateur, la tâche cron partagée met en file et envoie les événements Measurement Protocol purchase admissibles avec les données acheteur recueillies lors de la commande :

task: send_ga4_measurement_protocol
callable: mprgoogleanalytics::cronProcessMeasurementProtocolQueue
schedule: every:300
context: any
timeout: 30

Assurez-vous que l'exécuteur cron MPR partagé exécute cette tâche. Consultez le journal d'événements dans Diagnostic et la file de conversions partagée. Les lignes de journal utilisent votre préfixe de base suivi de mpr_analytics_events ; ps_ n'est que le préfixe d'exemple habituel. Le nettoyage de rétention intervient après validation de commande admissible. La récupération des achats expire 72 heures après la commande. La conservation des enregistrements de récupération suit "Log Retention (days)".

Les achats navigateur et serveur utilisent la référence de commande comme transaction_id. Un registre d’envoi partagé attribue chaque achat à un seul canal. La récupération serveur traite uniquement les commandes sans confirmation du navigateur après 30 minutes.

Les ID client et de session serveur proviennent des cookies GA d’origine enregistrés avant la commande. Des ID absents ou inutilisables suspendent la récupération ; le module ne génère pas d’identités de remplacement. La file ne transforme pas les événements uniquement navigateur en événements serveur.

Ouvrez Diagnostic et utilisez Lancer les tests. Vérifiez configuration requise, validité des règles, ordre des hooks, visibilité du groupe du module, détection CMP, scripts en double, exclusions et état Measurement Protocol. Utilisez Réparer l'ordre des hooks ou Réparer le groupe de modules si pertinent.

Utilisez un navigateur client normal pour vérifier requêtes réseau et GA4 DebugView. Les agents utilisateurs de bots/audit peuvent être volontairement exclus. Testez vue produit, changements de panier, commande, connexion, inscription, recherche et commande complète. Vérifiez référence de transaction et totaux des articles.

Si aucune balise ne charge, vérifiez "Enable Tracking", le "Measurement ID", les exclusions employés/refus du suivi, l'exécution des hooks et la propriété en double. Si le thème omet displayProductActions ou displayBeforeCarrier, l'événement associé peut manquer.

Si l'achat serveur manque, vérifiez option de secours, ID, secret, attribution de la fonction de suivi au module, worker de file et journal HTTP/erreurs récent. Un secret vide laisse le suivi navigateur disponible. Les totaux GA4 peuvent différer de PrestaShop à cause des scripts bloqués, consentement, attribution, délais de rapport et remboursements. Le suivi d'achat de ce module n'est pas un système de rapprochement comptable.

Réglez "Enable Tracking" sur Non et enregistrez pour suspendre l'intégration. Désinstallez via "Module Manager" pour retirer menu, enregistrement cron et configuration. La table de file partagée reste si un autre module utilise le paquet de conversion ; sinon son assistant de désinstallation la supprime. Gérez la propriété GA4 et son historique dans Google Analytics. Le journal utilise un stockage partagé ; ne supprimez pas manuellement une table partagée.

Utilisez les noms de paramètres ci-dessus lorsqu'une capture diffère de votre version installée.