Event-Tracking

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:

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

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.
• 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.
• Kontakte. Siehe Events und Kontakte.
• Automatisierungen. Ein Trigger 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 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 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.

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. Bewahren Sie Bestellungen und andere Datensätze, die Sie länger benötigen, in Ihren eigenen Systemen auf.

Limits

• 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.

Siehe auch