WordPress-Plugin

MetriXs bietet ein offizielles WordPress-Plugin, das den Tracker zu jeder Seite hinzufuegt, Ihre Seite automatisch verifiziert und WooCommerce-Umsaetze serverseitig erfassen kann. Kein Child-Theme, keine Codebearbeitung, kein Cookie-Banner.

Diese Anleitung fuehrt Schritt fuer Schritt durch die komplette Einrichtung.

Bevor Sie beginnen

Sie benoetigen ein MetriXs-Konto. Das Plugin selbst ist kostenlos und voll funktionsfaehig; der kostenlose MetriXs-Tarif reicht fuer den Anfang.

1. Gehen Sie zu app.metrixs.eu und registrieren Sie sich
2. Verifizieren Sie Ihre E-Mail-Adresse ueber den erhaltenen Link

Schritt 1: Seite in MetriXs hinzufuegen

1. Melden Sie sich im MetriXs-Dashboard an
2. Waehrend des Onboardings (oder ueber Settings → Sites) fuegen Sie die Domain Ihrer Seite hinzu, z. B. ihredomain.de — ohne https:// und ohne www.
3. Ueberspringen Sie den Snippet-Verifizierungsschritt, den das Dashboard vorschlaegt — das Plugin verifiziert Ihre Seite in Schritt 5 automatisch
4. Starten Sie bei Bedarf eine Testphase oder waehlen Sie den kostenlosen Tarif (Events erfordern einen aktiven Tarif)

Schritt 2: Site-API-Key erstellen

Das Plugin authentifiziert sich mit einem site-bezogenen API-Key. Er gewaehrt nur Zugriff auf diese eine Seite (stats:read + event:write), niemals auf Ihr Konto, und kann jederzeit widerrufen werden.

1. Gehen Sie im Dashboard zu Settings → Sites
2. Klappen Sie Ihre Seite aus und suchen Sie den Abschnitt API keys
3. Klicken Sie auf Create API key und vergeben Sie einen Namen, z. B. “WordPress”
4. Kopieren Sie den Key (mtx_live_...) sofort — er wird nur einmal angezeigt und kann spaeter nicht mehr abgerufen werden

Schritt 3: Plugin installieren

Ueber Ihr WordPress-Admin:

1. Gehen Sie zu Plugins → Neue Plugins
2. Suchen Sie nach “MetriXs Analytics”
3. Klicken Sie auf Jetzt installieren und danach auf Aktivieren

Schritt 4: Plugin konfigurieren

Gehen Sie zu Einstellungen → MetriXs Analytics:

Feld	Was eintragen
Site domain	Meistens bereits mit dem Hostnamen Ihrer Seite ausgefuellt; muss der in MetriXs registrierten Domain entsprechen
MetriXs URL	Lassen Sie den Standard https://app.metrixs.eu stehen
Site API key	Der Key aus Schritt 2

Klicken Sie auf Aenderungen speichern.

Schritt 5: Verbinden und verifizieren

Dies ersetzt die manuelle Verifizierung und muss nur einmal durchgefuehrt werden.

1. Klicken Sie auf derselben Einstellungsseite auf Connect & verify site
2. Sie sollten die gruene Meldung “Site connected. Tracking is live” sehen
3. Im MetriXs-Dashboard erscheint Ihre Seite jetzt als Verified

So funktioniert es: Das Plugin fordert ein einmaliges Challenge-Token von der MetriXs-API an, stellt es von Ihrer eigenen Domain bereit, und die API ruft es wieder ab. Nur wer Ihre Domain kontrolliert, kann das Token bereitstellen — so wird der Besitz nachgewiesen.

Schritt 6: Tracking pruefen

1. Oeffnen Sie Ihre Seite in einem Inkognito-/Privatfenster und besuchen Sie einige Seiten
2. Oeffnen Sie das MetriXs-Dashboard und pruefen Sie die Realtime-Ansicht — Seitenaufrufe sollten innerhalb von Sekunden erscheinen

