Ereignisse tracken
Ereignisse sind das, was Ihre Kunden tun — „signed_up“, „added_to_cart“, „purchased“. Streamen Sie sie an Climails, und sie werden zum Treibstoff für Segmente, Automations-Trigger und Umsatzzuordnung.
Was Sie brauchen
- Ein API-Key mit Berechtigung zum Schreiben von Ereignissen
- Ein Backend oder Frontend, das POSTen kann, wenn etwas passiert
Ein Ereignis senden
POST an /v1/events mit dem Ereignisnamen, wem es gehört und beliebigen Eigenschaften. Identifizieren Sie den Kontakt per id, external_id oder email.
curl https://api.climails.com/v1/events \
-H "Authorization: Bearer sb_live_<prefix>.<secret>" \
-H "Content-Type: application/json" \
-d '{
"name": "purchased",
"contact": { "email": "[email protected]" },
"occurred_at": "2026-07-01T10:24:00Z",
"properties": { "amount": 49.0, "currency": "USD", "plan": "pro" }
}'Ereignisse in Bulk senden
Backfilling oder Batching? POSTen Sie bis zu 1000 Ereignisse auf einmal an /v1/events/bulk statt einer Anfrage je Ereignis.
Ereignisse einsetzen
- Segmente — bauen Sie Bedingungen auf Ereignissen, z. B. hat „purchased“ in den letzten 30 Tagen oder mindestens 3-mal getan.
- Automationen — starten Sie einen Flow in dem Moment, in dem ein Ereignis eintrifft (Ereignis-Trigger).
- Umsatz — hängen Sie eine amount-Eigenschaft und die ursprüngliche Kampagne an, um Umsatz in den Analysen zuzuordnen.
Häufig gestellte Fragen
Wie identifiziere ich den Kontakt bei einem Ereignis?
Per id, external_id oder email. Falls der Kontakt noch nicht existiert, wird das Ereignis zugeordnet, sobald er mit einem passenden Identifikator angelegt wird.
Wie hoch ist das Bulk-Limit?
Bis zu 1000 Ereignisse pro Aufruf an /v1/events/bulk.
Kann ich danach segmentieren, wie oft ein Ereignis passiert ist?
Ja — Ereignisbedingungen unterstützen einen Count-Operator und ein Zeitfenster (z. B. ≥ 3-mal in den letzten 30 Tagen).
In Minuten mit dem Versand starten
Kostenloses Konto erstellen, Domain verbinden und Ihre Zielgruppe über alle Kanäle erreichen – ohne Kreditkarte.
Dauerhaft kostenloser Tarif · Keine Kreditkarte · In Minuten startklar