6 min de lecture

Importateur Matomo

Disponible à partir de Pro. L'importateur Matomo est un outil ponctuel qui rapatrie vos 90 derniers jours d'agrégats journaliers Matomo dans Zenovay — pour que vous ne perdiez pas votre historique lors du changement d'outil.

Ce que fait cet outil

Lit 90 jours d'agrégats journaliers depuis Matomo : visites, pages vues, sources principales, pages les plus consultées, pays principaux, appareils, systèmes d'exploitation et navigateurs.
Les écrit dans la table analytics_daily de Zenovay avec imported_from='matomo', ce qui permet de distinguer clairement les données importées des données natives Zenovay.
Idempotent : réimporter la même période effectue un UPSERT par date et écrase proprement, sans doublons.
Normalise automatiquement la taxonomie Matomo vers les noms canoniques Zenovay — par exemple la classe d'appareil Matomo Smartphone est mappée sur Mobile de Zenovay, et les systèmes d'exploitation suffixés d'une version (Windows 11, Android 14) sont regroupés sous leur famille canonique.

Ce que cet outil ne fait PAS

Il n'importe pas les sessions individuelles ni le journal des visites.
Il n'importe pas les événements personnalisés, les objectifs, les données e-commerce/revenus ni les données en temps réel.
Il ne synchronise pas en continu — la V1 est ponctuelle. La synchronisation récurrente est sur la feuille de route.

Prérequis

Un compte Zenovay sur le plan Pro ou supérieur.
Soit un fichier d'export de rapport Matomo, soit une instance Matomo joignable en HTTPS avec un jeton d'authentification API.

Méthode A — Téléverser un export de rapport

Utilisez ceci si votre Matomo est sur un réseau cloisonné ou si vous préférez simplement ne pas partager de jeton d'API.

1. Exporter depuis Matomo

Dans Matomo, ouvrez le rapport souhaité (par exemple Visiteurs → Aperçu ou Comportement → Pages), réglez la plage de dates sur les 90 derniers jours et utilisez le widget Exporter pour télécharger un fichier CSV ou JSON.

2. Ouvrir l'onglet Importer

Allez sur la page de détail de votre domaine → onglet Importer. Vous verrez des tuiles de sources pour Plausible (existante) et Matomo (nouvelle).

3. Téléverser le fichier

Cliquez sur la tuile Matomo → Téléverser un export et sélectionnez votre fichier CSV ou JSON. Zenovay analyse le fichier, mappe les colonnes Matomo sur son propre schéma, normalise les noms d'appareils/OS/navigateurs et affiche un aperçu avant toute écriture.

4. Confirmer

Vérifiez l'aperçu (lignes détectées, plage de dates, dimensions normalisées) et cliquez sur Importer. Les données apparaissent dans votre tableau de bord avec le marqueur d'origine Matomo.

Méthode B — Connexion via l'API de reporting Matomo

Utilisez ceci pour un import sans intervention qui récupère toutes les dimensions prises en charge en une seule passe.

1. Créer un jeton d'authentification dans Matomo

Dans Matomo, allez dans Personnel → Sécurité → Jetons d'authentification et créez un nouveau jeton. Copiez la valeur token_auth — Matomo ne l'affiche qu'une seule fois.

2. Trouver votre identifiant de site numérique

Dans Matomo, l'identifiant de site (idSite) est le nombre affiché dans l'URL lorsque vous consultez les rapports d'un site, ou sous Administration → Sites web → Gérer. C'est un entier simple comme 1 ou 42.

3. Se connecter dans Zenovay

Ouvrez la tuile Matomo → Connecter via l'API et saisissez :

URL de base Matomo — la racine de votre installation Matomo, par exemple https://analytics.example.com (sans chemin final).
token_auth — le jeton de l'étape 1.
Identifiant de site — l'idSite numérique de l'étape 2.

4. Lancer l'import

Cliquez sur Importer les 90 derniers jours. L'import s'exécute en arrière-plan ; l'interface interroge le statut toutes les deux secondes et affiche une barre de progression. Un import sur 90 jours prend généralement de 30 à 60 secondes.

5. Vérifier

Une fois l'import terminé, vous verrez un récapitulatif : lignes importées, plage de dates et dimensions trouvées. Les données importées apparaissent immédiatement dans votre tableau de bord avec le marqueur d'origine Matomo.

À propos de la normalisation

Matomo et Zenovay catégorisent la technologie de façon légèrement différente. Zenovay mappe automatiquement pour que vos données importées et natives s'alignent :

Classe d'appareil Matomo Smartphone → Zenovay Mobile ; Tablet reste Tablet ; Desktop reste Desktop.
Les systèmes d'exploitation suffixés d'une version (Windows 11, macOS 15, Android 14, iOS 18) sont regroupés sous leur famille canonique (Windows, macOS, Android, iOS).
Les noms de navigateurs sont rapprochés de la liste canonique de Zenovay ; les versions mineures/de build sont supprimées.

Si une valeur ne peut pas être mappée de façon fiable, elle est conservée telle quelle plutôt que supprimée.

Dépannage

« Matomo injoignable »

Vérifiez que l'URL de base n'a pas de chemin final et qu'elle est joignable en HTTPS depuis l'internet public. Les instances Matomo derrière un VPN ou une liste d'autorisation d'IP ne sont pas joignables par l'importateur — utilisez plutôt la Méthode A (téléversement de fichier).

« token_auth invalide »

Régénérez le jeton sous Personnel → Sécurité → Jetons d'authentification et collez-le à nouveau. Un jeton appartenant à un autre utilisateur Matomo sans accès en lecture au site échouera également ici.

« Site introuvable »

L'identifiant de site doit être l'idSite numérique, pas le nom ni le domaine du site. Confirmez-le sous Administration → Sites web → Gérer.

« Format d'export non reconnu »

La Méthode A accepte les exports CSV et JSON natifs de Matomo. Les fichiers réexportés, modifiés manuellement ou réenregistrés via un tableur peuvent perdre la ligne d'en-tête dont Zenovay a besoin — retéléchargez directement depuis le widget Exporter de Matomo.

« Import partiel »

Cela indique que Matomo a renvoyé moins de 90 jours de données — généralement parce que le site est plus récent que 90 jours, ou parce que certains jours n'ont enregistré aucun trafic. Vérifiez par échantillonnage la plage importée dans votre tableau de bord.

Les données diffèrent légèrement du tableau de bord Matomo

Matomo déduplique et compte les visites différemment de l'ingestion native de Zenovay, et le filtrage des bots diffère. Attendez-vous à de petits écarts. Le marqueur imported_from='matomo' permet de filtrer pour comparer données comparables.

Distinguer les données importées

Chaque ligne importée porte imported_from='matomo' dans analytics_daily. Dans la Public Stats API de Zenovay (Pro+), vous pouvez filtrer sur ce même champ. Les données natives Zenovay ont imported_from=NULL.

Réimport et suppression

Relancer l'import pour la même période effectue un UPSERT par date, vous pouvez donc répéter l'opération sans risque. Pour supprimer les données Matomo importées, ouvrez la tuile Matomo et utilisez Supprimer les données importées — les lignes natives Zenovay ne sont pas touchées.

Ressources associées

Besoin d'aide ? Contactez [email protected] ou visitez notre Centre d'aide.