PS PrestaShop Débutant

Tunnel de conversion et heatmap : documentation du module PrestaShop 8 et 9

Tunnel en 9 étapes, acquisition, produits, heatmap avec clics rageurs et rapport hebdomadaire par e-mail pour PrestaShop 8 et 9.

Mis à jour Version du module 1.3.2

Le module DataFirefly – Tunnel de conversion & Heatmap (dffunnelheatmap) montre où vos visiteurs abandonnent, d’où viennent ceux qui achètent et ce qui les bloque sur vos pages. Il réunit un tunnel de conversion en 9 étapes, un rapport d’acquisition, des statistiques produits, une heatmap avec détection des clics rageurs et un rapport hebdomadaire par e-mail. Toute la collecte est first-party : rien ne quitte votre serveur.

Cette documentation couvre la version 1.3.2, compatible PrestaShop 8.0 à 9.x (PHP 7.2 et plus).

Installation et mise à jour

  1. Téléchargez l’archive dffunnelheatmap.zip depuis votre compte client.
  2. Dans le back-office, ouvrez Modules > Gestionnaire de modules, cliquez sur Téléverser un module et sélectionnez le ZIP.
  3. Le module crée ses 6 tables et ajoute l’onglet Statistiques > Tunnel et heatmap.

Pour mettre à jour depuis une version précédente, téléversez le nouveau ZIP par-dessus le module installé. Les scripts de mise à jour s’exécutent seuls : vos données et vos réglages sont conservés.

Aucune dépendance externe : pas de Composer, pas de CDN. Les réglages par défaut conviennent à la plupart des boutiques : heatmap sur 100 % des sessions, rétention de 90 jours, Do Not Track respecté, employés exclus.

Premiers pas

Tant qu’aucune visite n’a été reçue, le tableau de bord affiche une liste de vérification : suivi activé, tunnel ou heatmap activé, première visite reçue. Les navigateurs connectés au back-office ne sont pas comptés : pour vérifier la collecte, ouvrez la boutique dans une fenêtre de navigation privée, ou sur un autre appareil.

Le tableau de bord

L’interface compte six onglets : Tableau de bord, Tunnel de conversion, Acquisition, Produits, Heatmap et Réglages.

  • Indicateurs : sessions, visiteurs uniques, commandes validées, taux d’ajout au panier, taux de conversion, CA suivi TTC, panier moyen et plus gros décrochage du tunnel. Chaque indicateur est comparé à la période précédente de même durée.
  • Jour par jour : graphique des sessions, des commandes ou du taux de conversion. Les boutons au-dessus du graphique changent l’indicateur sans recharger la page, et le lien Afficher les données ouvre le tableau des valeurs.
  • Recommandations : jusqu’à 6 constats classés en À corriger, À vérifier et Bonne nouvelle, chacun avec un lien vers le rapport concerné.
  • En ce moment : visiteurs des 5 dernières minutes, pages consultées et répartition par appareil, rafraîchi toutes les 30 secondes.

Une carte résumée (sessions, commandes et conversion des 7 derniers jours, visiteurs en ce moment) s’ajoute aussi au tableau de bord d’accueil de PrestaShop.

Les recommandations

Elles n’apparaissent qu’au-delà d’un volume minimum, environ 30 sessions par appareil ou par canal, pour éviter les conclusions tirées de trois visites. Le module vérifie :

  • la plus grosse fuite du tunnel entre deux étapes ;
  • la part des sessions entrées dans le tunnel de commande qui commandent ;
  • l’écart de conversion entre mobile et ordinateur ;
  • les canaux qui apportent du trafic sans aucune commande, et le canal qui convertit le mieux ;
  • le produit le plus vu parmi ceux qui sont peu ajoutés au panier ;
  • la page qui cumule le plus de clics rageurs et sans effet ;
  • une hausse ou une baisse du trafic d’au moins 20 %.

Le tunnel de conversion

Le tunnel compte les sessions. Une session se termine après 30 minutes d’inactivité. Chaque session est comptée à l’étape la plus avancée qu’elle atteint, et dans toutes les étapes précédentes : le tunnel se resserre toujours.

  1. Visite : toute page vue.
  2. Page produit : consultation d’une fiche produit.
  3. Ajout au panier : détecté côté serveur, quelle que soit la page d’où vient l’ajout.
  4. Page panier : affichage du panier.
  5. Tunnel de commande : entrée dans le checkout.
  6. Adresse : étape adresse du checkout standard, détectée dans le navigateur.
  7. Livraison : choix du transporteur, détecté dans le navigateur.
  8. Paiement : étape paiement, détectée dans le navigateur.
  9. Commande validée : enregistrée côté serveur à la validation de la commande, puis confirmée par la page de confirmation.

Le tableau détaillé indique pour chaque étape les sessions qui l’atteignent, leur part, les sessions perdues depuis l’étape précédente, le taux d’abandon et les sessions qui ont déclenché l’étape elle-même. Un ajout au panier depuis une page catégorie, par exemple, saute la page produit. Les lignes dont l’abandon dépasse 30 % ou 50 % sont colorées.

