Marketing Revolution : installation et aide

Importez le ZIP de la version via Modules > "Module Manager" > "Upload a module", puis installez-le. Ouvrez "Marketing > Tableau de bord". Utilisez "Marketing > Plateformes" pour configurer les destinations et "Marketing > Paramètres" pour les contrôles communs.

Nécessite PrestaShop 1.6 ou ultérieur et PHP 7.1 ou ultérieur.

Commencez avec une destination. Décidez si GA4 fonctionnera directement ou via votre conteneur GTM. Si les deux voies envoient à la même propriété, configurez-les soigneusement pour éviter les événements en double. Vérifiez également les autres modules de suivi et balises installés.

Accordez aux employés les droits de consultation et de modification appropriés pour les contrôleurs du module. Les enregistrements et actions des plateformes nécessitent un droit de modification et un jeton administrateur valide.

"Paramètres généraux"

Utilisez un identifiant cohérent entre le flux de catalogue et les événements. L'extraction commune inclut, lorsqu'ils sont disponibles, le nom de l'article, la marque, la hiérarchie des catégories, la description de déclinaison, le prix et la quantité. L'extraction des commandes ajoute la devise, les taxes, la livraison, les codes de réduction et les identifiants de commande.

"Suivi"

Le journal montre les achats enregistrés par votre boutique. Consultez les rapports de chaque plateforme pour voir quelles conversions elle a acceptées.

"Consentement"

Configurez un fournisseur de consentement pris en charge qui recueille le choix du visiteur. Le module fonctionne avec MPR Cookies Revolution et les intégrations Cookiebot, OneTrust et TCF prises en charge. Les valeurs par défaut de Consent Mode ne recueillent pas le consentement. Chaque plateforme applique aussi ses propres exigences de consentement.

"Automatisation"

Aucun paramètre modifiable n'est disponible sous "Automatisation". "Renvoyer les achats manqués", "Période de renvoi" et "Data Language" ne sont pas disponibles. Configurez la récupération et l'envoi serveur dans les formulaires de plateforme ci-dessous.

Ouvrez "Marketing > Plateformes", choisissez la plateforme et ouvrez sa configuration. La plupart des formulaires de plateforme disposent d'un interrupteur "Activé", initialement désactivé. Enregistrez l'identifiant de destination avant de l'activer.

Google Tag Manager

Saisissez "GTM Container ID", par exemple GTM-XXXXXXX. L'identifiant est initialement vide. Le module fournit des envois ecommerce vers dataLayer ; vous devez toujours configurer et publier les balises et déclencheurs dans votre conteneur.

"Track Contact Signals" et "Track Product Engagement" sont initialement désactivés. "Exclude Employee Browsers" est également désactivé au départ dans cette suite. Activez-le si les visites de votre personnel doivent être exclues.

Pour les contacts et l'engagement produit, testez les contrôles correspondants avant de les activer largement. Un conteneur GTM peut générer sa propre page vue. Le module n'envoie pas à GTM un événement générique page_view distinct pour chaque page.

Google Analytics GA4

Pour la récupération, enregistrez le secret API et activez "Recover Missing GA4 Purchases". L'intégration du consentement MPR Cookies Revolution est requise. La récupération concerne les achats enregistrés après l'activation de la fonction lorsque le client n'a pas atteint la page de confirmation de commande. Les commandes antérieures à l'activation sont exclues. L'absence d'identité de l'acheteur, de consentement ou de destination correspondante suspend l'envoi.

Contrôles Google de l'engagement produit

GTM et GA4 proposent ces contrôles dans leurs formulaires respectifs :

Testez les sélecteurs dans votre thème réel. Ces contrôles enregistrent les interactions observées ; ils ne prouvent pas un achat et n'exigent pas de libellé de conversion publicitaire.

Saisissez "Google Ads Conversion ID", par exemple AW-123456789, et activez la plateforme. Tous les libellés sont initialement vides. Renseignez uniquement les actions de conversion souhaitées :

Un libellé vide désactive la conversion correspondante. La plateforme dispose aussi de "Track Contact Signals" et "Exclude Employee Browsers", tous deux initialement désactivés. Les conversions de contact utilisent "Phone Click Conversion Label", "Chat Start Conversion Label" et "Confirmed Contact Form Conversion Label", tous initialement vides. Utilisez le libellé de l'action visée.

