Ereignisse und Ereigniskatalog

Ein Ereignis ist eine Aktion eines Kunden oder des Systems: Seitenaufruf, Hinzufügen zum Warenkorb, Bestellung, Öffnen einer E-Mail. Aus Ereignissen entstehen Profile, Segmente, Journey-Trigger und Berichte. Unter Daten → Ereignisse sehen Sie, was gerade im Projekt ankommt, unter Daten → Katalog, welche Ereignisse und Merkmale es überhaupt gibt und wie sie beschriftet sind.

Beide Bereiche stehen allen Projektmitgliedern offen. Bezeichnungen, Typen und PII-Kennzeichnungen im Katalog ändern können „Inhaber“, „Administrator“ und „Manager“.

Woher Ereignisse kommen

Quelle	Was sie überträgt
Tracker auf der Website	Seitenaufrufe, Produktaktionen, Anmeldung – siehe Website anbinden
API von Ihrem Server oder Ihrer App	Bestellungen, Registrierungen, Statusänderungen – siehe Serverseitige Integration
Import und Datenquellen	Profile aus CSV, Dateien, S3 und Google Sheets – siehe Dateiimport und Datenquellen
Umzug von einer anderen Plattform	Verlauf von Profilen und Ereignissen – siehe Umzug von anderen Plattformen
OneTrace.pro selbst	Segmenteintritte, Journey-Schritte, Versand und Öffnen von Nachrichten, An- und Abmeldungen

Ereignisse werden wenige Sekunden nach dem Senden verarbeitet. Eine Wiederholung eines Ereignisses mit derselben messageId innerhalb von 24 Stunden wird verworfen. Liegt der Zeitpunkt eines Ereignisses mehr als eine Stunde in der Zukunft, wird er durch den Empfangszeitpunkt ersetzt. Die Anzahl der Ereignisse pro Monat ist durch den Tarif des Projekts begrenzt – siehe Projekteinstellungen, Tarif und Audit.

Ereignis-Stream

Die Seite Ereignisse zeigt die Ereignisse des Projekts in Echtzeit. Beim Öffnen werden die letzten 50 Ereignisse der vergangenen 7 Tage geladen, neue erscheinen automatisch oben.

Ereignis-Stream mit aufgeklapptem Ereignis

Was Sie tun können:

Nach Namen filtern. Wählen Sie links in der Liste ein Ereignis, zum Beispiel order_completed – der Stream zeigt dann nur dieses. „Alle Ereignisse“ hebt den Filter auf.
Pausieren. Die Schaltfläche Pausieren hält den Stream an, damit Sie Ereignisse in Ruhe ansehen können; Fortsetzen startet ihn wieder.
Ereigniseigenschaften. Klicken Sie auf eine Zeile – die Eigenschaften werden im JSON-Format aufgeklappt.
Zum Profil wechseln. Die Nummer #… neben dem Namen führt zur Profilkarte.

Rechts steht der Verbindungsstatus: „Verbunden“, „Verbindung wird hergestellt…“ oder „Keine Verbindung“. Bei sehr hohem Aufkommen wird ein Teil der Ereignisse nicht angezeigt, und es erscheint die Zeile „Wegen hoher Last übersprungen: N“. Die Ereignisse selbst werden dabei gespeichert – das Überspringen betrifft nur die Anzeige.

Haben Sie keine Berechtigung für personenbezogene Daten, werden E-Mail-Adressen, Telefonnummern und PII-Eigenschaften in den Ereignissen maskiert. Mehr dazu im Artikel Profile.

Der Stream eignet sich gut, um die Installation zu prüfen: Öffnen Sie die Website in einem anderen Tab, legen Sie ein Produkt in den Warenkorb und vergewissern Sie sich, dass das Ereignis mit den richtigen Eigenschaften ankommt.

Datenkatalog

Der Katalog füllt sich automatisch: Sobald ein neues Ereignis, eine neue Eigenschaft oder ein neues Merkmal im Projekt ankommt, erscheint es hier mit einem erkannten Typ. Sie öffnen den Katalog über das Menü oder mit der Schaltfläche Datenkatalog auf der Ereignisseite.

Tab „Ereignisse“

Tabelle der Ereignisse: Ereignis (Name), Bezeichnung, Anzahl (wie oft es eingegangen ist) und Zuletzt (Datum des letzten Eingangs). Der Pfeil links klappt die Liste der Ereigniseigenschaften mit ihren Typen auf, zum Beispiel amount: number.

Datenkatalog, Tab „Ereignisse“

Tab „Profilmerkmale“

Merkmale sind Eigenschaften eines Kunden: E-Mail, Name, Stadt, Tarif, Geburtsdatum. Spalten: Schlüssel, Bezeichnung, Typ und PII.

Datenkatalog, Tab „Profilmerkmale“

Katalog einrichten

Geben Sie eine verständliche Bezeichnung ein, zum Beispiel „Bestellung abgeschlossen“ für order_completed oder „Stadt“ für city. Die Änderung wird sofort gespeichert.
Prüfen Sie beim Merkmal den Typ: string (Text), number (Zahl), boolean (ja/nein), datetime (Datum und Uhrzeit), list (Liste), object (Objekt).
Markieren Sie PII, wenn das Merkmal personenbezogene Daten enthält: Ausweisnummer, Adresse, Geburtsdatum.

Wofür das genutzt wird:

Bezeichnungen erscheinen im Segment-Editor neben dem Schlüssel: „Stadt (city)“. Im Marketing muss sich niemand technische Namen merken.
Vom Typ hängen die Segmentbedingungen ab: für Zahlen „größer als“ und „kleiner als“, für Datumswerte „vor“, „nach“ und „in den letzten“. Wurde der Typ falsch erkannt, etwa weil ein Datum als Text ankam, korrigieren Sie ihn.
Merkmale mit PII-Kennzeichnung werden für alle maskiert, die keine Berechtigung für personenbezogene Daten haben. E-Mail, Telefonnummer, Namen und Adresse werden automatisch gekennzeichnet.

Reservierte Ereignisse

Namen, die mit $ beginnen, sind für OneTrace.pro reserviert. Ein eigenes Ereignis mit einem solchen Namen können Sie nicht senden – die Anfrage gibt einen Fehler zurück.

Ereignis	Wann es auftritt
`$page`, `$identify`, `$alias`	Aufrufe von `cdp.page()`, `cdp.identify()` und das Zusammenführen von Kennungen
`$segment_entered`, `$segment_exited`	ein Profil ist in ein Segment eingetreten oder hat es verlassen
`$journey_entered`, `$journey_completed`, `$journey_exited`, `$journey_failed`	Schritte der Teilnahme an einer Journey
`$message_sent`, `$message_delivered`, `$message_failed`, `$message_skipped`, `$message_bounced`, `$message_complained`, `$message_opened`, `$message_clicked`	Verlauf gesendeter Nachrichten
`$subscribed`, `$unsubscribed`	Änderung der Einwilligung in Kampagnen

Systemereignisse sind im Stream, im Katalog und im Profilverlauf sichtbar; Sie können darauf Segmentbedingungen aufbauen wie auf eigene Ereignisse.

Tipps für Ereignisnamen

Benennen Sie Ereignisse mit lateinischen Buchstaben in snake_case und in der Vergangenheitsform: order_completed, product_viewed, trial_started.
Packen Sie keine veränderlichen Daten in den Namen: nicht order_1001, sondern order_completed mit der Eigenschaft order_id.
Übergeben Sie Beträge als Zahl, nicht als Text mit Währung: amount: 9980.