5 min de lecture

Importateur Fathom

Disponible à partir de Pro. L'importateur Fathom est un outil ponctuel qui rapatrie vos 90 derniers jours d'agrégats journaliers Fathom Analytics 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 Fathom Analytics : visites, pages vues, principales sources, 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='fathom', 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.

Ce que cet outil ne fait PAS

Il n'importe pas les sessions individuelles de visiteurs.
Il n'importe pas les événements personnalisés, objectifs 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.
Un compte Fathom Analytics avec au moins un site.
Une clé API Fathom en lecture seule (voir ci-dessous).

Note de sécurité. La clé API Fathom donne un accès Bearer token aux données de votre compte. Zenovay utilise votre clé uniquement lors de la requête d'import et ne la stocke pas de façon permanente. Nous recommandons de créer une clé API dédiée pour cet import et de la révoquer dans Fathom dès que l'import est terminé.

Étape par étape

1. Créer une clé API en lecture seule dans Fathom

Dans Fathom, allez dans Paramètres → API et créez une nouvelle clé API. Donnez-lui un nom reconnaissable (par ex. zenovay-import-2026-05). Copiez la clé — Fathom ne l'affiche qu'une seule fois.

Vous n'avez pas besoin d'attribuer de portées particulières ; les clés API Fathom ont par défaut un accès en lecture aux statistiques de vos sites.

2. Trouver votre identifiant de site dans Fathom

Dans Fathom, ouvrez le site que vous souhaitez importer et regardez l'URL — l'identifiant d'entité est le segment alphanumérique après /sites/, par exemple ABCDE dans https://app.usefathom.com/#/sites/ABCDE/. Vous pouvez aussi aller dans Paramètres → Sites et copier l'identifiant affiché à côté du site.

3. Ouvrir l'onglet Importer dans Zenovay

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

4. Saisir la clé API et l'identifiant de site

Cliquez sur la tuile Fathom → Connexion via API et saisissez :

Clé API — le Bearer token de l'étape 1.
Identifiant de site — l'identifiant d'entité alphanumérique de l'étape 2.

5. 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.

6. 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 Fathom.

7. Révoquer la clé API dans Fathom

Une fois l'import confirmé, retournez dans Paramètres → API dans Fathom et supprimez ou révoquez la clé créée à l'étape 1. Zenovay n'en a plus besoin pour le suivi natif ultérieur.

Dépannage

« Clé API invalide »

Vérifiez que vous avez copié la clé complète sans espaces de début ou de fin. Régénérez la clé sous Paramètres → API dans Fathom et collez-la à nouveau.

« Site introuvable »

L'identifiant de site doit être l'identifiant d'entité alphanumérique affiché dans l'URL Fathom ou les paramètres — pas le nom d'affichage ou le domaine du site. Confirmez-le sous Paramètres → Sites.

« Limite de requêtes atteinte »

Fathom limite les requêtes API par clé par minute. Si vous voyez cette erreur, attendez 60 secondes et réessayez. Zenovay réessaie automatiquement trois fois avec backoff exponentiel avant d'afficher cette erreur.

« Import partiel »

Cela indique que Fathom 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 Fathom

Fathom et Zenovay comptent les visites et filtrent les bots légèrement différemment. Attendez-vous à de petits écarts. Le marqueur imported_from='fathom' permet de filtrer pour comparer données comparables.

Distinguer les données importées

Chaque ligne importée porte imported_from='fathom' 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

Réexécuter l'import pour la même période effectue un UPSERT par date, donc il est sûr de recommencer (avec une clé API valide). Pour supprimer les données Fathom importées, ouvrez la tuile Fathom 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.