Connecter Matomo à la Search console

Dans Matomo il est possible d’afficher les performances des recherches (mots-clés) issues de la Search Console grâce au plugin Search Engine Keywords Performance. Ce dernier permet d’associer les sites suivies aux propriétés que vous gérez via l’outil de Google.

1. Validation de votre site dans la Search Console

La première étape consister donc à vérifier que votre site est bien présent dans le tableau de bord de la Search Console. Si ce n’est pas encore le cas, faites en sorte de vérifier votre site par les modalités qui vous sont proposées.

2. Création d’une application sur Google Cloud Platform

La seconde étape consiste à déclarer une application via Google Cloud Platform et de configurer pour cette dernière une connexion OAuth. Vous permettez ainsi à Matomo de récupérer les données de la Search Console via l’API dédiée.

Important : il ne sera pas nécessaire de faire valider votre application par Google.

Connectez-vous à Google Cloud Platform.

Cliquez sur « Sélectionnez un projet ».

Dans la popin qui vient de s’ouvrir, cliquez sur Nouveau projet.

Saisissez le nom que vous voulez donner au projet, pour ma part j’ai choisi Matomo Search Console.

Une fois validé, vous devez cliquer à nouveau sur « Sélectionnez un projet ». La popin précédente apparait et vous devriez voir s’afficher votre projet. Sélectionnez le.

Une fois le contexte du projet chargé, il faut accéder à la bibliothèque d’API, utilisez pour cela le champ de recherche ou bien allez dans API et services, puis Bibliothèques

Tapez Search Console. Et sélectionnez l’API.

3. Configuration d’une connexion OAuth pour accéder à l’API de la Search Console

Aller sur la page de votre projet en cliquant sur le logo Google Cloud Platform ou procédez comme précédemment en passant par la liste des projets.

Tapez ensuite Écran de consentement OAuth (ou OAuth Consent Screen) dans le champs de recherche.

Sélectionnez External en type d’accès puis sur Créer.

3.1 Écran de consentement OAuth

Renseignez le nom de l’application et votre adresse e-mail. Accessoirement, vous pouvez aussi ajouter un logo.

Plus bas, indiquez

• la page d’accueil de l’application ; l’URL de votre instance Matomo fera l’affaire,
• un domaine autorisé ; le nom de domaine de premier niveau de votre instance Matomo,
• votre adresse e-mail.

Validez avec Enregistrer et continuer pour accéder à l’écran Niveaux d’accès ;

3.2 Niveaux d’accès

Cliquez sur Ajouter ou supprimer des champs d’application.

Un volet latéral s’affiche sur la droite de l’écran avec la liste des champs d’application. Recherchez la ligne Google Search Console API et sélectionnez là. Validez la modification.

Vous devriez voir le champs d’application apparaitre dans la rubrique Vos niveaux d’accès non sensibles.

Validez avec Enregistrer et continuer pour accéder à l’écran Utilisateurs tests.

3.3 Utilisateurs tests

À présent, cliquez sur Add users et saisissez l’email d’un utilisateur test. Les adresses e-mail acceptées sont celles associées à un compte Google, Google Workspace ou Cloud Identity actif.

3.4 Création des identifiants

Pour accéder à l’écran suivant, cliquez sur Identifiants dans le menu latéral ou bien saisissez Identifiants dans le champ de recherche.

Cliquez sur Créer des identifiants, choisissez ID client OAuth.

Sélectionnez Application Web comme type d’application.

1. Donnez un nom à l’application, par exemple : Matomo.
2. Cliquez sur Ajouter un URI sous Origines Javascript autorisées. Ajoutez le domaine où est hébergé votre instance de Matomo.
3. Cliquez sur Ajouter URI sous URI de redirection autorisés.
   • Ajouter la chaine suivante à l’adresse complète de votre instance Matomo : /index.php?module=SearchEngineKeywordsPerformance&action=processAuthCode

Validez en cliquant sur Créer.

4. Acheter le plugin Search Engine Keywords Performance

Rendez-vous sur le Market Place Matomo ; trois niveaux de licence sont disponibles pour le plugin Search Engine Keywords Performance.

Le nombre de sites suivis dans Matomo, et sur lesquels vous pouvez afficher les widgets affichant les mots-clés, est illimité. Ce n’est pas le cas du nombre d’utilisateurs. Pensez à vérifier le nombre de comptes que vous avez déjà créé et que vous serez amené à créer.

Une fois la licence commandée, récupérez l’archive du plugin et la clé de licence.

5. Installer et configurer Search Engine Keywords Performance

5.1 Installation du plugin

La méthode d’installation la plus simple consister à transférer l’archive du plugin. Pensez à activer au préalablement le téléversement de fichiers sur Matomo.

Allez dans Administration, Plate-forme, Marché puis saisissez la clé de licence.

Ensuite, cliquez sur Téléverser un composant pour accéder à l’interface pour mettre le plugin en ligne.

5.2 Configuration du plugin

Allez dans Administration, Système, Search Performance et cliquez sur Setup Configuration.

Téléversez le fichier json pour configurer votre connexion OAuth.

Une fois la connexion en place, il faut vous connecter avec le compte Google que vous avez déclaré plus haut.

Vous allez être redirigé vers l’interface de validation Google qui va vous alerter que l’application que vous avez créé n’a pas été validé. Cliquez sur Continuer.

Le compte à connecter ici est l’utilisateur de test que vous avez déclaré préalablement dans la configuration de l’API.

Si tout s’est bien déroulé, il ne vous reste alors plus qu’à associer vos sites gérés par Matomo aux propriétés des sites validés dans la Search Console. Pour cela, cliquez sur Ajouter configuration (Add Configuration).

Une fois les sites et les propriétés associées, il faudra attendre un peu avant de voir les mots-clés et les statistiques associées s’afficher dans les widgets.

On arrive au bout de ce tutoriel, j’espère qu’il vous aura permis d’installer Search Engine Keywords Performance sans trop de difficulté !

Vous pouvez retrouver l’article qui a aidé à rédiger ce tutoriel ici : https://matomo.org/faq/reports/import-google-search-keywords-in-matomo/