Corrections facultatives des remboursements

"Correct Refunded Google Ads Conversions" est initialement désactivé. Configurez ces champs avant de l'activer :

Le fichier OAuth doit contenir l'ID client, le secret client et le jeton d'actualisation. Enregistrez les champs et vérifiez l'état de préparation avant d'activer les corrections. Seuls les achats envoyés par le navigateur après la configuration peuvent être corrigés ; les conversions plus anciennes restent inchangées. La tâche de correction ne s'exécute que lorsque votre planificateur cron la lance.

Ouvrez "Meta Pixel" et saisissez "Pixel ID", initialement vide. "Enable Facebook Pixel" est initialement désactivé. Dans la suite, "Exclude employees" est désactivé par défaut. "Respect cookie consent" est initialement activé. "Persist marketing consent withdrawals" est initialement désactivé.

Les interrupteurs standard "Track ViewContent", "Track AddToCart", "Track InitiateCheckout", "Track Purchase", "Track Search", "Track AddToWishlist" et "Track CompleteRegistration" sont initialement activés. Désactivez les événements inutilisés par votre configuration. Les événements de liste de souhaits et d'inscription nécessitent une action réussie prise en charge.

"Track custom events" est initialement désactivé. "Custom event rules" est initialement vide et accepte les règles de déclenchement JSON documentées. Configurez et testez une règle avant de l'activer.

"Enable Conversions API purchase events" est initialement désactivé sur une nouvelle installation. Ajoutez "Conversions API access token" avant de l'activer. Le champ du jeton conserve le jeton enregistré si vous le laissez vide. "Code d'événement test" est initialement vide. "Graph API version" commence à v25.0.

Il s'agit d'un envoi serveur des achats en parallèle du Pixel navigateur, avec une identité d'événement commune pour la déduplication. Il ne se limite pas à un renvoi horaire des achats manqués. Vérifiez le panneau de connexion, la file du fournisseur et les diagnostics de Meta. Effacez tout code de test temporaire avant l'utilisation en production.

Le module prend également en charge ces destinations. Leurs identifiants de destination sont initialement vides et leurs interrupteurs principaux désactivés. Utilisez le formulaire du réseau que vous utilisez réellement.

Événements, confidentialité et règles personnalisées

Chaque fournisseur associe les événements communs à son API prise en charge. Vérifiez individuellement ses interrupteurs d'événements. Chaque plateforme publicitaire reçoit uniquement les événements qu'elle prend en charge.

Lorsqu'ils sont proposés, "Track phone-link clicks", "Track actual chat starts", "Track successful contact forms" et "Track product engagement" sont initialement désactivés. Les champs correspondants "Phone target", "Chat target", "Form target" ou "Engagement target" sont initialement vides. Saisissez la cible exacte fournie par le compte lorsque le formulaire en exige une. Les cibles ne sont pas déduites du Pixel ID.

"Send confirmed forms through the server API" est initialement désactivé lorsqu'il est pris en charge. Un formulaire ne compte que si le serveur signale un envoi réussi ; cliquer sur "Submit" ne suffit pas. Les clics téléphoniques et les véritables démarrages de chat sont des signaux distincts. "Product engagement thresholds" utilise les valeurs communes par défaut de 3 consultations de galerie, 1 changement de déclinaison, 1 clic sur les détails, 45 secondes et 1500 millisecondes. Modifiez son JSON uniquement pour l'adapter aux seuils et sélecteurs de thème souhaités.

"Custom event rules" est initialement vide et le suivi personnalisé est désactivé lorsqu'il existe. Les règles peuvent sélectionner des clics, URL, contrôleurs ou événements DOM pris en charge. Les restrictions des fournisseurs s'appliquent toujours. Criteo, par exemple, utilise son vocabulaire OneTag pris en charge au lieu d'accepter des noms d'événements arbitraires.

Vérifiez séparément l'exclusion des employés sur chaque plateforme. Il n'existe pas d'interrupteur universel activé par défaut. Cette suite conserve des valeurs désactivées par défaut pour l'exclusion des employés chez Google, Meta, TikTok, Snapchat, Reddit et AdRoll. Les contrôles de consentement, d'hôte sortant et de responsabilité s'appliquent toujours indépendamment.

