Installer Matomo sur votre serveur

Matomo existe sous plusieurs formats, l'offre Cloud et l'offre On-Premise. L'offre Cloud est une version de Matomo hébergé directement par la société éditrice de Matomo, vous devrez donc payer un abonnement tous les mois pour pouvoir l'utiliser (à partir de 30€/mois). Nous allons apprendre à installer Matomo par nous même afin de limiter les frais et avoir une flexibilité maximale sur notre installation, c'est l'offre On-Premise de Matomo qui va nous intéresser.

Installation sur un serveur

Pour installer Matomo, il vous faudra avoir un serveur web. Votre serveur doit permettre de faire tourner des sites en PHP. Un serveur standard avec Apache2, PHP et MySQL/MariaDB fait très bien l'affaire (une configuration identique à celle d'un serveur WordPress fonctionne parfaitement). Si ces termes ne vous parlent pas, comprenez simplement que Matomo fonctionne sur la très grande majorité des serveur web que vous pourrez commander chez un hébergeur.

Pour réaliser nos tests, j'ai choisi de travailler avec un serveur local (gratuit, mais qui ne fonctionnera que sur ma machine, ce qui est suffisant pour pouvoir faire une démonstration). Je suis un utilisateur de Windows et j’ai donc choisi d’utiliser WampServer pour avoir un serveur web prêt à l'emploi très simplement. Si vous êtes un utilisateur de Mac je vous recommande d’installer Mamp, l'équivalent de Wamp pour les utilisateurs de Mac.

Télécharger Matomo

Une fois votre serveur mis en place, il ne vous reste plus qu'à télécharger l’archive sur le site officiel de Matomo. Pour cela rendez-vous sur le site officiel https://matomo.org et cliquez sur le menu ‘On-premise’ puis ‘Download for free’. Sinon, vous pouvez téléchargez l'archive de Matomo depuis ce lien. L'archive téléchargée devrait faire un peu moins de 19 Mo.

Uploader Matomo sur le serveur

L’archive téléchargée contient tous les fichiers nécessaires à l'installation de Matomo. Pour continuer l'installation de Matomo, il vous faudra extraire le contenu de l'archive, et l'uploader dans le répertoire prévu à cet effet sur votre serveur.

Sur un serveur dédié classique (VPS) : /var/www/matomo

Sur un serveur local (WAMP) : C:/wamp64/www/matomo

Une fois tous les fichiers placés sur votre serveur, nous allons pouvoir passer à la mise en place de la base de données.

Création de la base de données

Pour continuer l’installation, vous devrez dans un premier temps créer une base de données vierge afin que Matomo puisse stocker les informations relatives au tracking et à son propre fonctionnement. Pour créer la base de données, rendez-vous sur l’URL http://localhost/phpmyadmin ou utilisez un outil de gestion de base de données comme PhpMyAdmin, SequelPro ou Mysql Workbench.

Une fois sur votre outil de gestion de base de données, connectez-vous avec vos identifiants root et laissez le mot de passe vide pour Wamp, ou root et root pour Mamp. Vous pourrez ensuite créer une nouvelle base de données vierge que vous pouvez appeler matomo en minuscule. Une fois ce travail réalisé, vous n'avez plus rien à faire au niveau de votre serveur, Matomo va organiser la base de données pour vous et créer les tables dont il à besoin pour fonctionner lors de son installation.

Les étapes d’installation

Avant de configurer Matomo, réfléchissez bien au domaine ou sous-domaine d’installation. Je vous conseille de mettre Matomo sur un sous domaine, ou sur un domaine séparé, mais pas sur le même nom de domaine que votre site :

Ne pas faire : https://mon-site.com/matomo

Mais préférez : https://matomo.mon-site.com

Pour débuter l’installation, rendez-vous sur le domaine que vous aurez choisi. Si vous avez un serveur local, rendez-vous simplement sur http://localhost/matomo (assurez-vous d'avoir bien démarré votre serveur local avant) - sur MAMP, vous devrez rajouter le port 8080 à votre URL.

Étape 1 - Désactivez votre adBlock

La première étape est une étape de bienvenue que vous pouvez passer rapidement. Pour éviter tout problèmes, Matomo vous recommande de désactiver votre bloqueur de publicité si vous en possédez un.

