Module PrestaShop

MetriXs propose un module PrestaShop officiel qui ajoute le tracker à chaque page de votre boutique, vérifie votre boutique automatiquement et envoie les événements order_completed côté serveur — le chiffre d’affaires, le panier moyen, le taux de conversion et les meilleurs produits arrivent dans votre tableau de bord MetriXs, y compris les commandes payées via des méthodes de redirection comme iDEAL ou Carte Bancaire. Aucune modification de thème, aucun code, aucun bandeau de consentement.

Ce guide détaille toute l’installation, étape par étape.

Avant de commencer

Vous avez besoin d’un compte MetriXs. Le module lui-même est gratuit et entièrement fonctionnel ; la formule gratuite MetriXs suffit pour démarrer.

1. Rendez-vous sur app.metrixs.eu et inscrivez-vous
2. Vérifiez votre adresse e-mail via le lien reçu

Étape 1 : ajoutez votre boutique dans MetriXs

1. Connectez-vous au tableau de bord MetriXs
2. Pendant l’onboarding (ou via Réglages → Sites), ajoutez le domaine de votre boutique, p. ex. votreboutique.com — sans https:// et sans www.
3. Ignorez l’étape de vérification du snippet proposée — le module vérifie votre boutique automatiquement à l’étape 5
4. Si besoin, démarrez un essai ou choisissez la formule gratuite (les événements nécessitent une formule active)

Étape 2 : créez une clé API de site

Le module s’authentifie avec une clé API propre au site. Elle ne donne accès qu’à cette boutique (stats:read + event:write), jamais à votre compte, et peut être révoquée à tout moment.

1. Dans le tableau de bord, allez dans Réglages → Sites
2. Dépliez votre boutique et repérez la section Clés API
3. Cliquez sur Create API key et nommez-la, p. ex. « PrestaShop »
4. Copiez la clé (mtx_live_...) immédiatement — elle n’est affichée qu’une seule fois et ne peut pas être récupérée plus tard

Étape 3 : installez le module

1. Téléchargez le ZIP du module depuis la page des versions GitHub (mx-cookieless-analytics-X.Y.Z.zip)
2. Dans le back-office, allez dans Modules → Gestionnaire de modules
3. Cliquez sur Téléverser un module, sélectionnez le ZIP et attendez la confirmation

Sinon, décompressez-le dans le répertoire modules/ de votre installation PrestaShop (le nom du dossier doit rester mx_cookieless_analytics).

Étape 4 : configurez le module

Dans Modules → Gestionnaire de modules, trouvez MX Cookieless Analytics et cliquez sur Configurer :

Champ	Saisie
Enable tracking	Laissez désactivé pour l’instant — à activer après la vérification (étape 5)
Site API key	La clé de l’étape 2
MetriXs URL	Laissez la valeur par défaut https://app.metrixs.eu
Shop domain	Laissez vide pour la détection automatique
Exclude logged-in customers	Activé par défaut — vos propres visites ne comptent pas

Cliquez sur Enregistrer. La vérification démarre automatiquement avec cet enregistrement.

Étape 5 : connectez et vérifiez

Cela remplace la vérification manuelle — une seule fois nécessaire.

1. Après l’enregistrement, le module demande un jeton de défi unique à l’API MetriXs et vérifie votre boutique automatiquement
2. Vous voyez la confirmation verte « shop verified »
3. Dans le tableau de bord MetriXs, votre boutique apparaît comme Verified
4. Activez Enable tracking et enregistrez à nouveau

Fonctionnement : le module demande un jeton unique à l’API MetriXs, le sert depuis votre propre domaine, et l’API va le relire. Seul quelqu’un qui contrôle votre domaine peut servir ce jeton, ce qui prouve la propriété sans

Étape 6 : vérifiez le suivi

1. Ouvrez votre boutique dans une fenêtre privée et naviguez quelques pages
2. Dans le tableau de bord MetriXs, ouvrez la vue Temps réel — les pages vues doivent apparaître en quelques secondes

Remarque : les clients connectés sont exclus par défaut. Testez en navigation privée ou ajustez l’exclusion dans les réglages du module.

Suivi des commandes (inclus)

Chaque commande validée est envoyée côté serveur dès sa création — indépendamment du flux de paiement, donc les méthodes de paiement par redirection (iDEAL, Carte Bancaire, virement) sont bien capturées. Inutile d’un script de page de remerciement qui se redéclenche au rafraîchissement.

Chaque commande arrive comme un événement order_completed avec le total payé (taxes incluses), la devise, les lignes de commande et le code de règle panier.

Dès votre commande test, le tableau de bord MetriXs affiche :

• Chiffre d’affaires, panier moyen et taux de conversion
• Le tunnel de commande et les meilleurs produits par CA
• Un classement des codes promo si vous utilisez des règles panier avec codes

Une étape supplémentaire pour voir les panneaux commerce :

1. Dans le tableau de bord, allez dans Réglages → Sites
2. Dépliez votre boutique et activez l’interrupteur Commerce

Le chiffre d’affaires est converti en EUR automatiquement via les taux quotidiens de la BCE et affiché dans la devise d’affichage choisie.

Référence des réglages

Réglage	Défaut	Signification
Enable tracking	Désactivé	Interrupteur principal — rien ne charge tant que la boutique n’est pas connectée et ceci activé
Site API key	—	Clé propre au site depuis le tableau de bord
MetriXs URL	https://app.metrixs.eu	À changer uniquement pour un endpoint personnalisé
Shop domain	Vide (auto)	Doit correspondre au domaine dans MetriXs
Exclude logged-in customers	Activé	Ne pas suivre les comptes clients connectés

Dépannage

La vérification échoue

• Assurez-vous que la boutique est joignable publiquement en HTTPS (pas de mode maintenance, pas de pare-feu bloquant les serveurs MetriXs)
• Vérifiez les modules de sécurité de l’hébergement qui bloquent les robots inconnus — l’API MetriXs relit l’URL de défi depuis votre boutique
• Enregistrez à nouveau la page de réglages : le module réessaie (au plus une fois toutes les 5 minutes)

Aucune donnée dans le tableau de bord

• La page de réglages doit afficher la confirmation « shop verified »
• Enable tracking doit être activé
• Le domaine de la boutique doit correspondre exactement au domaine dans MetriXs (sans www., sans https://)
• Vous êtes connecté en tant que client ? Exclu par défaut — testez en navigation privée
• Un cache de pages complet ? Purgez-le pour que le script tracker arrive sur vos pages

Pas de chiffre d’affaires dans le tableau de bord

• Passez une commande test et vérifiez l’événement order_completed en temps réel
• Activez l’interrupteur Commerce du site (Réglages → Sites) — les panneaux CA sont masqués sans lui

Clé API perdue Les clés ne sont pas récupérables après création. Révoquez l’ancienne dans le tableau de bord (Réglages → Sites → Clés API), créez-en une nouvelle et mettez-la à jour dans le module.

Désinstallation

Lorsque vous désinstallez le module :

• Votre boutique est automatiquement marquée déconnectée dans MetriXs (les événements ne sont plus acceptés)
• Vos données historiques restent dans votre compte MetriXs
• Les réglages du module sont retirés de votre base de données

Sans module ?

Vous pouvez toujours ajouter le tracker manuellement avec l’extrait des guides plateformes — le module automatise simplement l’installation, la vérification et le suivi des commandes.