Envoi serveur facultatif

L'envoi serveur se configure par plateforme et est initialement désactivé pour les voies facultatives suivantes. Saisissez les identifiants requis et vérifiez les réglages de consentement de la plateforme avant de l'activer.

Pour Pinterest, "Include tax in purchase value", "Include shipping in purchase value" et "Subtract discounts from purchase value" sont chacun initialement désactivés. Vérifiez ces valeurs propres au fournisseur au lieu de supposer que le paramètre général de prix détermine le total d'achat.

Le comportement des boutons de test varie selon le fournisseur. Un bouton nommé "Check test availability" ou "Check test requirements" peut renvoyer des indications sans envoyer d'événement. Utilisez la voie de test documentée du fournisseur et les identifiants de test requis. Une action de nouvelle tentative remet les lignes échouées éligibles en traitement ; elle ne corrige pas des identifiants manquants ou l'absence de consentement d'origine.

Ouvrez "ChatGPT Ads (OpenAI)". L'interrupteur global "Activer le suivi" et "Tracking enabled" dans ce formulaire doivent tous deux être activés pour cette destination.

Obtenez le Pixel ID et la clé Conversions API pour la source de données visée. La clé API est distincte d'une clé Advertiser API. Lorsque le consentement est obligatoire, l'envoi serveur exige l'autorisation de stockage publicitaire appropriée ; le navigateur exige également le signal de données utilisateur. Le retrait du consentement bloque l’envoi des événements encore en attente dans la file.

Le navigateur et le serveur utilisent une identité d'achat commune pour permettre la déduplication sur la plateforme de destination. La plateforme de destination gère les rapports et l'attribution des achats. Les événements en échec encore en attente expirent après 6 jours et 22 heures dans la file fournie.

"Check test-mode availability" n'envoie aucun événement et ne valide pas d'achat d'exemple. "Retry failed events" remet en file les événements échoués éligibles pour la boutique et le Pixel ID sélectionnés.

Désactiver "Pixel navigateur" laisse l'envoi serveur sous contrôle séparé. Pour une configuration limitée aux achats, laissez "Purchases" activé et désactivez les autres événements commerciaux. Les identifiants produit-déclinaison utilisent des valeurs comme 42-7 ; les produits sans déclinaison conservent leur identifiant produit.

Les interrupteurs facultatifs de contact et d'engagement décrits plus haut sont également désactivés au départ ici. Si le module autonome Pixel for ChatGPT Ads utilise la même destination, la responsabilité coordonnée détermine quel module émet et traite la file commune. Vérifiez cet état avant de diagnostiquer des doublons.

Ouvrez son formulaire de plateforme et définissez :

Testez le badge et l'acceptation de l'enquête sur une confirmation de commande éligible. Votre compte Merchant Center doit prendre en charge les Avis clients Google ; c'est Google qui en décide, pas les réglages du module.

Ces paramètres prennent en charge l'héritage global, par groupe de boutiques et par boutique. "Use inherited settings" supprime les remplacements locaux pour cette plateforme. La plupart des autres paramètres du module sont communs aux boutiques. Sélectionner une boutique ne crée pas à lui seul des identifiants GA4, Meta ou OpenAI indépendants.

Reliez l'infrastructure cron installée à une exécution externe régulière. Le module enregistre ces identifiants de tâche :

Utilisez l'exécuteur authentifié ou la commande du planificateur installé pour cette boutique. N'exposez pas de point d'écriture non authentifié. Les principaux workers serveur ne s'exécutent pas via le trafic des visiteurs. Une tâche ne s'exécute que si votre hébergeur appelle réellement le planificateur : contrôlez-le.

La boutique reçoit des scripts de suivi plutôt qu'un nouveau widget visible, à l'exception du badge d'avis et de l'enquête facultatifs. L'intégration normale utilise displayHeader, displayBeforeBodyClosingTag, displayOrderConfirmation, displayAfterBodyOpeningTag et les hooks de médias, ainsi que les actions panier/compte/commande et l'ancien chemin du pied de page.