Étape 2 - Vérification du système

C’est pendant la deuxième étape que Matomo vérifie que votre environnement (votre serveur) est correctement paramétré pour pouvoir fonctionner. Matomo va donc établir lui-même une check liste de vérifications. Dans la grande majorité des cas, tout est bon, sauf parfois le HTTPS (lorsque vous êtes sur un serveur local, vous êtes de base en HTTP, donc rien de grave). 

Étape 3 - Connexion à la base de données

Vous pouvez ensuite passer à la troisième étape où on vous demande de relier Matomo à la base de données. Comme nous avons déjà créé la base de données, il vous suffira de remplir les champs suivants :

• Serveur de la base de donnée : 127.0.0.1
• Compte utilisateur : root (ou votre identifiant défini par la BDD)
• Mot de passe :  (laissez vide, ou votre mot de passe si défini avant)
• Nom de la base de donnée : matomo
• Préfixe des tables : matomo_
• Adaptateur : PDO\MYSQL

Une fois les informations fournies, Matomo va commencer à créer la structure de la base de données pour vous, cela peut prendre quelques secondes.

Étape 4 - Création de la base de données

Félicitation, Matomo à réussi à installer la base de données correctement, vous pouvez passer à l’étape 5 !

Si la configuration de votre base de données à échouée, vérifiez bien l'adresse de votre serveur de BDD, regardez également le type de base de données utilisé. Une erreur fréquente avec l'utilisation de WAMP est d'avoir deux systèmes de gestions de bases de données (SGBD) installés, et de ne plus savoir lequel est actif (MySQL ou MariaDB) !

Étape 5 - Création du profil administrateur

Matomo vous demande ensuite de créer le premier utilisateur qui se verra attribuer le rôle de ‘Super Utilisateur’ et possèdera tous les droits. Créez le compte utilisateur sans négliger la force du mot de passe, n'oubliez pas que l'ensemble des données seront accessibles via ce compte utilisateur, il ne faudrait pas qu'il tombe entre de mauvaises mains.

Depuis l'ajout du Tag Manager interne, l'accès au compte Super Utilisateur permet (dans le cadre d'un usage volontairement malsain) de publier du code source malicieux sur le site, sans aucune restriction. Nous en parlerons en détail dans la section Tag Manager de la formation. Ne négligez pas la robustesse de votre mot de passe.

Étape 6 - Ajout du premier site web

Il ne vous reste plus qu'à renseigner les informations du site internet à suivre. Le nom servira à différencier les sites lorsque vous en ajouterez plusieurs (Matomo permet d'ajouter autant de sites à suivre que vous le souhaitez).

L'URL lui permet d’ajouter le domaine de votre site internet, le fuseau horaire permet de synchroniser les visites dans le monde entier et d’afficher des dates cohérentes et relatives à votre position sur le globe.

Et la dernière option vous permet d’activer un suivi e-commerce, très utile si votre site est/ou possède une partie boutique en ligne.

Étape 7 - Mise en place du code de suivi

Pour fonctionner, Matomo à besoin que vous ajoutiez un petit morceau de code JavaScript à l'ensemble des pages de votre site web.

Matomo vous invite évidement à le mettre en place au plus vite, mais sâchez qu'il est possible de passer cette étape et d'installer le script de suivi plus tard, vous retrouverez le code dans la partie administration de Matomo. Nous allons mettre en place le code de suivi dans le prochain épisode de cette formation.

Pour facitiliter la maintenance de votre code de suivi, je vous invite à créer un petit fichier séparé dans le quel vous collerez uniquement le code JavaScript de Matomo. C'est ce fichier que vous allez inclure à l'ensemble des pages de votre site, de cette facon, si vous modifiez le script de suivi, les changements s'appliqueront sur l'ensemble des pages. 

Étape 8 - Application du RGPD

Dans l’étape 8, Matomo vous propose d’appliquer les règles du RGPD sur la collecte de données, assurez-vous de bien cocher les deux cases (DoNotTrack et Masquer les IPs). Nous nous attarderons plus tard sur le respect du RGPD avec Matomo prochainement dans cette formation.

Dans le prochain épisode nous verrons comment correctement déployer le script de suivi de Matomo sur votre site internet.