La colonne vs période précédente donne l’évolution de la part des sessions, en points. Le tableau Conversion par appareil compare ordinateur, tablette et mobile. Le bouton Exporter en CSV télécharge le tunnel avec les filtres en cours.

Acquisition

Chaque session est rattachée à un canal, à partir du domaine du site d’origine (seul le domaine est conservé), des balises UTM et des identifiants de clic publicitaires (gclid, fbclid, msclkid, ttclid).

  • Accès direct : aucun site d’origine ni balise UTM.
  • Recherche naturelle : moteurs de recherche (Google, Bing, Qwant, DuckDuckGo, Ecosia…).
  • Publicité payante : identifiant de clic Google Ads ou Microsoft Ads (gclid, msclkid), ou utm_medium de type cpc, ppc, paid ou display.
  • Réseaux sociaux : Facebook, Instagram, TikTok, LinkedIn, Pinterest, X, YouTube…, ou lien portant fbclid ou ttclid.
  • E-mail : utm_medium=email ou webmail (Gmail, Outlook…).
  • Sites référents : tout autre site.
  • Autres campagnes : balise UTM qui ne correspond à aucun des cas précédents.

Les retours depuis une page de paiement (PayPal, Stripe…) ne comptent pas comme une source : ils ne remplacent jamais l’origine réelle de la visite.

L’onglet présente les canaux (sessions, part, rebond, ajout au panier, conversion, commandes et CA), puis les sources, les campagnes utm_campaign, les pages d’entrée avec un lien vers leur heatmap, et la répartition entre nouveaux visiteurs et visiteurs connus. Cliquez sur un canal pour ouvrir le tunnel filtré sur ce canal.

Produits

Pour chaque produit : vues (une par session), premiers ajouts au panier, commandes, quantités vendues, taux d’ajout au panier et taux vue vers commande. Quatre tris sont proposés : Plus vus, Plus ajoutés au panier, Plus commandés et Opportunités.

Le tri Opportunités liste les produits vus au moins 20 fois dont le taux d’ajout au panier est inférieur à la moitié de la moyenne de la boutique. Ils attirent des visiteurs, mais quelque chose les arrête : prix, photos, description, stock ou délai de livraison.

La heatmap

Choisir une page

Les pages sont groupées par type (accueil, produits, catégories, panier et commande…) et classées par nombre de vues. Le champ de recherche filtre par titre ou par adresse. La page la plus vue se charge automatiquement. Le bloc Pages à surveiller, en tête d’onglet, liste les pages qui cumulent le plus de clics rageurs et sans effet.

La page s’affiche dans un aperçu à la taille d’écran la plus fréquente de ses visiteurs, pour l’appareil choisi (ordinateur, tablette ou mobile). Faites défiler l’aperçu : la couche de chaleur suit.

Chaque clic est replacé sur l’élément que le visiteur a cliqué, à la même position dans cet élément, quelle que soit la largeur de son écran, la hauteur de sa page au moment du clic ou un en-tête collant. Les clics sur un élément fixe (barre d’ajout au panier en bas d’écran) restent sur cet élément pendant le défilement. Si l’élément n’existe pas ou est caché dans l’aperçu (menu replié, fenêtre fermée), le clic retombe sur ses coordonnées d’origine. Dans l’aperçu, les bannières de consentement sont masquées et seuls les scripts de la boutique s’exécutent : les scripts tiers (balises, chats) sont bloqués.

Les trois modes

  • Clics : carte de chaleur des clics, du jaune (peu de clics) au rouge foncé (beaucoup).
  • Scroll : part des visiteurs qui atteignent chaque hauteur de la page, avec la ligne de flottaison moyenne.
  • Frustration : marqueurs des clics rageurs (rouges) et des clics sans effet (gris). Les clics proches sont regroupés et leur nombre est affiché.

Un clic rageur est une série de 3 clics en moins d’une seconde au même endroit. Un clic sans effet est un clic sur une image ou un élément qui semble cliquable, sans aucune réaction de la page.

Segments et éléments cliqués

Le sélecteur de segment affiche Tous les visiteurs, les acheteurs (sessions qui ont commandé) ou les non-acheteurs. Le panneau latéral classe les éléments les plus cliqués avec leurs clics rageurs et sans effet. Survolez un élément pour le repérer dans l’aperçu.

L’aperçu charge la page de la boutique dans le back-office. La boutique et le back-office doivent être sur le même domaine, et le serveur ne doit pas envoyer X-Frame-Options: DENY : utilisez SAMEORIGIN.

Rapport hebdomadaire par e-mail

Chaque lundi, un e-mail résume la semaine écoulée (du lundi au dimanche) comparée à la semaine précédente :

  • sessions, commandes validées, taux de conversion et CA suivi, avec leur évolution ;
  • jusqu’à 4 points à regarder en priorité, issus des recommandations ;
  • le tunnel en 5 étapes clés (visite, page produit, ajout au panier, tunnel de commande, commande validée) ;
  • les 5 premiers canaux d’acquisition avec leur conversion et leur CA ;
  • un bouton qui ouvre le tableau de bord sur cette semaine.

