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, sodass Sie beim Wechsel keinen 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 sie 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 Settings → 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 Settings → Sites und kopieren Sie die dort angezeigte ID.

3. Den Import-Tab in Zenovay öffnen

Navigieren Sie zu Domains, wählen Sie Ihre Website aus, und gehen Sie zum 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 → Connect via API 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 Import last 90 days. Der Import läuft im Hintergrund; die Benutzeroberfläche fragt alle zwei Sekunden ab und zeigt einen Fortschrittsbalken. Ein 90-Tage-Import dauert normalerweise 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 Settings → 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

"Invalid 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 Settings → API in Fathom neu und fügen Sie ihn erneut ein.

"Site not found"

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 Settings → Sites.

"Rate limited"

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.

"Partial 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' ermöglicht einen direkten Vergleich.

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 Delete imported data — native Zenovay-Zeilen bleiben unberührt.