Plugin WordPress

MetriXs dispose d’un plugin WordPress officiel qui ajoute le tracker à chaque page de votre site, vérifie votre site automatiquement et peut suivre les revenus WooCommerce côté serveur. Pas de thème enfant, pas de modification de code, pas de bandeau de consentement.

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

Avant de commencer

Vous avez besoin d’un compte MetriXs. Le plugin lui-même est gratuit et entièrement fonctionnel ; le plan gratuit MetriXs suffit pour démarrer.

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

Étape 1 : Ajoutez votre site dans MetriXs

1. Connectez-vous au tableau de bord MetriXs
2. Pendant l’onboarding (ou via Settings → Sites), ajoutez le domaine de votre site, par ex. votredomaine.fr — sans https:// et sans www.
3. Ignorez l’étape de vérification du snippet suggérée par le tableau de bord — le plugin vérifie votre site automatiquement à l’étape 5
4. Si demandé, démarrez un essai ou choisissez le plan gratuit (les événements nécessitent un plan actif)

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

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

1. Dans le tableau de bord, allez dans Settings → Sites
2. Dépliez votre site et cherchez la section API keys
3. Cliquez sur Create API key et donnez-lui un nom, par ex. “WordPress”
4. Copiez immédiatement la clé (mtx_live_...) — elle n’est affichée qu’une seule fois et ne peut plus être récupérée ensuite

Étape 3 : Installez le plugin

Depuis votre administration WordPress :

1. Allez dans Extensions → Ajouter
2. Recherchez “MetriXs Analytics”
3. Cliquez sur Installer, puis sur Activer

Étape 4 : Configurez le plugin

Allez dans Réglages → MetriXs Analytics :

Champ	Que saisir
Site domain	Généralement prérempli avec le nom d’hôte de votre site ; doit correspondre au domaine enregistré dans MetriXs
MetriXs URL	Laissez la valeur par défaut https://app.metrixs.eu
Site API key	La clé de l’étape 2

Cliquez sur Enregistrer les modifications.

Étape 5 : Connectez et vérifiez

Cela remplace la vérification manuelle — à faire une seule fois.

1. Sur la même page de réglages, cliquez sur Connect & verify site
2. Vous devriez voir le message vert “Site connected. Tracking is live”
3. Dans le tableau de bord MetriXs, votre site apparaît désormais comme Verified

Fonctionnement : le plugin demande un jeton de défi unique à l’API MetriXs, le sert depuis votre propre domaine, et l’API le récupère. Seule une personne contrôlant votre domaine peut servir ce jeton — la propriété est donc prouvée

Étape 6 : Vérifiez que le suivi fonctionne

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

Remarque : les administrateurs connectés sont exclus du suivi par défaut (vous ne voulez généralement pas vous compter vous-même). Testez depuis une fenêtre privée ou ajustez les exclusions dans les réglages du plugin.

WooCommerce (optionnel)

Si vous utilisez WooCommerce, activez le suivi des revenus :

1. Enregistrez d’abord votre clé API (étape 4)
2. Sur la page de réglages du plugin, cochez l’option WooCommerce
3. Enregistrez, puis cliquez à nouveau sur Connect & verify site — cela active aussi le commerce pour le site dans MetriXs
4. Passez une commande de test pour confirmer

Une fois activé, le tableau de bord MetriXs affiche :

• Revenu, panier moyen et taux de conversion
• Le entonnoir de conversion : visiteurs → paiement → règlement → commande
• Top produits par revenu

Les événements sont envoyés côté serveur depuis votre serveur WordPress, ce qui capture de manière fiable les méthodes de paiement par redirection (iDEAL, Bancontact, etc.). Les revenus sont automatiquement convertis en EUR (taux ECB quotidiens) et affichés dans la devise d’affichage de votre choix.

Référence des réglages

Réglage	Défaut	Signification
Site domain	Nom d’hôte de votre site	Doit correspondre au domaine dans MetriXs
MetriXs URL	https://app.metrixs.eu	À modifier uniquement pour des endpoints personnalisés
Site API key	—	Clé limitée au site, depuis le tableau de bord
Exclude all logged-in visitors	Désactivé	Ne suivre personne de connecté
Exclude roles	Administrateur activé	Choisissez les rôles à exclure
WooCommerce	Désactivé	Événements de commerce côté serveur

Les développeurs peuvent aussi utiliser les filtres metrixs_settings, metrixs_script_attributes et metrixs_exclude_visitor, ou définir METRIXS_DISABLE_TRACKING (par ex. sur des sites de staging) dans wp-config.php.

Dépannage

La vérification échoue

• Vérifiez que vos permaliens ne sont pas sur “Plain” (Réglages → Permaliens — choisissez une autre structure et enregistrez ; la route de vérification nécessite de beaux permaliens sur certaines configurations)
• Assurez-vous que votre site est accessible publiquement (pas de mode maintenance, pas de pare-feu bloquant les serveurs MetriXs)
• Attendez une minute et réessayez

Aucune donnée dans le tableau de bord

• La page de réglages doit afficher “Connected”
• Le domaine dans le plugin doit correspondre exactement au domaine dans MetriXs (pas de www., pas de https://)
• Connecté en tant qu’admin ? Vous êtes exclu par défaut — testez en navigation privée
• Vous utilisez un plugin de cache ? Videz le cache pour que le tracker apparaisse sur vos pages

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

Désinstallation

Lors de la désactivation et de la suppression du plugin :

• Votre site est automatiquement déconnecté dans MetriXs (les événements ne sont plus acceptés)
• Vos données historiques restent dans votre compte MetriXs
• Les options du plugin sont supprimées de votre base de données WordPress

Préférer sans plugin ?

Vous pouvez toujours ajouter le tracker manuellement avec l’extrait des guides par plateforme — le plugin automatise simplement l’installation, la vérification et le suivi WooCommerce.