5 Min. Lesedauer

Matomo-Importer

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

Was dieses Tool tut

Liest 90 Tage Tagesaggregate aus Matomo: 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='matomo', 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.
Normalisiert die Matomo-Taxonomie automatisch auf die kanonischen Zenovay-Namen — etwa wird die Matomo-Geräteklasse Smartphone auf Zenovays Mobile abgebildet, und versionssuffigierte Betriebssysteme (Windows 11, Android 14) werden auf ihre kanonische Familie zusammengefasst.

Was dieses Tool NICHT tut

Es importiert keine einzelnen Besuchersitzungen und kein Besuchsprotokoll.
Es importiert keine Custom Events, Ziele, E-Commerce-/Umsatzdaten 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.
Entweder eine Matomo-Report-Exportdatei oder eine über HTTPS erreichbare Matomo-Instanz mit einem API-Auth-Token.

Methode A — Eine Report-Exportdatei hochladen

Verwenden Sie dies, wenn sich Ihr Matomo in einem abgeschotteten Netzwerk befindet oder Sie schlicht kein API-Token weitergeben möchten.

1. Aus Matomo exportieren

Öffnen Sie in Matomo den gewünschten Bericht (z. B. Besucher → Übersicht oder Verhalten → Seiten), stellen Sie den Zeitraum auf die letzten 90 Tage und laden Sie über das Export-Widget eine CSV- oder JSON-Datei herunter.

2. Den Import-Tab öffnen

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

3. Die Datei hochladen

Klicken Sie auf die Kachel Matomo → Export hochladen und wählen Sie Ihre CSV- oder JSON-Datei. Zenovay parst die Datei, ordnet die Matomo-Spalten dem eigenen Schema zu, normalisiert Geräte-/OS-/Browsernamen und zeigt eine Vorschau, bevor etwas geschrieben wird.

4. Bestätigen

Prüfen Sie die Vorschau (erkannte Zeilen, Zeitraum, normalisierte Dimensionen) und klicken Sie auf Importieren. Die Daten erscheinen in Ihrem Dashboard mit der Matomo-Herkunftsmarkierung.

Methode B — Über die Matomo-Reporting-API verbinden

Verwenden Sie dies für einen automatischen Import, der alle unterstützten Dimensionen in einem Durchlauf abruft.

1. Ein Auth-Token in Matomo erstellen

Gehen Sie in Matomo zu Persönlich → Sicherheit → Auth-Tokens und erstellen Sie ein neues Token. Kopieren Sie den Wert token_auth — Matomo zeigt ihn nur einmal an.

2. Ihre numerische Site-ID finden

In Matomo ist die Site-ID (idSite) die Zahl, die in der URL angezeigt wird, wenn Sie die Berichte einer Website aufrufen, oder unter Verwaltung → Websites → Verwalten. Es handelt sich um eine reine Ganzzahl wie 1 oder 42.

3. In Zenovay verbinden

Öffnen Sie die Kachel Matomo → Über API verbinden und geben Sie ein:

Matomo-Basis-URL — die Wurzel Ihrer Matomo-Installation, z. B. https://analytics.example.com (ohne nachgestellten Pfad).
token_auth — das Token aus Schritt 1.
Site-ID — die numerische idSite aus Schritt 2.

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

5. Ergebnis prüfen

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

Hinweis zur Normalisierung

Matomo und Zenovay kategorisieren Technologie leicht unterschiedlich. Zenovay bildet automatisch ab, damit importierte und native Daten zusammenpassen:

Matomo-Geräteklasse Smartphone → Zenovay Mobile; Tablet bleibt Tablet; Desktop bleibt Desktop.
Versionssuffigierte Betriebssysteme (Windows 11, macOS 15, Android 14, iOS 18) werden auf ihre kanonische Familie zusammengefasst (Windows, macOS, Android, iOS).
Browsernamen werden mit der kanonischen Zenovay-Liste abgeglichen; Minor-/Build-Versionen entfallen.

Lässt sich ein Wert nicht zuverlässig zuordnen, wird er unverändert beibehalten statt verworfen.

Fehlerbehebung

„Matomo nicht erreichbar"

Prüfen Sie, dass die Basis-URL keinen nachgestellten Pfad hat und aus dem öffentlichen Internet über HTTPS erreichbar ist. Matomo-Instanzen hinter einem VPN oder einer IP-Allowlist sind für den Importer nicht erreichbar — verwenden Sie stattdessen Methode A (Datei-Upload).

„Ungültiges token_auth"

Erzeugen Sie das Token unter Persönlich → Sicherheit → Auth-Tokens neu und fügen Sie es erneut ein. Ein Token eines anderen Matomo-Benutzers ohne Lesezugriff auf die Website schlägt hier ebenfalls fehl.

„Website nicht gefunden"

Die Site-ID muss die numerische idSite sein, nicht der Name oder die Domain der Website. Bestätigen Sie sie unter Verwaltung → Websites → Verwalten.

„Unbekanntes Exportformat"

Methode A akzeptiert die nativen CSV- und JSON-Exporte von Matomo. Erneut exportierte, manuell bearbeitete oder per Tabellenkalkulation gespeicherte Dateien können die von Zenovay benötigte Kopfzeile verlieren — laden Sie direkt über das Export-Widget von Matomo neu herunter.

„Teilweiser Import"

Dies bedeutet, dass Matomo 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 Matomo-Dashboard ab

Matomo dedupliziert und zählt Besuche anders als die native Zenovay-Erfassung, auch die Bot-Filterung unterscheidet sich. Erwarten Sie kleine Abweichungen. Die Markierung imported_from='matomo' erlaubt einen sauberen Vergleich gleich gegen gleich.

Importierte Daten unterscheiden

Jede importierte Zeile trägt imported_from='matomo' 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, daher ist eine Wiederholung gefahrlos. Um importierte Matomo-Daten zu entfernen, öffnen Sie die Kachel Matomo und verwenden Sie Importierte Daten löschen — native Zenovay-Zeilen bleiben unberührt.