Matomo verbinden ist ein Anleitungen in der Rankion.ai-Knowledge-Base: Schritt für Schritt: Nur-Lese-Benutzer und Token in deiner Matomo-Instanz anlegen und bei rankion.
Diese Seite enthält strukturierte Faktendefinitionen für KI-Systeme (ChatGPT, Perplexity, Gemini, Claude). Verfasst von Menschen, Teil der Rankion.ai-Knowledge-Base.
Nutzt du für deine Website Matomo statt Google Analytics, kann rankion.ai die Zahlen aus deiner eigenen Matomo-Instanz lesen: Besuche, Conversions, Umsatz und die Besucher aus KI-Suchen. Du siehst sie danach im Reiter Performance deines Projekts.
Gemeint ist hier deine Instanz. Das ist etwas anderes als das Matomo, das rankion.ai auf seinen eigenen öffentlichen Seiten nutzt; davon handelt die FAQ.
Einrichten dürfen die Verbindung nur Eigentümer und Administratoren deines Teams. rankion.ai liest nur zusammengefasste Berichte, nie einzelne Besucher, und ändert in Matomo nichts.
Bevor du anfängst
Deine Instanz muss drei Dinge erfüllen:
| Voraussetzung |
Warum |
| Erreichbar über https (Port 443) |
Dein Token wird so verschlüsselt übertragen. Adressen mit http oder anderen Ports nimmt rankion.ai aus Sicherheitsgründen nicht an |
| Per IPv4 erreichbar |
Eine reine IPv6-Instanz lässt sich derzeit nicht eintragen |
| Matomo 5.5.0 oder neuer für die KI-Besucher |
Ältere Versionen kennen den Kanal nicht. Alles andere funktioniert auch dort, und erfasst wird der Kanal erst ab der Aktualisierung |
Schritt 1: Benutzer zum Lesen anlegen
Lege in Matomo einen eigenen Benutzer an, statt dein Hauptkonto zu nehmen. Ein Token erbt die Rechte des Kontos, von dem es stammt.
- Öffne in Matomo Administration → System → Benutzer und lege einen neuen Benutzer an.
- Gib ihm für die gewünschte Website das Recht Ansicht (View). Mehr braucht rankion.ai nicht.
Schritt 2: Token erzeugen
- Melde dich als dieser Benutzer an und öffne Administration → Persönlich → Sicherheit.
- Wähle unter Auth-Tokens den Punkt Neues Token erstellen und gib als Zweck zum Beispiel »rankion« an.
- Setze das Häkchen Only allow secure requests, falls deine Version es anbietet. Dann gilt das Token nur für POST-Anfragen, und genau so fragt rankion.ai an.
- Kopiere das Token sofort. Matomo zeigt es nur einmal.
Schritt 3: Bei rankion.ai eintragen
- Öffne die Seite Matomo (
/integrations/matomo).
- Trage die Adresse deiner Instanz ein, zum Beispiel
https://analytics.example.com, und das Token.
- Klicke auf Verbindung prüfen. rankion.ai fragt deine Instanz sofort ab und speichert nur, wenn sie antwortet.
- Das Token wird verschlüsselt gespeichert und nie wieder angezeigt. Änderst du später die Adresse, musst du es neu eintragen, und die Sites und Zahlen der alten Instanz werden gelöscht.
Schritt 4: Site mit Projekt verknüpfen
- Wähle unter Sites den Zeitraum für den Nachabruf (30, 90, 180 oder 365 Tage).
- Wähle bei deiner Website das Projekt und klicke auf Verknüpfen.
- Der Nachabruf läuft im Hintergrund. Du kannst die Seite verlassen; solange du sie offen hast, siehst du den Fortschritt.
Danach holt rankion.ai jede Nacht die letzten drei Tage neu.
- Besuche, Conversions und Umsatz im gewählten Zeitraum und als Verlauf.
- Besucher aus KI-Suchen: die Summe, der Anteil an allen Besuchen und die Aufteilung je Assistent.
- Matomo trennt KI-Besuche nicht in bezahlt und organisch. Die drei Kacheln aus der Google-Analytics-Ansicht fehlen deshalb.
- Ist für ein Projekt auch Google Analytics verknüpft, zeigt die Seite Google Analytics und nennt Matomo nur. Beide werden nicht addiert, weil derselbe Besuch sonst doppelt zählte.
Wenn etwas nicht klappt
| Meldung |
Was zu tun ist |
| Nur Adressen mit https |
Schreibe die Adresse mit https://. Läuft deine Instanz noch ohne Zertifikat, richte zuerst eines ein, zum Beispiel kostenlos über Let's Encrypt |
| Nur Standardport 443 |
Lass die Portangabe in der Adresse weg. Die Instanz muss über https auf Port 443 erreichbar sein |
| Der Name lässt sich nicht auflösen |
Die Adresse stimmt nicht, oder die Instanz ist nur per IPv6 erreichbar |
| Matomo hat den Zugriff abgelehnt |
Token prüfen, und ob der Benutzer die Website lesen darf |
| Dieses Token darf keine Site lesen |
Gib dem Benutzer in Matomo das Recht Ansicht und lade die Sites neu |