Customer Data Platform
Segment-kompatible Quelle: identify, track, group
Senden Sie identify-, track-, page-, screen- und group-Nachrichten im Segment-Format an eine Quell-URL, einzeln oder in Batches bis 500.
POST /v1/sources/:key nimmt eine Nachricht oder { "batch": [ … ] } mit bis zu 500 im Segment-Format an. Den Quellschlüssel legen Sie auf der Seite Acquisition an. Segment, RudderStack, Make oder ein eigener Server können dorthin senden.
type | Was passiert |
|---|---|
identify | der Kontakt wird angelegt oder aktualisiert (E-Mail oder Telefon; Vor- und Nachname aus firstName und lastName oder einem geteilten name). Alle anderen skalaren Traits werden als eigene Felder gespeichert |
track | ein Verhaltensereignis (event, properties, messageId als Dedupe-ID, timestamp) |
page, screen | ein Ereignis (page_viewed, screen_viewed); sie legen keinen Kontakt an |
group | ein company-Objekt aus groupId und traits, mit der identifizierten Person verknüpft |
alias | wird angenommen und ignoriert |
Die Person wird aus email oder phone oben, aus traits, aus context.traits oder aus userId gelesen, wenn dieses eine E-Mail-Adresse ist. Eine einfache userId ist hier keine Identität. Eine Nachricht ohne type ist ein track, wenn sie ein event hat, sonst ein identify.
Eine fehlerhafte Nachricht stoppt keinen Batch: Jede erhält ihr eigenes Ergebnis, eine abgelehnte landet in der Dead-Letter-Ablage. Eigene Felder aus identify werden zu snake_case, nur Skalare, höchstens 100 Schlüssel, Strings werden bei 1.000 Zeichen gekürzt.
Ein Stripe-Konto als Quelle
Legen Sie eine Quelle mit { "name": "…", "kind": "stripe", "signing_secret": "whsec_…" } an und richten Sie einen Stripe-Webhook-Endpunkt auf /v1/sources/<key>. Ereignisse werden mit Stripe-Signature über den rohen Body verifiziert, das Secret wird versiegelt gespeichert und nie zurückgegeben.
| Stripe-Ereignis | Wird zu |
|---|---|
checkout.session.completed (bezahlt) | purchase mit Umsatz und Währung |
invoice.paid und invoice.payment_failed | invoice_paid und payment_failed |
charge.refunded | payment_refunded |
customer.created und customer.updated | der Kontakt wird angelegt oder aktualisiert, mit Tag stripe |
Nur Ereignisse mit E-Mail-Adresse lassen sich einer Person zuordnen. Es wird kein Stripe-API-Schlüssel gespeichert, daher wird nichts von Stripe abgerufen.
Eine Plattform. Jede Kundeninteraktion.
Ersetzen Sie Ihren Flickenteppich aus Messaging-APIs, CDP und Automatisierungstools durch eine Engagement-Plattform, die für Skalierung gebaut ist.
Keine Kreditkarte · EU-Datenhaltung · 99,99 % Uptime-SLA