Comment importer des données Matomo dans Looker Studio ?

Matomo collecte de nombreuses données précieuses sur le comportement des visiteurs de votre site Web. Si vous vous êtes déjà demandé comment visualiser les données suivies par Matomo dans un outil tiers comme Looker Studio / Google Data Studio, alors ce guide est fait pour vous. Dans ce guide, nous allons vous guider à travers les étapes pour connecter votre Matomo à Looker Studio.

Avec Matomo On-Premises – en particulier lorsque vous avez accès à la base de données, il est facile de connecter Matomo à Looker Studio en utilisant le connecteur MySQL. Le défi est lorsque vous n’avez pas accès à la base de données. Voici une solution pour importer des données dans Looker Studio en utilisant les feuilles Google.

Note : Certains rapports Matomo contiennent beaucoup de données que les feuilles Google peuvent ne pas accepter sans modification supplémentaire de la feuille. Le code fourni n’est pas pris en charge par Matomo, car il s’agit simplement d’un exemple de la manière de réaliser la connexion.

Si vous utilisez Matomo pour WordPress, ce guide ne fonctionnera pas car Matomo pour WordPress ne prend pas en charge l’API de création de rapports HTTP de Matomo et utilise à la place l’API WordPress Rest, voir notre référence API WordPress Rest. Vous pourrez peut-être connecter Matomo pour WordPress en choisissant « MySQL » comme source de données ou en important les données dans une feuille de calcul Google à l’aide de l’API WordPress REST. La fonctionnalité « token_auth » n’est pas disponible dans Matomo pour WordPress.

Créer un script qui appelle l’API Matomo et importe des données dans Google Spreadsheets

L’API Matomo vous donne la possibilité d’exporter toutes les données dans plusieurs formats. Comment exporter ?

Dans l’exemple ci-dessous, nous allons exporter un rapport personnalisé.

1. Cliquez sur l’icône « Exporter ».

2. Choisissez « CSV » dans « Format d’exportation », choisissez « Tous » dans « Limite de ligne », cliquez sur « Afficher l’URL d’exportation » et copiez l’« URL d’exportation ».

Note importante : Le token_auth que vous voyez sur cet écran d’exportation est un token_auth de session qui ne sera valide que lorsque vous serez connecté. Veuillez suivre notre guide pour générer un token_auth.

Une fois que vous avez généré un token_auth, vous devez insérer le nouveau token_auth que vous avez créé dans l’URL ci-dessous, par exemple : &token_auth=your_new_auth_token_here

3. Ouvrez une « feuille Google » vierge et nommez-la de manière appropriée.

4. Cliquez sur « Extensions > Apps Script ».

5. Dans « l’Éditeur de script », collez le code ci-dessous. Le code fourni n’est pas pris en charge ni créé par Matomo, car il s’agit simplement d’un exemple de la manière de réaliser la connexion.

function myFunction() {
var csvUrl = « EXPORT_URL »;
var csvContent = UrlFetchApp.fetch(csvUrl).getContentText();
var csvData = Utilities.parseCsv(csvContent);
var sheet = SpreadsheetApp.getActiveSheet();
sheet.getRange(1, 1, csvData.length, csvData[0].length).setValues(csvData);
}

6. Remplacez « EXPORT_URL » dans le code ci-dessus par l’URL copiée à l’ÉTAPE 2 et ajoutez &convertToUnicode=0 à la fin de l’URL. Remarque : vous pouvez utiliser &date=yesterday si vous voulez seulement rapporter les données d’« hier ».

7. Ajoutez à « EXPORT_URL » le paramètre URL suivant : &convertToUnicode=0 à la fin de l’URL.

8. Renommez le projet et cliquez sur l’icône de sauvegarde.

9. Cliquez sur l’icône Exécuter et lorsque vous y êtes invité, continuez et donnez au script l’autorisation de se connecter à un service externe.

10. Les données doivent être importées dans les feuilles Google à ce stade. Vous devrez exécuter ce script manuellement à chaque fois pour que les données soient importées dans le Data Studio.

Remarque : pour automatiser la tâche ci-dessus ou programmer l’importation des données en temps voulu, vous devrez peut-être configurer un déclencheur dans Data Studio. Par exemple, créez un rapport quotidien pour le jour précédent afin de pouvoir exécuter le script à minuit tous les soirs. Veuillez noter que le script remplace toutes les données existantes, vous pouvez modifier le script pour créer une feuille de calcul différente à chaque fois ou ajouter cette feuille de calcul.

Ensuite, nous allons créer un déclencheur pour automatiser le processus d’importation dans la feuille de calcul Google

Création d’un déclencheur (facultatif)

Si vous ne souhaitez pas créer de déclencheur, vous pouvez passer directement à la connexion à Data Studio

1. Survolez l’icône « Horloge » sur la gauche. Cliquez sur « Déclencheurs ».

2. Cliquez sur « Ajouter un déclencheur ».

3. Choisissez la fréquence d’exécution de l’importation.

4. Sauvegardez le déclencheur.

Connecter la feuille Google à Google Data Studio

1. Ouvrez Data Studio.

2. Cliquez sur « Créer ».

3. Choisissez « Source des données ».

4. Cliquez sur « Google Sheets », vous devrez peut-être autoriser Data Studio à accéder à Google Sheets.

5. Sélectionnez la feuille de calcul créée précédemment (voir la section ci-dessus), laissez les options par défaut sélectionnées et cliquez sur « Connexion ».

6. Pour chaque champ, vérifiez que le type de données correct est sélectionné ou mettez-le à jour de manière appropriée.

7. Cliquez sur « Créer un rapport ».

8. Cliquez sur « Ajouter au rapport ».

9. Vous devriez maintenant voir le rapport avec les données ajoutées.

Félicitations, vous pouvez maintenant importer et visualiser les données de vos sites Web et de vos visiteurs dans Google Data Studio.