Si vous migrez de Matomo vers Zenovay, le Matomo Importer transfère vos agrégats quotidiens historiques vers Zenovay afin de conserver votre contexte le jour du changement. Zenovay se connecte à votre API de rapports Matomo en utilisant l'URL de votre instance, votre token_auth et l'identifiant de site, puis récupère directement l'historique. Votre instance Matomo doit être accessible publiquement (auto-hébergée sur un hôte public ou Matomo Cloud).
Ce qui est importé
- Pages vues quotidiennes, visites et visiteurs uniques (sur la plage de dates demandée)
- Pages principales, référents principaux, pays principaux
- Répartition par navigateur, type d'appareil et système d'exploitation
Ce qui n'est pas importé
- Sessions de visiteurs individuelles ou journaux d'événements bruts
- Dimensions personnalisées ou rapports personnalisés
- Événements e-commerce / chiffre d'affaires
- Données en temps réel (uniquement journées terminées ; le jour en cours est toujours exclu)
- Objectifs et conversions (totaux journaliers agrégés uniquement)
Ce dont vous avez besoin
- L'URL de base de votre instance Matomo (ex.
https://analytics.exemple.com) - Votre
token_auth— accessible dans Matomo sous Administration → Personnel → Sécurité → Tokens d'authentification - L'identifiant de site Matomo — visible sous Administration → Sites web → Gérer
Si vous ne voulez pas utiliser un token personnel, créez un token dédié avec un accès Afficher au site que vous importez, et supprimez-le une fois l'import terminé.
Étapes d'importation
- Ouvrez la page de détail de votre domaine → onglet Import.
- Sélectionnez Matomo, puis passez au mode Connexion API.
- Saisissez l'URL Matomo, le
token_authet l'identifiant de site. - Cliquez sur Connecter et importer et attendez la barre de progression.
Par défaut, Zenovay importe environ les 90 derniers jours. L'import s'exécute en arrière-plan, vous pouvez donc quitter la page et y revenir ; le statut vous attendra dans l'onglet Import.
Derrière les coulisses, Zenovay appelle l'API de rapports Matomo (VisitsSummary.get et Actions.get pour les totaux quotidiens, plus Actions.getPageUrls, Referrers.getReferrers, UserCountry.getCountry et DevicesDetection.* pour les ventilations) avec vos identifiants. Le token_auth n'est utilisé que pour cet import ; vous pouvez le révoquer à tout moment dans Matomo.
Après un import réussi, révoquez ou faites tourner votre token_auth dans Matomo — l'utilisation d'un token de courte durée, en lecture seule, créé spécifiquement pour l'import est la meilleure approche.
Vérifier votre import
Une fois l'import terminé, parcourez cette courte checklist pour confirmer que les données sont correctement arrivées. C'est le même runbook que l'équipe Zenovay utilise en interne.
- Ouvrez n'importe quelle vue analytique dans votre tableau de bord (par exemple les pages vues sur les 90 derniers jours). Les données importées apparaissent immédiatement, mélangées aux données natives déjà collectées.
- Vérifiez 3 jours au hasard par rapport à votre tableau de bord Matomo. Attendez-vous à ±5 % sur les pages vues et ±3 % sur les visites — Matomo et Zenovay dédupliquent les visiteurs différemment, un petit écart est normal.
- Les lignes importées sont marquées
imported_from='matomo'dans la base de données, vous pouvez donc les distinguer à tout moment des données collectées nativement par Zenovay. (Remarque : l'API Stats ne présente pasimported_fromcomme clé de filtre interrogeable — ses filtres couvrentcountry,browser,device,os,source, les dimensionsutm_*etpage. Voir Stats API pour la syntaxe de filtre complète.) - Réimportez la même période pour confirmer l'idempotence. Le nombre de lignes doit rester identique — les doublons sont impossibles en raison de la contrainte d'unicité au niveau de la base de données.
- Une fois satisfait, supprimez ou révoquez le
token_authque vous avez créé pour cet import.
Si l'un de ces contrôles semble incorrect, envoyez un message à [email protected] en précisant la date d'import et les jours concernés. Nous pouvons corriger individuellement certains jours.
Dépannage
Message « Disponible sur Pro »
Le Matomo Importer requiert un plan payant. Mettre à niveau →
« Authentification échouée »
Vérifiez votre token_auth — il est sensible à la casse. Assurez-vous également que l'URL de base ne se termine pas par un slash et est accessible publiquement (les serveurs Zenovay ne peuvent pas atteindre des adresses réseau privées comme http://192.168.1.x). Créez un nouveau token dans Matomo sous Administration → Personnel → Sécurité → Tokens d'authentification avec au moins la permission Afficher sur le site cible.
« Identifiant de site introuvable »
Vérifiez l'identifiant de site sous Administration → Sites web → Gérer dans Matomo. C'est le numéro affiché à côté du nom de votre site. Si vous avez plusieurs sites, assurez-vous d'utiliser l'ID qui correspond au domaine que vous importez dans Zenovay.
« Aucune donnée retournée »
Si Matomo renvoie des rapports vides pour votre plage de dates, vérifiez que le tracking était actif sur ces dates et que l'identifiant de site Matomo correspond au domaine. Vérifiez également que le token_auth a un accès Afficher au site, et non seulement un accès superutilisateur à la zone d'administration.
« Import expiré »
Pour de très longues plages de dates (plusieurs années), cela peut prendre du temps. Zenovay réessaiera automatiquement. Si l'import continue d'expirer, essayez de découper la plage de dates en tranches plus petites (par ex. importer une année à la fois) et de réimporter — la contrainte d'idempotence rend le réimport de plages chevauchantes sans risque.
FAQ
Cela écrasera-t-il mes données natives Zenovay ?
Non. Les lignes importées sont marquées imported_from='matomo'. Elles sont stockées à côté (non pas par-dessus) des données que vous collectez nativement avec le script de suivi, elles sont donc toujours distinguables dans la base de données.
Puis-je réimporter ? Oui, à tout moment. Réimporter écrase la même plage de dates proprement — pas de doublons, pas de lignes orphelines.
L'import Matomo est-il gratuit ? Non. Le Matomo Importer (comme les autres importateurs d'analytics) requiert un plan Pro ou supérieur.
Quel fuseau horaire utilisent les totaux journaliers importés ? Les lignes importées utilisent le fuseau horaire configuré de votre site Matomo pour la dimension date. Si votre site Matomo est défini sur Europe/Londres, « 2026-05-16 » dans l'import signifie un jour complet en heure de Londres.
Zenovay conserve-t-il mon token_auth ?
Non. Votre token_auth est envoyé avec la demande d'import, utilisé uniquement pour effectuer les appels API de rapports Matomo pour cet unique import, puis jeté. Il n'est pas sauvegardé dans une base de données Zenovay ou réutilisé. Même ainsi, une fois l'import terminé, vous devriez révoquer ou supprimer le token dans Matomo par prudence.
Zenovay verra-t-il les données personnelles de mes visiteurs ? Non. L'API de rapports Matomo ne renvoie que des statistiques agrégées (totaux, listes Top-N). Aucun enregistrement de visiteur individuel, adresse IP ou identifiant utilisateur n'est transféré à Zenovay.
Est-ce que cela affecte mes données Matomo ? Non. L'importeur est en lecture seule. Zenovay n'écrit jamais dans votre instance Matomo.