The website sends no data („unknown key“)

Area: Tracking snippet · Updated: 31 Oct 2026 · Auf Deutsch · All articles

Symptoms

  • Einstellungen › Einbau & Status shows „Noch kein Besuch angekommen“, „Seit einer Weile keine Daten“ or „Tracking stockt“.
  • Hint: „Seit 5 Std. keine Besuche angekommen. Einbau prüfen.“
  • Open item: „Noch kein Seitenaufruf angekommen.“ or „Seit über 7 Tagen keine Daten (zuletzt …)“.
  • The browser gets {\"error\":\"unknown key\"} from /v1/c/… or /v1/hb/…; the console shows „[3x] init: invalid publishable key“.
  • With debug: true the console shows „[3x] waiting for consent“, „[3x] opted out“ or „[3x] Do Not Track“.

Cause

  • The install code is not (any more) on the page, or the change is not published.
  • The publishable key (pk_3x_…) is wrong, belongs to another project, was revoked or expired. After revoking, the website stops counting within a minute.
  • Consent: in the mode „Erst nach Einwilligung zählen“ the SDK sends nothing before consent; if the cookie banner is not connected, nothing ever arrives („In 24 h hat niemand eingewilligt“).
  • The address is not an allowed origin (see related articles).
  • An ad blocker blocks the API address; the proxy over your own domain helps.

How to fix it

1. Look at the health

  • In the dashboard: Einstellungen › Einbau & Status › Zustand
  • With Claude (MCP): setup_status {"project":"my-shop"}

Open items name cause and fix (e.g. no_pageview, origin_rejected, consent_never_granted).

2. Let X3 check the website

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

Checks allowed address, reachability, install code on the page, the right project key, proxy, security policy (CSP) and whether data arrived in 10 minutes; at most 10 checks per minute.

3. Check the publishable key

  • In the dashboard: Einstellungen › Schlüssel › Öffentlicher Schlüssel
  • With Claude (MCP): publishable_keys_list {"project":"my-shop"}

If it says „widerrufen“, „abgelaufen“ or „Kein öffentlicher Schlüssel“: create one under Neuer Schlüssel (MCP publishable_keys_create, owner or admin) and replace it in the install code.

4. Renew the key if it got into the wrong hands

  • In the dashboard: Einstellungen › Schlüssel › Öffentlicher Schlüssel › Erneuern › Ja, erneuern
  • With Claude (MCP): publishable_keys_roll {"project":"my-shop","key_id":"… id from publishable_keys_list"}
  • Renewing and revoking over MCP (publishable_keys_roll, publishable_keys_revoke) exist since the update of 31 Oct 2026.

Careful: afterwards the install code on every website and in every app needs the new key (step 5), otherwise X3 counts nothing there. The old key stays valid for 7 days. Without confirm: true Claude only shows the warning and changes nothing. Revoking (publishable_keys_revoke) stops the key at once; the last active key cannot be revoked, only renewed.

5. Get the install code again

  • In the dashboard: Einstellungen › Einbau & Status › Alle Einbau-Varianten, Proxy und Live-Prüfung
  • With Claude (MCP): setup_generate_snippet {"project":"my-shop","framework":"next-app"}

Returns the code with the project's real key. Exactly one tracker per page.

  • In the dashboard: Einstellungen › Einbau & Status › Wo gezählt wird › Ändern › Einwilligung
  • With Claude (MCP): project_get {"project":"my-shop"}

tracking.consent.mode require means: without consent X3 counts nothing. The site owner decides the mode; change it only after their choice (project_update_tracking_config).

7. Send a test visit and watch it

  • In the dashboard: Live-Prüfung › Testbesuch senden
  • With Claude (MCP): events_tail {"project":"my-shop","include_test":true,"wait_s":20}

How to tell it worked

  • Einstellungen › Einbau & Status shows „Tracking läuft“.
  • events_tail shows the test visit with pageview; setup_verify_installation reports „Daten angekommen (10 Min.)“.