# Event-Tracking

> Erfassen Sie als Workspace-Events oder eigene Events, was Personen in Ihrer App und auf Ihrer Website tun, ordnen Sie sie Kontakten zu und empfangen Sie sie mit Webhooks.

Mit Event-Tracking erfassen Sie, was Personen in Ihrem eigenen Produkt tun: eine Bestellung, einen Tarifwechsel, eine Registrierung, einen Produktaufruf. Sie senden die Events von Ihrer Website mit dem Tracking-Skript oder von Ihren Servern per API. Emailit speichert sie neben den Events, die es selbst erfasst, ordnet sie Kontakten zu und kann sie an Ihre Webhooks senden.

Event-Tracking ist in den Tarifen Pro, Business und Custom enthalten. Bei Pay as you go geben das Senden von Events und das Definieren von Workspace-Events `403` mit `"error": "plan_required"` zurück, und Anfragen des Tracking-Skripts werden abgelehnt.

## Drei Scopes von Events

Jedes Event hat einen Typ, und sein Präfix zeigt seinen **Scope**:

| Scope | Typ | Wer es definiert | Beispiel |
| --- | --- | --- | --- |
| System | `<name>` | Emailit. Diese Events erfassen, was mit Ihren E-Mails, Kontakten und anderen Ressourcen passiert. Sie können sie nicht senden. | `email.delivered` |
| Workspace | `w:<name>` | Ihr Workspace. Sie legen zuerst das Event und den Typ jeder Eigenschaft fest, und Emailit lehnt Events ab, die nicht dazu passen. | `w:customer.type` |
| Custom | `c:<name>` | Niemand. Ein beliebiger Name, mit einem beliebigen JSON-Objekt als Eigenschaften. | `c:order.completed` |

Verwenden Sie ein **Workspace-Event**, wenn mehrere Systeme dasselbe Event senden und es einheitlich bleiben soll oder wenn sich Personen in Ihrem Team auf seine Felder verlassen. Verwenden Sie ein **eigenes Event**, wenn Sie Ihre eigene Datenstruktur behalten möchten, zum Beispiel das Bestellformat Ihres Shops, ohne sie vorher festzulegen. Sie können mit einem eigenen Event beginnen und es später als Workspace-Event definieren; die beiden sind getrennte Typen, daher vermischen sich `c:order.completed` und `w:order.completed` nicht.

## Event-Namen

Namen bestehen aus 1 bis 100 Buchstaben, Ziffern, Punkten, Bindestrichen oder Unterstrichen und beginnen mit einem Buchstaben oder einer Ziffer: `customer.type`, `order-completed`, `cart_updated`. Bei Namen wird zwischen Groß- und Kleinschreibung unterschieden.

Eigenschaftsnamen von Workspace-Events folgen denselben Regeln, aber ohne Punkte, weil Webhook-Filter und Vorlagen mit Punkten auf verschachtelte Werte zugreifen.

## Möglichkeiten zum Senden von Events

| Von | Wie | Zugangsdaten |
| --- | --- | --- |
| Ihrer Website | Mit dem [Tracking-Skript](/de/docs/events/tracking-script/) | Ein öffentlicher Tracking-Schlüssel, auf Ihre Websites beschränkt |
| Ihren Servern | Mit [Event senden](/de/docs/api-reference/events/send/) oder [Events gesammelt senden](/de/docs/api-reference/events/batch/) | Ein API-Schlüssel mit **Full Access** oder **Events Only**. Siehe [Events aus Ihrem Backend senden](/de/docs/events/send-events/). |
| Der Weboberfläche | Mit **Send event** unter **Email API → Events** | Ihre Anmeldung. Gedacht zum Testen eines Webhooks oder einer Integration. |

Events, bei denen es um Geld geht, etwa Bestellungen und Zahlungen, senden Sie am besten von Ihren Servern. Browser-Events können blockiert werden, und einen öffentlichen Schlüssel kann jede Person nutzen, um Events zu senden.

## Events und Kontakte

Ein Event kann die Person nennen, um die es geht, per `email` oder per `contact_id`.

- Kontakte werden nachgeschlagen, nie erstellt. Hat kein Kontakt diese E-Mail-Adresse, wird die Adresse trotzdem gespeichert, und das Event erscheint in der Aktivität des Kontakts, sobald Sie ihn erstellen.
- Eine `contact_id` muss zu einem Kontakt im Workspace gehören.
- Events ohne Person können eine `anonymous_id` enthalten. Das Tracking-Skript fügt jedem Event, das es sendet, eine hinzu.

