Matomo einrichten
So aktivierst du eine datenschutzkonforme Matomo-Analyse auf deiner Webseite. Besucher:innen sehen zuerst ein Einwilligungsbanner — Tracking startet erst nach ihrer Zustimmung.
Voraussetzungen
- Eine laufende Matomo-Instanz mit URL und Site-ID
- Eine Datenschutzerklärung, auf die aus dem Banner verlinkt werden kann
Funktion aktivieren
Easy Mode
Ergänze die drei Matomo-Parameter in der .gitlab-ci.yml:
Developer Mode
Ergänze den matomo-Block in der theme.config.tsx:
Das Banner wird automatisch auf jeder Seite eingebunden — es ist keine weitere Komponente einzubauen.
Was Besucher:innen sehen
Beim ersten Seitenaufruf erscheint ein Banner am unteren Bildschirmrand mit zwei Optionen:
- Alle akzeptieren — Matomo wird geladen, die Entscheidung wird ein Jahr lang in einem Cookie gespeichert, danach wird jeder Seitenaufruf getrackt, auch bei Navigation ohne vollständiges Neuladen der Seite.
- Statistik-Cookies ablehnen — es wird nichts von Matomo geladen und keine Daten gesendet.
Vor einer Zustimmung wird keine Verbindung zur Matomo-Instanz aufgebaut.
Einwilligung ändern oder widerrufen
Nach der Entscheidung bleibt ein kleines Cookie-Symbol unten rechts sichtbar. Ein Klick darauf öffnet das Banner erneut, sodass Besucher:innen ihre Entscheidung jederzeit ändern können (DSGVO-freundlich). Wird eine bereits erteilte Einwilligung widerrufen, entfernt die Seite die gesetzten Matomo-Cookies und lädt neu.
Ergebnis prüfen
Starte den Entwicklungsserver mit npm run dev (Developer Mode) oder löse die Pipeline aus (Easy Mode) und öffne die Seite in einem privaten Fenster. Das Einwilligungsbanner sollte erscheinen.
Nächste Schritte
- Theme-Konfiguration — der
matomo-Block in der Gesamtkonfiguration - CI/CD-Komponenten — alle Easy-Mode-Parameter