Réglages du rapport

Dans Réglages > Rapport hebdomadaire par e-mail :

  • Envoyer un rapport chaque lundi : activé par défaut.
  • Destinataires : une adresse par ligne. Laissé vide, le rapport part à l’e-mail de la boutique.
  • Langue du rapport : par défaut la langue de la boutique. Le rapport existe en français, anglais, espagnol, allemand, italien, néerlandais, polonais et portugais.
  • Enregistrer et envoyer un test : envoie tout de suite le rapport de la semaine dernière aux destinataires.
  • Aperçu de la semaine dernière : ouvre le rapport dans un nouvel onglet, tel que les destinataires le recevront.

Quand le rapport part-il ?

Aucune tâche cron n’est nécessaire. La première visite enregistrée le lundi déclenche l’envoi, après la réponse au visiteur, qui n’attend donc pas. Un verrou empêche deux envois pour la même semaine. Aucun e-mail n’est envoyé après une semaine sans visite. Après l’installation ou la mise à jour, le premier rapport part le lundi suivant.

Le rapport utilise la configuration e-mail de PrestaShop. Si les e-mails sont désactivés dans Paramètres avancés > E-mail, un avertissement s’affiche dans les réglages. Les liens du rapport ouvrent le back-office sans jeton de sécurité : PrestaShop demande une confirmation avant d’afficher la page, c’est normal.

Filtres

Les rapports partagent une barre de filtres : période (7, 30, 90 ou 365 jours, ou dates personnalisées), appareil, canal (tableau de bord et tunnel) et boutique en multiboutique. Les filtres sont conservés quand vous passez d’un onglet à l’autre.

Réglages

Suivi

  • Activer le suivi, puis activer séparément le tunnel de conversion et la heatmap.
  • Échantillonnage heatmap (1 à 100 %) : part des sessions enregistrées pour la heatmap. Le tunnel enregistre toujours toutes les sessions.

Vie privée

  • Respecter Do Not Track et Global Privacy Control : activé par défaut.
  • Mode sans cookie : la session vit dans l’onglet du navigateur. Les visiteurs uniques ne sont plus comptés.
  • Rétention des données en jours (90 par défaut). Les événements plus anciens sont supprimés automatiquement, au plus une fois par heure.

Exclusions

  • Suivre les employés connectés : désactivé par défaut, les navigateurs connectés au back-office ne sont pas comptés.
  • Adresses IP exclues : une par ligne, adresse exacte, plage CIDR (192.168.1.0/24) ou préfixe (10.0.*). Votre adresse actuelle est affichée.
  • Exclure ce navigateur : dépose un cookie d’exclusion, pratique sur un téléphone ou un ordinateur non connecté au back-office.

Maintenance

Le bloc Maintenance des données affiche le volume stocké et propose trois actions : purger au-delà de la rétention, générer une nouvelle clé de suivi et supprimer toutes les données.

Vie privée et RGPD

  • Aucune adresse IP, aucun e-mail et aucune valeur de champ de formulaire n’est enregistré.
  • Seuls les textes des éléments cliquables (boutons, liens) sont conservés, et aucun texte sur les pages compte et commande. Les e-mails et longues suites de chiffres sont masqués dans le navigateur, puis sur le serveur.
  • Cookies techniques first-party : dffh_sid (session, 30 minutes), dffh_vid (visiteur anonyme, 13 mois) et dffh_optout (exclusion). Le mode sans cookie les supprime.
  • Robots et outils d’audit (Lighthouse, PageSpeed…) sont ignorés.
  • L’adresse de collecte n’accepte que des requêtes POST signées par une clé de suivi, et seules les adresses de votre boutique sont enregistrées.

Selon votre analyse et celle de votre DPO, vous pouvez mentionner ce suivi dans votre politique de confidentialité ou activer le mode sans cookie.

Dépannage

Aucune donnée n’apparaît. Vérifiez que vous ne testez pas depuis un navigateur connecté au back-office ou une adresse IP exclue, et que Do Not Track n’est pas activé dans votre navigateur. Videz le cache de PrestaShop après l’installation si un cache de page complet est actif.

Les étapes adresse, livraison et paiement restent à zéro. Elles reposent sur le checkout standard de PrestaShop (thèmes Classic et Hummingbird). Un module de checkout tiers peut ne pas les exposer. Les autres étapes, dont la commande validée, restent suivies côté serveur.

L’aperçu de la heatmap reste vide. La boutique et le back-office doivent être sur le même domaine, sans en-tête X-Frame-Options: DENY.

Le rapport hebdomadaire n’arrive pas. Utilisez Enregistrer et envoyer un test : un message indique si l’envoi a échoué, si les e-mails sont désactivés ou s’il manque un destinataire. Vérifiez aussi le dossier des indésirables.

Désinstallation

La désinstallation retire l’onglet, les hooks et les réglages. Les données collectées sont conservées par défaut. Pour les supprimer, activez Supprimer les données à la désinstallation dans les réglages avant de désinstaller : les 6 tables du module sont alors supprimées.

Cette page vous a-t-elle été utile ?

Toujours bloqué ? Contactez le support