Hinweis: Angemeldete Administratoren sind standardmaessig vom Tracking ausgeschlossen (Sie moechten sich selbst meist nicht zaehlen). Testen Sie ueber ein Inkognitofenster oder passen Sie die Ausschluesse in den Plugin-Einstellungen an.

WooCommerce (optional)

Wenn Sie WooCommerce nutzen, aktivieren Sie die Umsatzmessung:

1. Speichern Sie zuerst Ihren API-Key (Schritt 4)
2. Aktivieren Sie auf der Plugin-Einstellungsseite die Option WooCommerce
3. Speichern und erneut auf Connect & verify site klicken — dies aktiviert Commerce fuer die Seite in MetriXs
4. Platzieren Sie eine Testbestellung zur Bestaetigung

Nach der Aktivierung zeigt das MetriXs-Dashboard:

• Umsatz, durchschnittlichen Bestellwert und Konversionsrate
• Den Konversions-Trichter: Besucher → Checkout → Zahlung → Bestellung
• Top-Produkte nach Umsatz

Die Events werden serverseitig von Ihrem WordPress-Server gesendet, sodass redirect-basierte Zahlungsmethoden (iDEAL, Bancontact usw.) zuverlaessig erfasst werden. Umsaetze werden automatisch in EUR umgerechnet (taegliche ECB-Kurse) und in Ihrer gewaehlten Anzeige-Waehrung dargestellt.

Einstellungs-Uebersicht

Einstellung	Standard	Bedeutung
Site domain	Hostname Ihrer Seite	Muss der Domain in MetriXs entsprechen
MetriXs URL	https://app.metrixs.eu	Nur fuer custom Endpoints aendern
Site API key	—	Site-bezogener Key aus dem Dashboard
Exclude all logged-in visitors	Aus	Niemand tracken, der angemeldet ist
Exclude roles	Administrator an	Legen Sie fest, welche Rollen ausgeschlossen werden
WooCommerce	Aus	Serverseitige Commerce-Events

Entwickler koennen auch die Filter metrixs_settings, metrixs_script_attributes und metrixs_exclude_visitor verwenden oder METRIXS_DISABLE_TRACKING (z. B. auf Staging-Seiten) in der wp-config.php definieren.

Problemloesung

Verifizierung schlaegt fehl

• Pruefen Sie, ob Ihre Permalinks nicht auf “Plain” stehen (Einstellungen → Permalinks — waehlen Sie eine andere Struktur und speichern Sie; die Verifizierungsroute benoetigt auf manchen Setups schoene Permalinks)
• Stellen Sie sicher, dass Ihre Seite oeffentlich erreichbar ist (kein Wartungsmodus, keine Firewall, die die MetriXs-Server blockiert)
• Warten Sie eine Minute und versuchen Sie es erneut

Keine Daten im Dashboard

• Die Einstellungsseite muss “Connected” anzeigen
• Die Domain im Plugin muss exakt der Domain in MetriXs entsprechen (kein www., kein https://)
• Als Administrator angemeldet? Sie sind standardmaessig ausgeschlossen — testen Sie inkognito
• Nutzen Sie ein Caching-Plugin? Leeren Sie den Cache, damit der Tracker auf Ihren Seiten landet

API-Key verloren Keys koennen nach der Erstellung nicht abgerufen werden. Widerrufen Sie den alten im Dashboard (Settings → Sites → API keys), erstellen Sie einen neuen und tragen Sie ihn in den Plugin-Einstellungen ein.

Deinstallation

Beim Deaktivieren und Loeschen des Plugins:

• Ihre Seite wird automatisch in MetriXs getrennt (Events werden nicht mehr akzeptiert)
• Ihre historischen Daten bleiben in Ihrem MetriXs-Konto erhalten
• Die Optionen des Plugins werden aus Ihrer WordPress-Datenbank entfernt

Lieber ohne Plugin?

Sie koennen den Tracker jederzeit manuell mit dem Snippet aus den Plattform-Anleitungen hinzufuegen — das Plugin automatisiert nur Installation, Verifizierung und WooCommerce-Tracking.