Craft-CMS-Plugin

MetriXs bietet ein erstklassiges Craft-CMS-Plugin, das den Tracker auf jede Seite Ihrer Website setzt, Ihre Website automatisch verifiziert und strikt Opt-in bleibt: Es wird nichts geladen, bis Sie es verbinden. Keine Theme-Bearbeitung, keine Twig-Snippets, kein Consent-Banner.

Diese Anleitung führt durch das komplette Setup.

Bevor Sie starten

Sie brauchen ein MetriXs-Konto. Das Plugin selbst ist kostenlos und voll funktionsfähig; der kostenlose MetriXs-Plan reicht für den Einstieg.

1. Gehen Sie zu app.metrixs.eu und registrieren Sie sich
2. Bestätigen Sie Ihre E-Mail-Adresse über den Link, den Sie erhalten

Schritt 1: Website in MetriXs anlegen

1. Melden Sie sich im MetriXs-Dashboard an
2. Legen Sie während des Onboardings (oder unter Einstellungen → Websites) die Domain Ihrer Website an, z. B. yourdomain.com — ohne https:// und ohne www.
3. Überspringen Sie die vorgeschlagene manuelle Snippet-Verifizierung — das Plugin verifiziert Ihre Website automatisch in Schritt 4
4. Starten Sie bei Bedarf eine Testphase oder wählen Sie den Gratisplan (Events erfordern einen aktiven Plan)

Schritt 2: Site-API-Key erstellen

Das Plugin authentifiziert sich mit einem site-spezifischen API-Key. Er gewährt nur Zugriff auf diese eine Website (stats:read + event:write), nie auf Ihr Konto, und ist jederzeit widerrufbar.

1. Gehen Sie im Dashboard zu Einstellungen → Websites
2. Klappen Sie Ihre Website auf und finden Sie den Bereich API-Keys
3. Klicken Sie auf Create API key und benennen Sie ihn, z. B. „Craft“
4. Kopieren Sie den Key (mtx_live_...) sofort — er wird nur einmal angezeigt und kann später nicht mehr abgerufen werden

Schritt 3: Plugin installieren

Installation über Composer im Craft-Projektstammverzeichnis:

composer require metrixs/mx-cookieless-analytics

oder installieren Sie es aus dem Plugin Store in der Craft-Kontrollzentrale.

Dann das Plugin selbst aktivieren:

php craft plugin/install mx-cookieless-analytics

Schritt 4: Plugin konfigurieren

Gehen Sie in der Kontrollzentrale zu Einstellungen → Plugins → MX Cookieless Analytics:

Feld	Eingabe
Enable tracking	Vorerst aus — nach der Verifizierung einschalten
Site API key	Der Key aus Schritt 2
MetriXs URL	Standard https://app.metrixs.eu lassen
Site domain	Leer lassen für automatische Erkennung über die primäre Website-URL
Exclude admins	Standardmäßig an — Nutzer mit Admin-Zugriff zählen nicht

Klicken Sie auf Speichern. Das Plugin verifiziert Ihre Website automatisch mit demselben Speichervorgang — Sie sehen die grüne Bestätigung „site verified“ (oder eine Fehlermeldung mit Hinweisen). Schalten Sie Enable tracking ein und speichern Sie erneut.

Schritt 5: Tracking prüfen

1. Öffnen Sie Ihre Website in einem Inkognito-Fenster und surfen Sie ein paar Seiten an
2. Prüfen Sie im MetriXs-Dashboard die Realtime-Ansicht — Pageviews sollten binnen Sekunden erscheinen

Hinweis: Nutzer mit Admin-Zugriff sind standardmäßig ausgeschlossen. Reguläre eingeloggte Nutzer werden getrackt. Testen Sie im Inkognito-Modus oder passen Sie den Ausschluss in den Plugin-Einstellungen an.

So funktioniert die Verifizierung: Das Plugin fragt die MetriXs-API nach einem Einmal-Challenge-Token, serviert ihn über Ihre eigene Domain und die API holt ihn zurück. Nur wer Ihre Domain kontrolliert, kann den Token servieren — das beweist das Eigentum Der Token wird nach abgeschlossenem Handshake wieder entfernt.

Einstellungsreferenz

Einstellung	Standard	Bedeutung
Enable tracking	Aus	Hauptschalter — nichts lädt, bis die Website verbunden ist und dies an ist
Site API key	—	Site-spezifischer Key aus dem Dashboard
MetriXs URL	https://app.metrixs.eu	Nur bei eigenen Endpoints ändern (nur HTTPS)
Site domain	Leer (auto)	Muss der Domain in MetriXs entsprechen
Exclude admins	An	Nutzer mit Admin-Zugriff nicht tracken

Der Tracker-Skript wird von app.metrixs.eu mit versionierter URL geladen, über die Craft-Asset-Pipeline im Seitenkopf registriert und asynchron (defer) geladen. Er arbeitet problemlos neben Caching- und CDN-Setups.

Fehlerbehebung

Verifizierung schlägt fehl

• Stellen Sie sicher, dass Ihre Website öffentlich über HTTPS erreichbar ist (kein Wartungsmodus, keine Firewall, die die MetriXs-Server blockt)
• Speichern Sie die Plugin-Einstellungen erneut — der Handshake läuft bei jedem Speichern

Keine Daten im Dashboard

• Die Plugin-Einstellungen müssen die „site verified“-Bestätigung gezeigt haben
• Enable tracking muss eingeschaltet sein
• Die Website-Domain muss exakt der Domain in MetriXs entsprechen (ohne www., ohne https://)
• Sie sind als Admin eingeloggt? Standardmäßig ausgeschlossen — Inkognito testen

API-Key verloren Keys sind nach der Erstellung nicht abrufbar. Widerrufen Sie den alten Key im Dashboard (Einstellungen → Websites → API-Keys), erstellen Sie einen neuen und tragen Sie ihn im Plugin ein.

Konfiguration ohne Kontrollzentrale Die Auto-Verifizierung läuft beim Speichern einer Einstellung. Wenn Sie die Kontrollzentrale lieber nicht nutzen, installieren Sie das Plugin trotzdem und verifizieren Sie Ihre Website manuell: Das Dashboard zeigt Ihr Snippet, und MetriXs bestätigt das Eigentum, indem es es auf Ihrer Website erkennt.

Deinstallation

Beim Entfernen des Plugins:

• Ihre Website wird nicht automatisch in MetriXs getrennt — widerrufen Sie den API-Key im Dashboard (Einstellungen → Websites → API-Keys), um die Erfassung zu stoppen
• Ihre historischen Daten bleiben in Ihrem MetriXs-Konto

Ohne Plugin bevorzugt?

Sie können den Tracker jederzeit manuell mit dem Snippet aus den Plattform-Guides hinzufügen — das Plugin automatisiert nur Installation und Verifizierung.