Customer Data Platform
Objekte: Unternehmen und Konten für Ihre Kontakte
Bilden Sie Unternehmen, Konto, Abonnement oder Kurs mit eigenen Attributen ab, verknüpfen Sie Kontakte, nutzen Sie es in Segmenten und Journeys.
Ein Objekt ist alles, wozu ein Kontakt gehört und das eigene Daten hat: ein Unternehmen, ein Konto, ein Abonnement, ein Kurs. Ein Objekt wird über seinen Typ (ein Schlüssel in Kleinbuchstaben, den Sie wählen, etwa company) und eine externe ID identifiziert, die ID aus Ihrem eigenen System, sodass ein erneut gespeichertes Objekt aktualisiert wird. Ein Kontakt kann zu vielen Objekten gehören und ein Objekt viele Kontakte enthalten, mit optionaler Rolle wie owner oder member.
Attribute sind nur Skalare (Text bis 1.000 Zeichen, Zahl, Boolean oder null), höchstens 50 je Objekt; Namen werden zu snake_case. Verschachtelte Werte werden abgelehnt statt stillschweigend verworfen.
API
/v1/objects funktioniert mit einem API-Schlüssel oder einem Login (Rechte read und write).
| Aufruf | Wirkung |
|---|---|
GET /v1/objects | Ihre Typen mit der Anzahl je Typ |
GET /v1/objects/:type | die Objekte eines Typs (limit bis 200, offset) |
PUT /v1/objects/:type/:externalId | anlegen oder aktualisieren; Attribute werden zusammengeführt, null entfernt einen Schlüssel, replace: true ersetzt alle |
GET / DELETE /v1/objects/:type/:externalId | eines lesen oder löschen (seine Verknüpfungen gehen mit) |
GET / POST /v1/objects/:type/:externalId/contacts | auflisten, wer dazugehört, oder einen Kontakt verknüpfen (contact_id oder email, optional role) |
DELETE /v1/objects/:type/:externalId/contacts/:contactId | eine Verknüpfung entfernen |
GET /v1/objects/by-contact/:contactId | die Objekte, zu denen ein Kontakt gehört |
In Nachrichten
{{ objects.company.name }} ist das erste Unternehmen, zu dem der Kontakt gehört; object_lists.company sind alle, für eine Schleife (siehe Liquid). Ein Kontakt ohne Objekt eines Typs gibt nichts aus.
In Segmenten
Der Builder listet alle Objekttypen unter „Unternehmen und Objekte“: „Gehört zu einem <Typ>“ und eine Bedingung je Attribut, das an diesem Typ gesehen wurde. Eine Bedingung trifft zu, wenn irgendein Objekt dieses Typs, zu dem der Kontakt gehört, passt.
In Journeys
Eine Änderung wird als Ereignis für jeden Kontakt im Objekt erfasst: object_updated (mit den geänderten Namen, nie den Werten), object_linked und object_unlinked. Eine Journey, deren Trigger eines davon ist, startet für diese Personen. Ein group-Aufruf einer Segment-kompatiblen Quelle legt ein company-Objekt an und verknüpft die Person.
Löschung
Das Löschen eines Kontakts entfernt seine Verknüpfungen zu Objekten. Das Objekt bleibt: Es ist Ihre Aufzeichnung eines Unternehmens, nicht die Daten der Person.
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