Events tracken

POST /v1/events/track ist ein öffentlicher, ausschließlich schreibender Endpoint, der dafür gebaut ist, direkt von der eigenen Website eines Kunden aufgerufen zu werden — er kann Events entgegennehmen, aber nichts zurücklesen, daher ist der Aufruf mit einem reinen Public Key sicher, anders als bei Ihrem Haupt-API-Key.

Ein einzelnes Event tracken

curl -X POST https://api.wezend.com/v1/events/track \
  -H "Content-Type: application/json" \
  -d '{
    "public_key": "pk_live_...",
    "event": "product_viewed",
    "customer_ref": "cus_8823",
    "properties": { "sku": "DK-1180", "price": 499 }
  }'

Ein einzelnes Event gibt 202 { "ok": true } zurück.

Events als Batch

{
  "public_key": "pk_live_...",
  "events": [
    { "event": "product_viewed", "customer_ref": "cus_8823", "properties": { "sku": "DK-1180" } },
    { "event": "add_to_cart", "customer_ref": "cus_8823", "properties": { "sku": "DK-1180", "qty": 1 } }
  ]
}

gibt 202 { "accepted": 2, "rejected": 0 } zurück.

Origin-Beschränkung

Sie können den Key als X-ZC-Key statt im Body übergeben. Jeder Public Key lässt sich optional auf eine Allowlist von Origins beschränken, sodass ein geleakter Key nur genutzt werden kann, um Events von Ihren eigenen Domains zu senden — eine leere Allowlist bedeutet beliebige Origins.

Was danach passiert

Sobald Events eintreffen, werden berechnete Traits neu berechnet und Segmentzugehörigkeiten in Echtzeit aktualisiert — jede Journey, die diesen Trigger oder dieses Segment beobachtet, kann sofort auslösen, ganz ohne Batch-Job.