Ereignisschema
Ein Ereignisschema beschreibt, welche Ereignisse im Projekt ankommen sollen und mit welchen Eigenschaften: order_completed mit einem Pflichtbetrag als Zahl, currency nur EUR oder USD. OneTrace.pro gleicht jedes Ereignis mit dem Schema ab und zeigt Verstöße: einen Tippfehler im Ereignisnamen, einen Betrag als Text, eine fehlende Eigenschaft. So fallen Tracking-Fehler auf der Website oder in einer Integration sofort auf – und nicht erst, wenn ein Segment oder Bericht bereits falsch berechnet wurde.
Ein Ereignis, das gegen das Schema verstößt, wird trotzdem angenommen und gelangt ins Profil: Es gehen keine Daten verloren, selbst wenn das Schema fehlerhaft ist. Das Ereignisschema ist ab dem Tarif „Wachstum“ verfügbar.
Ereignisse beschreiben
Öffnen Sie den Datenkatalog und den Tab Ereignisschema. Das Schema ändern können Rollen mit der Berechtigung „Ereigniskatalog verwalten“ – „Manager“ und höher; alle anderen sehen das Schema und die Verstöße.
- Klicken Sie auf Aktuelle Ereignisse hinzufügen – alle Ereignisse aus dem Katalog kommen mit ihren Eigenschaften und erkannten Typen ins Schema. Oder fügen Sie Ereignisse einzeln mit Ereignis hinzufügen hinzu.
- Prüfen Sie die Eigenschaften jedes Ereignisses:
| Spalte | Was sie festlegt |
|---|---|
| Eigenschaft | Schlüssel der Eigenschaft, wie Website oder Server ihn senden, zum Beispiel amount |
| Typ | Text, Zahl, Ja/Nein, Datum und Uhrzeit, Liste oder Objekt. Datum und Uhrzeit passt auch zu einer Texteigenschaft |
| Pflicht | Ein Ereignis ohne diese Eigenschaft oder mit leerem Wert ist ein Verstoß |
| Zulässige Werte | Durch Kommas getrennt, nur bei Text und Zahlen. Ein Wert, der nicht in der Liste steht, ist ein Verstoß; Groß- und Kleinschreibung zählt: eur und EUR sind verschiedene Werte |
| Beschreibung | Für Entwickler: was die Eigenschaft bedeutet |
- Entfernen Sie Ereignisse und Eigenschaften, die nicht mehr ankommen sollen: Kommen sie doch an, ist das ein Verstoß „Ereignis nicht beschrieben“ oder „Eigenschaft nicht beschrieben“.
- Klicken Sie auf Schema speichern und schalten Sie Ereignisse anhand des Schemas prüfen ein.
Änderungen sammeln sich auf dem Bildschirm und werden gemeinsam gespeichert. Nach dem Speichern beginnen die Zähler der Verstöße von vorn: Die bisherigen gehören zum alten Schema. Ein Ereignis aus dem Schema, das noch nie angekommen ist, ist im Tab Ereignisse mit „Noch nicht empfangen“ markiert, Ereignisse des Schemas mit „Im Schema“.

Systemereignisse der Plattform ($identify, $page, $message_sent und andere) sowie identify, Seitenaufrufe und Aufrufe von App-Bildschirmen werden nicht geprüft – ihr Schema legt die Plattform fest.
Verstöße
| Verstoß | Beispiel |
|---|---|
| Ereignis nicht beschrieben | product_viewd kam statt product_viewed an |
| Eigenschaft nicht beschrieben | order_completed kam mit der Eigenschaft coupon an, die nicht im Schema steht |
| Pflichteigenschaft fehlt | add_to_cart ohne quantity |
| Falscher Typ | Der Betrag kam als Text "1250" statt als Zahl 1250 an |
| Unzulässiger Wert | currency = eur, im Schema stehen aber EUR und USD |
Die Verstöße der letzten 7 Tage stehen über der Liste der Schemaereignisse: wie oft und wann zuletzt, dazu ein Beispiel – der Typ des Werts oder der unzulässige Wert selbst. Ohne Berechtigung für personenbezogene Daten wird das Beispiel maskiert. Ist ein Ereignis wegen eines Fehlers im Schema und nicht im Tracking nicht beschrieben, klicken Sie auf Ins Schema – es wird mit den Eigenschaften aus dem Katalog in den Entwurf übernommen.
Dieselben Verstöße und ein Diagramm der Ereignisse mit Verstößen über 24 Stunden finden Sie im Bereich Diagnose.

Import, Export und API
JSON exportieren lädt das gespeicherte Schema herunter, JSON importieren lädt eine Datei in den Entwurf – prüfen und speichern Sie ihn. So übertragen Sie ein Schema zwischen Projekten: zum Beispiel auf alle Shops einer Kette oder von einem Testprojekt auf das Live-Projekt.
Über die öffentliche API lesen Sie das Schema (GET /api/v1/event-schema) und ersetzen es vollständig (PUT /api/v1/event-schema, Schlüsselberechtigung „Ereignisschema ändern“); die Verstöße der letzten Woche liefert die Anfrage GET /api/v1/event-schema/violations. Datei und API haben dasselbe Format:
{
"enabled": true,
"events": [
{
"name": "order_completed",
"label": "Bestellung abgeschlossen",
"properties": [
{ "key": "amount", "type": "number", "required": true },
{ "key": "currency", "type": "string", "required": true, "values": ["EUR", "USD"] }
]
}
]
}
Ereignisse, die im Dokument fehlen, verlassen das Schema, bleiben aber mit ihren Bezeichnungen und Statistiken im Datenkatalog. Ein Dokument ohne events schaltet nur die Prüfung ein oder aus.