Events, die einem Kontakt zugeordnet sind, erscheinen im **Activity log** des Kontakts, neben den E-Mails, die er erhalten hat. Workspace-Events mit einem Titel zeigen dort ihren Titel.

## Wohin Events gelangen

- **Das Event-Log.** **Email API → Events** listet im Tab **Log** jedes Event auf. Filtern Sie nach **Scope**, um nur System-Events, Workspace-Events oder eigene Events zu sehen. Per API verwenden Sie den Parameter `scope` von [Events auflisten](/de/docs/api-reference/events/list/).
- **Webhooks.** Abonnieren Sie mit einem Webhook einen Typ wie `c:order.completed` oder mit `w:*` und `c:*` alle Workspace-Events oder alle eigenen Events. Ein Webhook, bei dem **All events** aktiviert ist, erhält sie nur, wenn Sie sie zusätzlich auswählen. Siehe [Event-Typen](/de/docs/webhooks/event-types/#workspace-and-custom-events).
- **Kontakte.** Siehe [Events und Kontakte](#events-and-contacts).
- **Automatisierungen.** Ein [Trigger](/de/docs/automations/triggers/#custom-event) **Custom event** startet einen Durchlauf für den Kontakt des Events, optional nur, wenn seine Eigenschaften zutreffen. Dieselben Events können Durchläufe beenden, Ziele erreichen und Schritte **Wait until** fortsetzen. Das gilt nur für Events, die Sie mit der [Events-API](/de/docs/events/send-events/) von Ihrem Server senden: Jeder, der Ihren öffentlichen Tracking-Schlüssel kennt, kann angeben, wer ein Besucher ist, daher werden Events aus dem [Tracking-Skript](/de/docs/events/tracking-script/#identify-visitors) aufgezeichnet und erreichen Webhooks, starten aber keine Durchläufe, beenden keine und bringen keine weiter. Der Trigger **Custom event** ist in den Tarifen Business und Custom enthalten, Ausstiegsbedingungen, Ziele und Wartezeiten auf diese Events in den Tarifen Pro, Business und Custom. Siehe [Ausstiegsbedingungen und Ziele](/de/docs/automations/exits-and-goals/).

## Aufbewahrung

Events gehören zu den **Logs** Ihres Workspaces. Sie werden daher so lange aufbewahrt wie die Logs in Ihrem Tarif und dann gelöscht. Siehe [Datenaufbewahrung](/de/docs/data-retention/). Bewahren Sie Bestellungen und andere Datensätze, die Sie länger benötigen, in Ihren eigenen Systemen auf.

## Limits

| | Pay as you go | Pro | Business | Custom |
| --- | --- | --- | --- | --- |
| Typen von Workspace-Events und eigenen Events | — | 100 | 1.000 | Unbegrenzt |
| Tracking-Skript für Websites | — | Enthalten | Enthalten | Enthalten |

- **Event-Typen** sind die unterschiedlichen Typen von Workspace-Events und eigenen Events, die ein Workspace sendet, etwa `c:order.completed` und `w:customer.type`. Typen, die er bereits gesendet hat, funktionieren weiter. Hat er so viele Typen genutzt, wie sein Tarif umfasst, werden Events eines neuen Typs mit `422` abgelehnt.
- Workspace-Events: so viele, wie der Tarif Event-Typen umfasst, jedes mit bis zu 50 Eigenschaften.
- Eigenschaften eigener Events bis zu 32 KB JSON, bis zu 8 Ebenen tief verschachtelt.
- Bis zu 100 Events pro Batch-Anfrage.
- 25 Tracking-Schlüssel pro Workspace.

Mehr unter [Limits](/de/docs/limits/#other-limits).

## Siehe auch

  - [Workspace-Events](/de/docs/events/workspace-events/): Events und die Typen ihrer Eigenschaften definieren.
  - [Events aus Ihrem Backend senden](/de/docs/events/send-events/): Events per API erfassen.
  - [Tracking-Skript](/de/docs/events/tracking-script/): Events von Ihrer Website senden.
  - [Events-API](/de/docs/api-reference/events/): Events senden, auflisten und abrufen.

---
Quelle: https://emailit.com/de/docs/events/