Die Website sendet keine Daten („unknown key“)

Bereich: Tracking-Snippet · Stand: 31.10.2026 · In English · Alle Artikel

Symptome

  • Einstellungen › Einbau & Status zeigt „Noch kein Besuch angekommen“, „Seit einer Weile keine Daten“ oder „Tracking stockt“.
  • Hinweis: „Seit 5 Std. keine Besuche angekommen. Einbau prüfen.“
  • Offener Punkt: „Noch kein Seitenaufruf angekommen.“ oder „Seit über 7 Tagen keine Daten (zuletzt …)“.
  • Der Browser bekommt von /v1/c/… oder /v1/hb/… die Antwort {\"error\":\"unknown key\"}; die Konsole zeigt „[3x] init: invalid publishable key“.
  • Mit debug: true zeigt die Konsole „[3x] waiting for consent“, „[3x] opted out“ oder „[3x] Do Not Track“.

Ursache

  • Der Einbau-Code ist nicht (mehr) auf der Seite oder die Änderung ist nicht veröffentlicht.
  • Der öffentliche Schlüssel (pk_3x_…) ist falsch, gehört zu einem anderen Projekt, wurde widerrufen oder ist abgelaufen. Nach dem Widerrufen zählt die Website binnen einer Minute nicht mehr.
  • Einwilligung: im Modus „Erst nach Einwilligung zählen“ sendet das SDK vor der Zustimmung nichts; ist der Cookie-Banner nicht angebunden, kommt nie etwas an („In 24 h hat niemand eingewilligt“).
  • Die Adresse ist keine erlaubte Herkunft (siehe verwandte Artikel).
  • Ein Werbeblocker blockiert die API-Adresse; dann hilft der Proxy über die eigene Domain.

So löst Du das

1. Zustand ansehen

  • Im Dashboard: Einstellungen › Einbau & Status › Zustand
  • Mit Claude (MCP): setup_status {"project":"mein-shop"}

Die offenen Punkte nennen Ursache und Lösung (z. B. no_pageview, origin_rejected, consent_never_granted).

2. Website prüfen lassen

  • Im Dashboard: Einstellungen › Einbau & Status › Alle Einbau-Varianten, Proxy und Live-Prüfung › Website jetzt prüfen
  • Mit Claude (MCP): setup_verify_installation {"project":"mein-shop","url":"https://www.example.com"}

Prüft Adresse erlaubt, Website erreichbar, Tracking-Code auf der Seite, richtiger Projekt-Schlüssel, Proxy, Sicherheitsrichtlinie (CSP) und ob in 10 Minuten Daten angekommen sind; höchstens 10 Prüfungen pro Minute.

3. Öffentlichen Schlüssel prüfen

  • Im Dashboard: Einstellungen › Schlüssel › Öffentlicher Schlüssel
  • Mit Claude (MCP): publishable_keys_list {"project":"mein-shop"}

Steht dort „widerrufen“, „abgelaufen“ oder „Kein öffentlicher Schlüssel“: unter Neuer Schlüssel einen anlegen (MCP publishable_keys_create, Inhaber oder Admin) und im Einbau-Code ersetzen.

4. Schlüssel erneuern, wenn er in falsche Hände geraten ist

  • Im Dashboard: Einstellungen › Schlüssel › Öffentlicher Schlüssel › Erneuern › Ja, erneuern
  • Mit Claude (MCP): publishable_keys_roll {"project":"mein-shop","key_id":"… id aus publishable_keys_list"}
  • Erneuern und Widerrufen per MCP (publishable_keys_roll, publishable_keys_revoke) gibt es seit dem Update vom 31.10.2026.

Achtung: danach muss der Einbau-Code auf jeder Website und in jeder App den neuen Schlüssel bekommen (Schritt 5), sonst zählt X3 dort nichts mehr. Der alte Schlüssel gilt noch 7 Tage. Ohne confirm: true zeigt Claude nur die Warnung und ändert nichts. Widerrufen (publishable_keys_revoke) stoppt den Schlüssel sofort; den letzten aktiven Schlüssel kann man nicht widerrufen, nur erneuern.

5. Einbau-Code neu holen

  • Im Dashboard: Einstellungen › Einbau & Status › Alle Einbau-Varianten, Proxy und Live-Prüfung
  • Mit Claude (MCP): setup_generate_snippet {"project":"mein-shop","framework":"next-app"}

Liefert den Code mit dem echten Schlüssel des Projekts. Genau einen Tracker pro Seite einbauen.

6. Einwilligung prüfen

  • Im Dashboard: Einstellungen › Einbau & Status › Wo gezählt wird › Ändern › Einwilligung
  • Mit Claude (MCP): project_get {"project":"mein-shop"}

tracking.consent.mode require heißt: ohne Zustimmung zählt X3 nichts. Den Modus entscheidet der Websitebetreiber; ändern nur nach seiner Wahl (project_update_tracking_config).

7. Testbesuch senden und beobachten

  • Im Dashboard: Live-Prüfung › Testbesuch senden
  • Mit Claude (MCP): events_tail {"project":"mein-shop","include_test":true,"wait_s":20}

Woran Du siehst, dass es geklappt hat

  • Einstellungen › Einbau & Status zeigt „Tracking läuft“.
  • events_tail zeigt den Testbesuch mit pageview; setup_verify_installation meldet „Daten angekommen (10 Min.)“.

Verwandte Artikel