Segmente & berechnete Traits

Segmente

GET /v1/segments listet jedes Segment mit einer Live-Kontaktanzahl auf. GET /v1/segments/schema liefert die Felder und Operatoren, die der Regel-Builder anbieten kann, sodass sich eine eigene Oberfläche gegen dasselbe Schema bauen lässt, das auch das Dashboard verwendet.

Vor dem Speichern eines Segments können Sie in der Vorschau sehen, wie viele Kontakte ein Regelsatz trifft:

curl -X POST https://api.wezend.com/v1/segments/preview \
  -H "X-API-Key: $WEZEND_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "rules": [{ "field": "trait:churn_score", "op": "gt", "value": 0.7 }] }'

GET /v1/segments/:id/contacts löst ein gespeichertes Segment in die tatsächlichen Mitgliedskontakte auf.

Berechnete Traits

Traits (/v1/traits) sind kundenseitig definierte Aggregationen über Events, Nachrichten und Bestellungen — z. B. „Bestellungen der letzten 90 Tage" oder „durchschnittlicher Bestellwert" — die direkt auf jedem Kontakt materialisiert werden, sodass sie in Segmentregeln als trait:<key> abfragbar sind, genau wie im Churn-Score-Beispiel oben.