Wenn Sie von Matomo zu Zenovay migrieren, überträgt der Matomo-Importer Ihre historischen Tagesaggregate in Zenovay, sodass Sie am Tag des Wechsels den vollen Kontext behalten. Zenovay verbindet sich mit Ihrer Matomo Reporting API unter Verwendung Ihrer Instanz-URL, token_auth und Website-ID und ruft die Historie direkt ab. Ihre Matomo-Instanz muss öffentlich erreichbar sein (selbst gehostet auf einem öffentlichen Host oder Matomo Cloud).
Was importiert wird
- Tägliche Seitenaufrufe, Besuche und eindeutige Besucher (über den angeforderten Datumsbereich)
- Top-Seiten, Top-Referrer, Top-Länder
- Browser-, Gerätetyp- und Betriebssystem-Aufschlüsselung
Was nicht importiert wird
- Einzelne Besuchersitzungen oder Rohereignisprotokolle
- Benutzerdefinierte Dimensionen oder benutzerdefinierte Berichte
- E-Commerce-/Umsatzereignisse
- Echtzeitdaten (nur abgeschlossene Tage; der heutige Tag wird stets ausgeschlossen)
- Ziele und Konversionen (nur Tagesgesamtsummen)
Was Sie benötigen
- Ihre Matomo-Instanz Basis-URL (z. B.
https://analytics.beispiel.de) - Ihr
token_auth— zu finden in Matomo unter Verwaltung → Persönlich → Sicherheit → Auth-Token - Ihre Matomo-Website-ID — zu sehen unter Verwaltung → Websites → Verwalten
Wenn Sie keinen persönlichen Token verwenden möchten, erstellen Sie einen dedizierten Token mit Ansicht-Zugriff auf die Website, die Sie importieren, und löschen Sie ihn nach dem Import.
Wie Sie importieren
- Öffnen Sie die Detailseite Ihrer Domain → Import Tab.
- Wählen Sie Matomo und wechseln Sie dann zum API-Verbindung Modus.
- Geben Sie Ihre Matomo-URL,
token_authund Website-ID ein. - Klicken Sie auf Verbinden und importieren und warten Sie auf den Fortschrittsbalken.
Standardmäßig importiert Zenovay ungefähr die letzten 90 Tage. Der Import läuft im Hintergrund, sodass Sie die Seite verlassen und später zurückkehren können. Der Status erwartet Sie dann im Import-Tab.
Hinter den Kulissen ruft Zenovay die Matomo Reporting API auf (VisitsSummary.get und Actions.get für Tagessummen, plus Actions.getPageUrls, Referrers.getReferrers, UserCountry.getCountry und DevicesDetection.* für die Aufschlüsselungen) mit Ihren Anmeldedaten auf. Der token_auth wird nur für diesen Import verwendet; Sie können ihn jederzeit in Matomo widerrufen.
Widerrufen oder rotieren Sie Ihren token_auth in Matomo nach einem erfolgreichen Import — die Verwendung eines kurzlebigen, schreibgeschützten Tokens, der speziell für den Import erstellt wurde, ist der sicherste Ansatz.
Importergebnis überprüfen
Nachdem der Import abgeschlossen ist, arbeiten Sie diese kurze Checkliste durch, um zu bestätigen, dass die Daten korrekt angekommen sind. Dies ist dasselbe Runbook, das das Zenovay-Team intern verwendet.
- Öffnen Sie eine beliebige Analyseansicht in Ihrem Dashboard (z. B. Seitenaufrufe der letzten 90 Tage). Die importierten Daten erscheinen sofort und werden mit eventuell bereits nativ erfassten Daten zusammengeführt.
- Stichproben für 3 zufällige Tage mit Ihrem Matomo-Dashboard vergleichen. Erwarten Sie ±5 % bei Seitenaufrufen und ±3 % bei Besuchen — Matomo und Zenovay entdoppeln Besucher unterschiedlich, daher ist eine kleine Abweichung normal.
- Importierte Zeilen sind mit
imported_from='matomo'in der Datenbank gekennzeichnet, sodass Sie sie jederzeit von nativen Zenovay-Daten unterscheiden können. (Hinweis: Die Stats API stelltimported_fromnicht als abfragbarer Filterschlüssel bereit — ihre Filter umfassencountry,browser,device,os,source, dieutm_*Dimensionen undpage. Siehe Stats API für die vollständige Filtersyntax.) - Importieren Sie denselben Zeitraum erneut, um die Idempotenz zu bestätigen. Die Zeilenanzahl sollte gleich bleiben — Duplikate sind aufgrund der Eindeutigkeitsbedingung auf Datenbankebene ausgeschlossen.
- Wenn Sie zufrieden sind, entfernen oder widerrufen Sie den für diesen Import erstellten
token_auth.
Falls einer dieser Checks Auffälligkeiten zeigt, schreiben Sie an [email protected] mit dem Importdatum und den betroffenen Tagen. Wir können einzelne Tage gezielt korrigieren.
Fehlerbehebung
Meldung „Verfügbar im Pro-Tarif"
Der Matomo-Importer erfordert einen kostenpflichtigen Tarif. Tarif upgraden →
„Authentifizierung fehlgeschlagen"
Überprüfen Sie Ihren token_auth — er ist Groß-/Kleinschreibung sensitiv. Vergewissern Sie sich zudem, dass die Basis-URL keinen abschließenden Schrägstrich enthält und öffentlich erreichbar ist (Zenovay-Server können private Netzwerkadressen wie http://192.168.1.x nicht erreichen). Erstellen Sie in Matomo unter Verwaltung → Persönlich → Sicherheit → Auth-Token einen neuen Token mit mindestens Ansicht-Berechtigung für die Ziel-Website.
„Website-ID nicht gefunden"
Überprüfen Sie die Website-ID unter Verwaltung → Websites → Verwalten in Matomo. Die ID ist die Nummer neben dem Website-Namen. Wenn Sie mehrere Websites haben, stellen Sie sicher, dass Sie die ID der Domain verwenden, die Sie in Zenovay importieren möchten.
„Keine Daten zurückgegeben"
Wenn Matomo für Ihren Datumsbereich leere Berichte zurückgibt, prüfen Sie, ob das Tracking an diesen Tagen aktiv war und ob die Matomo-Website-ID mit der Domain übereinstimmt. Stellen Sie außerdem sicher, dass der token_auth Ansicht-Zugriff auf die Website hat, nicht nur Superuser-Zugriff auf den Admin-Bereich.
„Import-Zeitüberschreitung"
Sehr große Datumsbereiche (mehrere Jahre) können Zeit in Anspruch nehmen. Zenovay versucht es automatisch erneut. Falls der Import weiterhin abbricht, teilen Sie den Datumsbereich in kleinere Abschnitte auf (z. B. ein Jahr nach dem anderen) und reimportieren Sie — die Idempotenz-Bedingung macht überlappende Bereiche sicher.
FAQ
Werden meine nativen Zenovay-Daten überschrieben?
Nein. Importierte Zeilen sind mit imported_from='matomo' gekennzeichnet. Sie werden neben (nicht über) den Daten gespeichert, die Sie nativ mit dem Tracking-Skript erfassen, sodass sie in der Datenbank immer unterscheidbar sind.
Kann ich erneut importieren? Ja, jederzeit. Beim erneuten Import wird derselbe Zeitraum sauber überschrieben — keine Duplikate, keine Waisenzeilen.
Ist der Matomo-Import kostenlos? Nein. Der Matomo-Importer (wie andere Analytics-Importer auch) erfordert einen Pro-Tarif oder höher.
Welche Zeitzone verwenden die importierten Tagessummen? Die importierten Zeilen verwenden die in Ihrer Matomo-Website konfigurierte Zeitzone für die Datumsdimension. Wenn Ihre Matomo-Website auf Europe/London eingestellt ist, bedeutet „2026-05-16" im Import einen vollen Tag in Londoner Zeit.
Speichert Zenovay meinen token_auth?
Nein. Ihr token_auth wird mit der Importanforderung versendet, wird nur zur Durchführung der Matomo Reporting API-Aufrufe für diesen einen Import verwendet und dann verworfen. Es wird nicht in einer Zenovay-Datenbank gespeichert oder wiederverwendet. Trotzdem sollten Sie den Token in Matomo als Vorsichtsmaßnahme widerrufen oder löschen, sobald der Import abgeschlossen ist.
Sieht Zenovay personenbezogene Daten meiner Besucher? Nein. Die Matomo Reporting API liefert nur Gesamtstatistiken (Summen, Top-N-Listen). Es werden keine einzelnen Besucherdatensätze, IPs oder Nutzer-IDs an Zenovay übertragen.
Wirkt sich das auf meine Matomo-Daten aus? Nein. Der Importer ist schreibgeschützt. Zenovay schreibt nie in Ihre Matomo-Instanz.