La collecte commune couvre les pages vues, les consultations de produits, les listes et recherches prises en charge, les consultations du panier, les débuts de commande, les inscriptions et les connexions. Le suivi navigateur fournit les ajouts au panier confirmés et les ajouts réussis aux listes de souhaits pris en charge. Vérifiez séparément les signaux d’étapes de commande et les autres interactions ; ne supposez pas qu’ils sont collectés automatiquement. Chaque fournisseur applique ses propres correspondances et contrôles.

1. Configurez une plateforme en laissant l'interrupteur global désactivé.
2. Vérifiez ses identifiants requis et son intégration du consentement.
3. Activez la plateforme et "Activer le suivi", puis naviguez comme un client.
4. Vérifiez les identifiants produit, les prix, la devise et les catégories dans les requêtes navigateur ou l'aperçu GTM.
5. Ajoutez puis retirez un produit. Vérifiez l'événement confirmé et sa quantité.
6. Terminez la commande et examinez la destination d'achat, la valeur, la devise, les articles et l'identifiant de transaction.
7. Vérifiez séparément "Journal de suivi", l'état/les files du fournisseur et les diagnostics distants.
8. Testez le refus, le retrait du consentement et votre voie serveur planifiée si elle est activée. Désactivez ensuite "Mode débogage".

Aucun suivi : vérifiez les deux interrupteurs, les identifiants requis, le consentement, l'état employé/trafic interne, les règles d'hôte sortant et les avis de responsabilité. Le suivi est suspendu sur les voies de préproduction/clone non prises en charge.

Achats manquants : pour l'envoi navigateur, vérifiez que votre tunnel de commande affiche la page normale de confirmation, qui exécute le hook de confirmation de commande. Pour une voie API activée, contrôlez la file serveur et l'état du planificateur. Les bloqueurs du navigateur, le refus du consentement et les pannes de plateforme peuvent toujours empêcher le suivi.

Événements en double : vérifiez le responsable coordonné, les anciens modules indépendants, les balises codées dans le thème et celles publiées dans GTM. Les intégrations natives ps_facebook ou ps_googleanalytics avec la même destination peuvent toujours émettre des balises en double et font l'objet d'avertissements explicites.

Le journal d'achat indique une observation : cela enregistre l'observation de la confirmation de commande et la liste des plateformes actives. Ce n'est pas un accusé de réception de la plateforme externe.

Données de recherche ou client inattendues : le module nettoie les termes contenant des données d'e-mail ou de téléphone et applique les contrôles de consentement correspondant. Examinez les charges utiles réelles de votre configuration au lieu de supposer que toutes les données sont incluses.

Pour les cartes produit personnalisées, gardez l'identité produit accessible au suivi pris en charge. Le modèle d'origine est :

<article class="product-miniature" data-id-product="123" data-list-name="Category page">
  <h3 class="product-title"><a href="/example-product">Example product</a></h3>
  <span class="price" content="49.99">49.99</span>
</article>

Après une modification du balisage, testez les clics et de vrais ajouts au panier : l'événement panier n'est envoyé que lorsqu'un produit est réellement ajouté, un sélecteur qui correspond ne suffit donc pas.

Les données d'achat GTM utilisent un objet ecommerce. Par exemple, un conteneur configuré peut recevoir :

dataLayer.push({ ecommerce: null });
dataLayer.push({
  event: 'purchase',
  ecommerce: {
    transaction_id: '123',
    value: 99.99,
    tax: 16.67,
    shipping: 4.99,
    currency: 'EUR',
    items: [{
      item_id: 'SKU-001', item_name: 'Example product',
      item_brand: 'Example brand', item_category: 'Category',
      item_category2: 'Subcategory', price: 99.99, quantity: 1
    }]
  }
});

Cet exemple illustre la structure des données. Ne collez pas un deuxième émetteur d'achat dans le thème. Configurez le conteneur pour exploiter la sortie existante du module.

Désactivez "Activer le suivi" pour arrêter le suivi. Les événements déjà en file et les retraits de consentement sont traités selon leur propre calendrier. Sauvegardez les journaux ou configurations dont vous avez besoin avant de désinstaller.

Désinstallez via "Module Manager". Le module supprime son menu, les tâches enregistrées, ses propres tables de base de données, sa configuration et sa responsabilité de file/attribution via les paquets communs. Les tables communes suivent les règles de nettoyage de leur paquet. La désinstallation n'efface pas les événements déjà rapportés à distance.