4 Min. Lesedauer

Fathom-Importer

Verfügbar ab Pro. Der Fathom-Importer ist ein einmaliges Tool, um Ihre letzten 90 Tage Fathom-Analytics-Tagesaggregate nach Zenovay zu übernehmen — damit Sie beim Wechsel keinen historischen Kontext verlieren.

Was dieses Tool tut

Liest 90 Tage Tagesaggregate aus Fathom Analytics: Besuche, Seitenaufrufe, Top-Quellen, Top-Seiten, Top-Länder, Geräte, Betriebssysteme und Browser.
Schreibt sie in die Zenovay-Tabelle analytics_daily mit imported_from='fathom', sodass importierte Daten eindeutig von nativen Zenovay-Daten zu unterscheiden sind.
Idempotent: Ein erneuter Import desselben Zeitraums führt ein UPSERT pro Datum aus und überschreibt sauber, ohne Duplikate zu erzeugen.

Was dieses Tool NICHT tut

Es importiert keine einzelnen Besuchersitzungen.
Es importiert keine Custom Events, Ziele oder Echtzeitdaten.
Es synchronisiert nicht fortlaufend — V1 ist einmalig. Eine wiederkehrende Synchronisation steht auf der Roadmap.

Voraussetzungen

Ein Zenovay-Konto im Pro-Tarif oder höher.
Ein Fathom-Analytics-Konto mit mindestens einer Website.
Ein schreibgeschützter Fathom-API-Key (siehe unten).

Sicherheitshinweis. Der Fathom-API-Key gewährt Bearer-Token-Zugriff auf Ihre Kontodaten. Zenovay verwendet Ihren Schlüssel ausschließlich während der Importanfrage und speichert ihn nicht dauerhaft. Wir empfehlen, für diesen Import einen dedizierten API-Key zu erstellen und ihn sofort nach Abschluss des Imports in Fathom zu widerrufen.

Schritt für Schritt

1. Einen schreibgeschützten API-Key in Fathom erstellen

Gehen Sie in Fathom zu Einstellungen → API und erstellen Sie einen neuen API-Key. Geben Sie ihm einen aussagekräftigen Namen (z. B. zenovay-import-2026-05). Kopieren Sie den Schlüssel — Fathom zeigt ihn nur einmal an.

Sie müssen keine besonderen Berechtigungen vergeben; Fathom-API-Keys haben standardmäßig Lesezugriff auf die Statistiken Ihrer Websites.

2. Ihre Site-ID in Fathom finden

Öffnen Sie in Fathom die gewünschte Website und schauen Sie in die URL — die Entitäts-ID ist das alphanumerische Segment nach /sites/, z. B. ABCDE in https://app.usefathom.com/#/sites/ABCDE/. Alternativ gehen Sie zu Einstellungen → Websites und kopieren Sie die dort angezeigte ID.

3. Den Import-Tab in Zenovay öffnen

Navigieren Sie zur Detailseite Ihrer Domain → Tab Import. Sie sehen Quellen-Kacheln für Plausible (bestehend) und Fathom (neu).

4. API-Key und Site-ID eingeben

Klicken Sie auf die Kachel Fathom → Über API verbinden und geben Sie ein:

API-Key — das Bearer-Token aus Schritt 1.
Site-ID — die alphanumerische Entitäts-ID aus Schritt 2.

5. Den Import starten

Klicken Sie auf Letzte 90 Tage importieren. Der Import läuft im Hintergrund; die Oberfläche fragt alle zwei Sekunden ab und zeigt einen Fortschrittsbalken. Ein 90-Tage-Import dauert üblicherweise 30 bis 60 Sekunden.

6. Ergebnis prüfen

Nach Abschluss sehen Sie eine Zusammenfassung: importierte Zeilen, Zeitraum und gefundene Dimensionen. Die importierten Daten erscheinen unmittelbar in Ihrem Dashboard mit der Fathom-Herkunftsmarkierung.

7. Den API-Key in Fathom widerrufen

Sobald der Import bestätigt ist, gehen Sie zurück zu Einstellungen → API in Fathom und löschen oder widerrufen Sie den in Schritt 1 erstellten Schlüssel. Zenovay benötigt ihn für das nachfolgende native Tracking nicht mehr.

Fehlerbehebung

„Ungültiger API-Key"

Stellen Sie sicher, dass Sie den vollständigen Schlüssel ohne führende oder nachfolgende Leerzeichen kopiert haben. Erzeugen Sie den Schlüssel unter Einstellungen → API in Fathom neu und fügen Sie ihn erneut ein.

„Website nicht gefunden"

Die Site-ID muss die alphanumerische Entitäts-ID aus der Fathom-URL oder den Einstellungen sein — nicht der Anzeigename oder die Domain der Website. Bestätigen Sie sie unter Einstellungen → Websites.

„Rate-Limit erreicht"

Fathom begrenzt API-Anfragen pro Schlüssel pro Minute. Wenn Sie diesen Fehler sehen, warten Sie 60 Sekunden und versuchen Sie es erneut. Zenovay versucht zuvor automatisch dreimal mit exponentiellem Backoff, bevor diese Meldung angezeigt wird.

„Teilweiser Import"

Dies bedeutet, dass Fathom weniger als 90 Tage Daten zurückgegeben hat — meist weil die Website jünger als 90 Tage ist oder an einzelnen Tagen kein Traffic vorlag. Prüfen Sie den importierten Zeitraum stichprobenartig in Ihrem Dashboard.

Daten weichen leicht vom Fathom-Dashboard ab

Fathom und Zenovay zählen Besuche und filtern Bots leicht unterschiedlich. Erwarten Sie kleine Abweichungen. Die Markierung imported_from='fathom' erlaubt einen sauberen Vergleich gleich gegen gleich.

Importierte Daten unterscheiden

Jede importierte Zeile trägt imported_from='fathom' in analytics_daily. In der Public-Stats-API von Zenovay (Pro+) können Sie nach demselben Feld filtern. Native Zenovay-Daten haben imported_from=NULL.

Erneuter Import und Entfernung

Ein erneuter Importlauf für denselben Zeitraum führt ein UPSERT pro Datum aus und ist daher gefahrlos (mit einem gültigen API-Key). Um importierte Fathom-Daten zu entfernen, öffnen Sie die Kachel Fathom und verwenden Sie Importierte Daten löschen — native Zenovay-Zeilen bleiben unberührt.