Plugin Shopware 6

MetriXs propose un plugin officiel pour Shopware 6 qui ajoute le tracker sur chaque page de votre boutique et vérifie votre boutique automatiquement. Il reste strictement opt-in : rien ne se charge tant que vous ne le connectez pas. Aucune modification de thème, aucun snippet Twig, aucune bannière de consentement.

Ce guide détaille l’installation complète, étape par étape.

Note

Le plugin prend en charge Shopware 6 auto-hébergé (6.5 et 6.6). Les boutiques Shopware Cloud utilisent un autre système d’extensions (« apps ») et ne sont pas encore prises en charge.

Avant de commencer

Vous avez besoin d’un compte MetriXs. Le plugin est gratuit et entièrement fonctionnel ; un forfait MetriXs gratuit 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 Paramètres → Sites), ajoutez le domaine de votre boutique, par ex. votreboutique.fr — sans https:// et sans www.
3. Ignorez l’étape de vérification par snippet du tableau de bord — le plugin vérifie votre boutique automatiquement à l’étape 4
4. Si demandé, démarrez un essai ou choisissez le forfait gratuit (les événements nécessitent un forfait actif)

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

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

1. Dans le tableau de bord, allez dans Paramètres → Sites
2. Dépliez votre boutique et trouvez la section Clés API
3. Cliquez sur Créer une clé API et donnez-lui un nom, par ex. « Shopware »
4. Copiez la clé (mtx_live_...) immédiatement — elle n’est affichée qu’une fois et ne pourra pas être récupérée plus tard

Étape 3 : installez le plugin

1. Téléchargez le dernier ZIP du plugin depuis la page des releases GitHub (metrixs-mxcoan-X.Y.Z.zip)
2. Dans l’administration Shopware, allez dans Extensions → Mes extensions
3. Cliquez sur Téléverser une extension et sélectionnez le fichier ZIP

Le plugin est testé sur Shopware 6.5 et 6.6 (auto-hébergé).

Étape 4 : configurez le plugin

Dans l’administration Shopware, allez dans Extensions → Mes extensions → MX Cookieless Analytics → Configurer :

Ou cliquez sur Connect with MetriXs : le tableau de bord MetriXs s’ouvre, où vous créez (ou ouvrez) votre compte ; la boutique est ajoutée, vérifiée et le suivi activé automatiquement. Sans copier de clé API.

Champ	À saisir
Enable tracking	Laissez désactivé pour l’instant — à activer après la vérification
Site API key	La clé de l’étape 2
MetriXs API URL	Conservez la valeur par défaut https://app.metrixs.eu

Cliquez sur Enregistrer. Le plugin vérifie votre boutique automatiquement au même enregistrement. La vérification s’exécute au maximum une fois toutes les 5 minutes — si vous corrigez une erreur (une mauvaise clé, par exemple), patientez un instant et enregistrez à nouveau.

Activez ensuite Enable tracking et enregistrez à nouveau. Shopware reconstruit le cache du thème à l’activation du plugin, le tracker apparaît donc immédiatement sur vos pages.

Étape 5 : vérifiez que le suivi fonctionne

1. Ouvrez votre boutique dans une fenêtre de navigation privée et parcourez quelques pages
2. Ouvrez le tableau de bord MetriXs et consultez la vue Temps réel — les pages vues devraient apparaître en quelques secondes

Comment fonctionne la vérification : le plugin demande un jeton de défi unique à l’API MetriXs, le sert depuis votre propre domaine (/mxcoan/challenge), et l’API le récupère. Seul quelqu’un qui contrôle votre domaine peut servir ce jeton, ce qui prouve l’appartenance. Le jeton est supprimé une fois la poignée de main terminée.

Commandes et chiffre d’affaires

Une fois le plugin connecté, les commandes abouties arrivent seules : le plugin signale une commande dès que sa transaction passe en Payée, et MetriXs la compte comme conversion - les vues chiffre d’affaires et conversion se remplissent sans réglage supplémentaire. Chaque signalement porte le total TTC, la devise, le numéro de commande et les lignes (nom, prix, quantité). Aucune donnée personnelle ne part - ni nom, ni adresse, ni e-mail, ni lien de commande.

Une commande n’est signalée qu’une fois, même si elle est remboursée plus tard ou change d’état. Si MetriXs est brièvement injoignable, le signalement n’est pas perdu : il est repris au changement d’état suivant.

Note

Plusieurs canaux de vente sur des domaines différents ? Seul le domaine vérifié lors du handshake est injecté. Ajoutez les autres domaines dans MetriXs et installez un plugin, ou utilisez le snippet, par domaine.

Référence des paramètres

Paramètre	Défaut	Signification
Enable tracking	Désactivé	Interrupteur principal — rien ne se charge tant que la boutique n’est pas connectée et ceci activé
Site API key	—	Clé limitée au site, depuis le tableau de bord
MetriXs API URL	https://app.metrixs.eu	À modifier uniquement pour des points de terminaison personnalisés

Le script du tracker est servi depuis app.metrixs.eu avec une URL versionnée, injecté dans le <head> de chaque page et chargé de manière asynchrone (defer). Il fonctionne sans problème avec le cache HTTP et le cache de page complète de Shopware : le plugin purge le cache à la connexion.

Dépannage

La vérification échoue

• Assurez-vous que la boutique est accessible publiquement en HTTPS (pas de mode maintenance, pas de pare-feu bloquant les serveurs MetriXs)
• Vérifiez les modules de sécurité d’hébergement qui bloquent les bots inconnus — l’API MetriXs récupère l’URL de défi depuis le domaine public de votre boutique
• Enregistrez à nouveau la page des paramètres : le plugin relance la vérification (au maximum une fois toutes les 5 minutes)

Aucune donnée dans le tableau de bord

• Enable tracking doit être activé et la boutique connectée (vérifiée)
• Le domaine doit correspondre exactement au domaine dans MetriXs (sans www., sans https://)
• Vous naviguez dans votre propre boutique en tant qu’admin ? Les visites storefront sont comptées comme n’importe quel visiteur — testez depuis une fenêtre privée si vous ne voyez que votre propre trafic
• Cache de page complète ? Le plugin le purge à la connexion ; si vous avez activé le suivi sans vous reconnecter, purgez le cache manuellement

Le chiffre d’affaires reste à zéro

• Les commandes ne demandent aucun réglage, mais une boutique connectée : le plugin active la fonction commerce du site lors de la vérification
• Seules les transactions passées en Payée comptent ; les commandes « en cours » ne sont pas encore comptées

Clé API perdue Les clés ne peuvent pas être récupérées après leur création. Révoquez l’ancienne dans le tableau de bord (Paramètres → Sites → Clés API), créez-en une nouvelle et mettez-la à jour dans les paramètres du plugin.

Désinstallation

Lorsque vous désinstallez le plugin :

• Votre boutique est automatiquement marquée comme déconnectée dans MetriXs (les événements ne sont plus acceptés)
• Vos données historiques restent dans votre compte MetriXs
• Les paramètres du plugin sont supprimés de votre base de données

Vous préférez sans plugin ?

Vous pouvez toujours ajouter le tracker manuellement avec le snippet des guides de plateformes — le plugin automatise simplement l’installation, la vérification et la gestion du cache.