Datenqualität und Fehlersuche
Was bedeuten die Fehlercodes?
Jede Ablehnung trägt einen Code, dazu Titel, Erklärung, Datenauswirkung und Lösungsschritte. Diese Tabelle listet alle Codes des Collectors und der Verarbeitung mit ihrer Bedeutung.
Der Collector antwortet mit einem Code. Was heißt er?
| Code | Bedeutung | Was tun |
|---|---|---|
| SCHEMA_INVALID | Pflichtfeld fehlt oder Format ungültig | Event gegen das Schema prüfen; die Antwort nennt das Feld |
| EVENT_TOO_OLD | Zeitstempel älter als 30 Tage | Ereignisse zeitnah senden; Nachlieferungen sind begrenzt |
| EVENT_IN_FUTURE | Zeitstempel mehr als 5 Minuten in der Zukunft | Uhrzeit des sendenden Systems prüfen |
| PII_DETECTED | E-Mail-Adresse oder Telefonnummer im Klartext; gespeichert wird nur, welches Feld betroffen war | Feld entfernen oder vorher pseudonymisieren; Antwort und Befund nennen das Feld |
| CONSENT_MISSING | keine passende Einwilligung | Consent-Zustand korrekt mitgeben; das abgewiesene Ereignis ist nicht gespeichert |
| CONSENT_WITHDRAWN | die Einwilligung dieses Browsers wurde widerrufen; nichts gespeichert | nichts; so gewollt. Willigt die Person erneut ein, läuft die Messung weiter |
| SUBJECT_SUPPRESSED | ein Merkmal steht auf der Sperrliste (Widerspruch oder Löschung); nichts gespeichert | nichts; so gewollt. Willigt die Person erneut ein, die Sperre unter „Datenschutz“ aufheben |
| DUPLICATE_EVENT | Event-ID bereits vorhanden | kein Fehler; die Wiederholung wurde erkannt |
| WRITE_KEY_INVALID | Schlüssel unbekannt oder widerrufen | Schlüssel in der Einrichtung prüfen |
| SERVER_KEY_INVALID | Serverschlüssel unbekannt, widerrufen oder abgelaufen; oder ein Schreibschlüssel auf dem Serverweg | in der Einrichtung, Reiter „Server Events API“, einen Serverschlüssel anlegen oder neu erzeugen |
| SITE_UNKNOWN | Site-ID gehört nicht zum Schlüssel | Site-ID prüfen |
| TOKEN_INVALID | Token eines Trackingelements unbekannt, widerrufen oder verändert | Trackingelement neu erzeugen und den Code im Werbemittel tauschen |
| DOMAIN_NOT_ALLOWED | Herkunft nicht freigegeben | Domain in der Einrichtung ergänzen |
| SIGNATURE_INVALID | Signatur passt nicht zum Body | rohen Body signieren, nicht den umformatierten |
| REPLAY_DETECTED | Signatur bereits verwendet | je Anfrage neu signieren |
| PAYLOAD_TOO_LARGE | Anfrage zu groß | Batch verkleinern, Metadaten kürzen |
| RATE_LIMITED | zu viele Anfragen | Sendefrequenz drosseln, Events bündeln |
| QUOTA_EXCEEDED | Eventkontingent des Monats im Tarif Start erschöpft; weitere Events werden bis zum Monatswechsel nicht gespeichert | in einen größeren Tarif wechseln oder an den Support wenden |
| INDIVIDUAL_TARIFF_REQUIRED | mehr Events im Monat, als der höchste öffentliche Tarif abdeckt; ohne Zustimmung zum Individualtarif wird nichts mehr gespeichert | unter „Tarif & Verbrauch“ dem Individualtarif zustimmen |
| TENANT_INACTIVE | das Konto ist gesperrt, meist wegen einer offenen Zahlung; nichts wird angenommen | offene Rechnung im Portal bezahlen, sonst an den Support wenden |
| SITE_PAUSED | die Website ruht, weil der Tarif weniger Websites trägt, als angelegt sind | in einen Tarif mit mehr Websites wechseln oder den Support bitten, die Websites zu tauschen |
| IMPRESSIONS_NOT_IN_PLAN | Impression-Pixel oder Viewability-Tag im kostenlosen Tarif Start; Impressionen und Sichtbarkeit werden erst ab Pro gespeichert | in den Tarif Pro oder höher wechseln oder Pixel und Tag aus den Werbemitteln nehmen |
| PROCESSING_AGREEMENT_MISSING | kein Auftragsverarbeitungsvertrag abgeschlossen; es wird nichts angenommen | AVV im Portal unter „Datenschutz“ oder in der Shopify-App abschließen |
| REFUND_WITHOUT_PURCHASE | Erstattung angenommen, aber 24 Stunden lang kein Kauf mit derselben Bestellnummer, Umgebung und Währung, daher nicht verbucht und gelöscht. Ein Zähler je Website und Tag unter „Datenstatus“, ohne Bestellnummer, keine Antwort des Collectors | Bestellnummer, Umgebung und Währung von Kauf und Erstattung vergleichen; danach mit neuer event_id erneut senden |
| ORDER_ALREADY_COUNTED | dieselbe Bestellnummer kam in derselben Website mehr als einmal als Kauf an; gezählt ist sie einmal, mit dem Wert der ersten Servermeldung, ohne sie mit dem der ersten Browsermeldung. Ein Befund der Verarbeitung unter „Datenstatus“, keine Antwort des Collectors | bei Browser und Server zugleich nichts; sonst prüfen, ob eine Wiederholung eine neue event_id bekommt |
| ORDER_VALUE_FROM_SERVER | erst kam der Kauf aus dem Browser, dann von deinem Server mit anderem Wert oder anderer Währung; Metrunio hat Wert und Währung vom Server übernommen, Kunde und Kontakte bleiben aus dem Browser. Ein Befund der Verarbeitung unter „Datenstatus“, keine Antwort des Collectors | prüfen, ob das Tracking-Skript denselben Betrag meldet wie der Shop; liegt der Browserwert weit daneben, kann jemand die Bestellnummer vorweg gemeldet haben |
Zu jedem Code gibt es eine eigene Seite unter /hilfe/fehlercodes/<code>, mit dem Code in Kleinschreibung, also etwa /hilfe/fehlercodes/domain_not_allowed. Sie nennt Ursache, Auswirkung, die Schritte zur Behebung und den HTTP-Status, mit dem der Collector antwortet. Jeder Befund im Portal verlinkt direkt dorthin.
Als Telefonnummer gilt bei PII_DETECTED eine Ziffernfolge mit Ländervorwahl (+49 30 …) oder mit Trennzeichen zwischen den Blöcken (030-1234 5678). Reine Ziffernfolgen und Kennungen im UUID-Format bleiben erlaubt: Bestellnummern, Produkt-IDs, Zeitstempel und UUIDs in einer Adresse führen nicht zur Ablehnung.
Hinweis
DUPLICATE_EVENT ist kein Problem, sondern der Beleg dafür, dass Idempotenz wirkt: Ein wiederholt gesendetes Event wird erkannt und nicht doppelt gezählt.
Zuletzt geprüft am 17.10.2026
Ebenfalls gefragt
- SCHEMA_INVALID
- PII_DETECTED
- RATE_LIMITED
- DOMAIN_NOT_ALLOWED
- CONSENT_MISSING
- QUOTA_EXCEEDED
- PROCESSING_AGREEMENT_MISSING
- REFUND_WITHOUT_PURCHASE
- ORDER_ALREADY_COUNTED
- ORDER_VALUE_FROM_SERVER
- SERVER_KEY_INVALID
- Fehlercode nachschlagen
- Passende Anleitung öffnen
- Was gilt als Telefonnummer?
- PII_DETECTED, obwohl keine Telefonnummer im Event steht
Weiterführende Artikel
- Warum werden meine Events abgelehnt?
Der Collector nimmt Events nicht an. Wie finde ich die Ursache?
Die Antwort des Collectors nennt zu jedem Event den Status und im Fehlerfall den Grund. Prüfe zuerst diese Antwort; „Datenstatus“ im Portal fasst die Gründe zusätzlich über den Zeitraum zusammen.
- Warum muss ich Domains freigeben?
Was bedeutet DOMAIN_NOT_ALLOWED und wie ergänze ich eine Domain?
Der Schreibschlüssel ist im Quelltext sichtbar; damit ihn keine fremde Website im Browser ihrer Besucher verwenden kann, prüft der Collector die Herkunft der Anfrage. Steht die Domain nicht in der Liste der erlaubten Domains, wird das Event mit DOMAIN_NOT_ALLOWED abgewiesen. Eine Anfrage außerhalb eines Browsers hält diese Prüfung nicht ab, deshalb meldest du Käufe am besten zusätzlich über deinen Server.
- Was passiert ohne Einwilligung?
Wird ohne Consent wirklich nichts gespeichert?
Standardmäßig speichert Metrunio ohne passende Einwilligung nichts, auch kein Rohereignis, und das Tracking-Skript sendet vor der Entscheidung nichts. Ein beschriebener Fall weicht ab: Kauf und Erstattung, die dein Server ohne Einwilligung meldet, zählen zur Umsatzabstimmung im Umsatz, mit Bestellnummer und ohne Browser-, Kunden- und Werbekennungen, und werden nicht zugeordnet. Das gilt nach einer Ablehnung nur mit aktivierter Zusatzweisung. Die Klickweiterleitung gibt ohne Einwilligung der Werbeseite nur die Kampagne mit, keine Klickkennung.
- Wie schließe ich den Auftragsverarbeitungsvertrag ab?
Wie schließe ich den AVV mit Metrunio ab, und warum wird vorher nichts gemessen?
Für jedes Konto gilt: Gemessen wird erst, wenn der Auftragsverarbeitungsvertrag (AVV) abgeschlossen ist; bis dahin nimmt Metrunio nichts an und speichert nichts. Du schließt ihn im Portal unter „Datenschutz“ oder im Einrichtungsschritt „AVV abschließen“ ab, bei einem Shopify-Shop auch direkt in der App: Firma, Anschrift und die abschließende Person eintragen, die Berechtigung bestätigen, fertig. Wenige Sekunden danach kommen Daten an, ohne dass du am Einbau etwas änderst.
- Wie kommen Erstattungen in Metrunio an?
Wie melde ich eine Erstattung, und woran sehe ich, dass sie verbucht ist?
Dein Shop-Server meldet eine Erstattung über die Server Events API als
refund, mit derselben Bestellnummer, Umgebung und Währung wie der Kauf. Metrunio mindert damit den Wert dieser Bestellung. Findet es 24 Stunden lang keinen passenden Kauf, verbucht es die Erstattung nicht und löscht sie. Unter „Datenstatus“ zählt der Befund REFUND_WITHOUT_PURCHASE dann je Website und Tag, wie viele es waren, ohne Bestellnummer.