Si vous migrez de Fathom Analytics vers Zenovay, le Fathom Importer transfère vos agrégats quotidiens récents vers Zenovay afin de conserver votre contexte le jour du changement. L'import utilise l'API Fathom avec une clé API en lecture seule et votre identifiant de site Fathom.
Ce qui est importé
- Pages vues et visiteurs uniques quotidiens (les 90 derniers jours)
- Pages principales, référents principaux, pays principaux (ventilation par fenêtre)
- Répartition par navigateur, type d'appareil et système d'exploitation
Ce qui n'est pas importé
- Historique antérieur aux 90 derniers jours
- Sessions de visiteurs individuelles ou journaux d'événements bruts
- Objectifs Fathom / conversions (totaux agrégés uniquement)
- Données e-commerce / chiffre d'affaires
- Données en temps réel (uniquement journées terminées ; le jour en cours est toujours exclu)
Comment importer
Étape 1 : Obtenir votre clé API Fathom
- Connectez-vous à votre compte Fathom sur usefathom.com.
- Accédez à Compte → API (dans la barre latérale gauche).
- Cliquez sur Créer une clé API.
- Donnez à la clé un nom descriptif (ex. « Import Zenovay — juin 2026 »).
- Définissez la permission sur Lecture seule — Zenovay n'a pas besoin d'accès en écriture.
- Copiez la clé ; elle n'est affichée qu'une seule fois.
Étape 2 : Obtenir votre identifiant de site Fathom
- Dans Fathom, accédez à Sites.
- Trouvez le site à importer. L'identifiant est le court code alphanumérique affiché sous le nom du site (ex.
ABCDE). Vous pouvez aussi le trouver dans l'URL :app.usefathom.com/sites/ABCDE/...
Étape 3 : Importer dans Zenovay
- Ouvrez le site web que vous souhaitez importer, puis ouvrez ses paramètres et sélectionnez l'onglet Import.
- Dans le sélecteur de source, choisissez la tuile Fathom Analytics.
- Collez votre clé API et votre identifiant de site Fathom.
- Cliquez sur Connecter et attendez la fin de la barre de progression.
L'import s'exécute en arrière-plan. Vous pouvez quitter la page et y revenir ; le statut vous attendra dans l'onglet Import, ainsi que l'historique des imports.
Étape 4 : Révoquer la clé API après l'import
Une fois l'import terminé avec succès, retournez dans Fathom → Compte → API et supprimez ou révoquez la clé créée. Zenovay n'en a plus besoin après l'import, et la révoquer limite le risque si la clé était compromise.
Vérifier votre import
Une fois l'import terminé, parcourez cette courte checklist pour confirmer que les données sont correctement arrivées.
- 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 Fathom. Attendez ±5 % sur les pages vues et ±3 % sur les visiteurs uniques — Fathom et Zenovay dédupliquent les visiteurs différemment, donc un écart léger est normal.
- Les lignes importées sont marquées dans la base de données avec
imported_from='fathom', donc elles se trouvent aux côtés (et non au-dessus) de vos données Zenovay natives. L'onglet Import affiche l'historique de chaque import effectué et la plage de dates qu'il couvrait. - Réimportez la même période pour confirmer l'idempotence. Le nombre de lignes doit rester identique — les doublons sont impossibles car chaque jour est clé de manière unique par site au niveau de la base de données.
- Une fois satisfait, révoquez la clé API Fathom (étape 4 ci-dessus) si ce n'est pas déjà fait.
Si l'un de ces contrôles semble incorrect, contactez [email protected] avec la date d'import et les jours qui posent problème. Nous pouvons corriger les jours individuels.
Dépannage
Message « Disponible sur Pro »
Le Fathom Importer requiert un plan payant. Mettre à niveau →
« Clé API invalide »
Assurez-vous d'avoir copié la clé complète depuis Fathom — elle n'est affichée qu'à la création. Si vous ne pouvez plus la voir, supprimez l'ancienne et créez-en une nouvelle. La clé doit avoir la permission Lecture seule ou supérieure.
« Identifiant de site introuvable »
Vérifiez l'identifiant dans Fathom → Sites. C'est un court code alphanumérique en majuscules. Si vous utilisez l'URL du tableau de bord pour le trouver, extrayez uniquement la partie code (ex. ABCDE de app.usefathom.com/sites/ABCDE/). Assurez-vous que la clé API a accès à ce site spécifique.
« Aucune donnée retournée »
Confirmez que :
- Les 90 derniers jours chevauchent la période où votre site Fathom était activement suivi.
- L'identifiant de site correspond au site que vous avez suivi — pas un autre site Fathom dans votre compte.
- La conservation des données de votre compte Fathom inclut les 90 derniers jours.
« Erreur d'authentification »
La clé API créée a peut-être été supprimée ou a expiré. Créez une nouvelle clé en lecture seule dans Fathom et réessayez l'import.
« Import expiré »
Les très grandes fenêtres peuvent prendre du temps. Zenovay réessaye automatiquement. Si cela continue, réessayez l'import — la réexécution d'une plage chevauchante est sûre car chaque jour est clé de manière unique par site.
FAQ
Cela écrasera-t-il mes données natives Zenovay ?
Non. Les lignes importées sont marquées imported_from='fathom'. Elles sont stockées aux côtés (et non au-dessus) des données natives, donc vos analyses collectées par Zenovay restent intactes.
Puis-je réimporter ? Oui, à tout moment. La réimporation écrase proprement la même plage de dates — aucun doublon, aucune ligne orpheline.
Pourquoi dois-je révoquer la clé API après l'import ? Les clés API Fathom sont persistantes. Comme Zenovay n'a besoin de la clé que pour l'import unique, la révoquer ensuite est une bonne pratique de sécurité — vous ne devez pas laisser une clé active après qu'elle ne soit plus nécessaire.
Zenovay conserve-t-il ma clé API Fathom ? Non. Zenovay utilise la clé uniquement pendant la demande d'import et ne la stocke pas après. Après l'import, révoquez-la dans Fathom pour qu'elle ne puisse pas être réutilisée.
Quel fuseau horaire utilisent les totaux journaliers ? Fathom stocke les données en UTC. Les lignes importées utilisent les dates UTC, correspondant au tableau de bord Fathom.
Zenovay verra-t-il les données personnelles de mes visiteurs ? Non. L'API Fathom ne renvoie que des statistiques agrégées. Aucun enregistrement de visiteur individuel, IP ou identifiant utilisateur n'est transféré à Zenovay.
Est-ce que cela affecte mes données Fathom ? Non. L'importeur est en lecture seule. Zenovay n'écrit jamais dans votre compte Fathom.
Puis-je importer les objectifs Fathom ? Pas en V1. Nous importons les totaux agrégés quotidiens pour les pages vues et les visiteurs. Les données d'objectif / conversion sont sur la feuille de route pour une version future.