Erfahre mehr über benutzerdefinierte Objekte, mit denen du mehrere Eigenschaften speichern und einem einzigen „Objekt“ zuordnen kannst. Mit benutzerdefinierten Objekten kannst du verschiedene, multirelationale Datenkonzepte in Klaviyo abbilden, die nicht mithilfe von Profileigenschaften gespeichert werden können. Anschließend kannst du benutzerdefinierte Objekte in deinen Nachrichten, Segmenten und mehr verwenden.
Wie unterscheiden sich benutzerdefinierte Objekte von Profileigenschaften?
Profileigenschaften sind eine gute Möglichkeit, einfache Informationen zu speichern. Wenn du z. B. eine Lieblingsfarbeigenschaft hast, kannst du die Lieblingsfarbe jedes Kunden speichern.
Aber was ist, wenn du mehr Daten oder mehrere Versionen dieser Eigenschaft benötigst? Ein gutes Beispiel ist für Haustiere. Du kannst Profileigenschaften verwenden, um Dinge wie Name, Alter und Rasse zu speichern, aber diese können nur einmal pro Profil verwendet werden.
Wenn jemand mehrere Haustiere hat, kannst du stattdessen benutzerdefinierte Objekte verwenden. Auf diese Weise hat Fluffy der Große Däne seinen eigenen digitalen Ausweis für seinen Namen, sein Alter, sein Gewicht usw., und Cheeks der Hamster hat die gleichen Informationen, aber mit (sehr) unterschiedlichen Antworten.
Beispielhafte Anwendungsfälle
Nachfolgend sind einige Beispiele aufgeführt, die zeigen, wie flexibel benutzerdefinierte Objekte in den Daten sind, die du in Klaviyo laden kannst.
Ernennung
Wenn du ein Unternehmen bist, in dem Kunden Termine vereinbaren können, kannst du ein Terminobjekt verwenden, um Termindaten für das Profil zu laden.
In jedem Objektdatensatz für das Appointment-Objekt kannst du zum Beispiel folgende Daten angeben:
- Termin-ID
- Datum der Ernennung
- Terminperson (z. B. ein bestimmter Arzt, Ausbilder usw.)
- Ort der Verabredung
- Art der Ernennung
Profile können mehrere Objektdatensätze haben, wenn sie mehrere Termine haben, und du kannst diese Objektdaten nutzen, um Segmente zu erstellen und personalisierte Nachrichten und Flow zu versenden.
Abonnement
Wenn du ein Unternehmen bist, bei dem Kunden sich für ein Abonnement registrieren können, kannst du ein Abo-Objekt verwenden, um Abo-Daten für das Profil zu laden.
In jedem Objektdatensatz für das Abo-Objekt kannst du zum Beispiel folgende Daten angeben:
- Abonnement-ID
- Abonnement-Produkt
- Abonnementpreis
- Status des Abonnements
- Nächster Abrechnungstermin
Profil kann mehrere Objektdatensätze haben, wenn sie mehrere Abonnements haben, und du kannst diese Objektdaten nutzen, um Segmente zu erstellen und personalisierte Nachrichten und Flow zu versenden.
Reservierung
Wenn du ein Unternehmen bist, in dem Kunden Reservierungen buchen können, kannst du ein Reservierungsobjekt verwenden, um Reservierungsdaten für das Profil zu laden.
In jedem Objektdatensatz für das Objekt " Reservierung" kannst du zum Beispiel folgende Daten angeben:
- Reservierungs-ID
- Datum der Reservierung
- Ort der Reservierung
- Reservierung Anlass
- Anzahl der reservierten Gäste
Profil kann mehrere Objektdatensätze haben, wenn sie mehrere Reservierungen haben, und du kannst diese Objektdaten nutzen, um Segmente zu erstellen und personalisierte Nachrichten und Flow zu versenden.
Haustier
Wenn du ein Unternehmen bist, das Haustierbesitzer bedient, kannst du ein Pet-Objekt nutzen, um Daten über Profil' Haustiere zu laden.
In jedem Objektdatensatz für das Pet-Objekt kannst du zum Beispiel folgende Daten angeben:
- Mikrochip-ID für Haustiere
- Tiername
- Haustierart (z. B. Hund oder Katze)
- Haustierrasse
- Haustier Geburtstag
Profil kann mehrere Objektdatensätze haben, wenn sie mehrere Haustiere haben, und du kannst diese Objektdaten verwenden, um Segmente zu erstellen und personalisierte Nachrichten und Flow zu senden.
Kontolimits
Die Objektlimits für dein Konto hängen von den Profillimits deines Kontos ab und davon, ob du ein Advanced Klaviyo Data Platform Abonnement hast. Für den Zugriff auf diese Funktionen ist mindestens ein kostenpflichtiges E-Mail-Abonnement oder eine Testversion der Advanced Klaviyo Data Platform erforderlich, die du über deinen CSM anfordern kannst. Wenn du innerhalb einer Kontofamilie arbeitest, entsprechen deine Limits denen eines Advanced Klaviyo Data Platform Abonnements. Mehr über die Abrechnung erfährst du, wenn du dir ansiehst , wie die gemeinsame Abrechnung in Klaviyo funktioniert.
Für benutzerdefinierte Objekte gibt es 3 Arten von Kontolimits:
-
Objekt-Limit
Gesamtzahl der Objekte, die ein Konto haben kann. -
Objekteigenschaftslimits
Die Anzahl der Eigenschaften, die ein Konto pro Objekt haben kann.
-
Objektdatensatzgrenzen
Die Anzahl der erlaubten Objektdatensätze für ein Konto.
Die Anzahl der verfügbaren Objekte und Objektdatensätze basiert auf der Gesamtzahl der aktiven Profile in allen deinen Konten. Datensatzgrenzen gelten für alle Konten, während Objektgrenzen für jedes Konto einzeln gelten.
Wenn du zum Beispiel eine Kontofamilie mit 5 Unterkonten hast, bei denen jedes Konto 100.000 aktives Profil hat, beträgt dein gesamtes aktives Profil 500.000. Wie in der folgenden Tabelle zu sehen ist, haben Konten mit mehr als 400.000 Profilen einen Objektsatzmultiplikator von 10. Daher können diese Konten zusammen maximal 5 Millionen Datensätze laden (500.000 x 10). Das bedeutet, dass du 1 Konto mit 3 Millionen Datensätzen haben kannst, solange die restlichen 4 Konten zusammen weniger als 2 Millionen Objektdatensätze haben. Was die Anzahl der Objekte pro Konto angeht, so kann jedes Konto bis zu 5 Objekte haben, da die Anzahl der Profile zusammen über 400.000 beträgt.
Wenn du ein erweitertes Klaviyo Data Platform Abonnement hast, basiert der Objektdatensatz-Multiplikator auf der Gesamtzahl der Profile auf deinem Konto. Wenn du nur ein E-Mail-Abonnement hast, basiert dieser Multiplikator auf dem aktiven Profil-Limit für dein Konto.
| Profile | Fortgeschrittenes Klaviyo Data Platform Abonnement | Anzahl der Objekte | Anzahl der Objekteigenschaften | Objektsatz-Multiplikator |
| Kostenloses Abonnement | keine | 0 | 0 | nicht verfügbar |
| 250 - 400,000 | keine | 1 | 15 | 10x |
| bezahlt | 5 | 30 | 10x | |
| Über 400.000 | keine | 10x | ||
| bezahlt | 10x |
Außerdem gelten für alle Konten die folgenden Grenzen:
- Maximal 500 Datensätze pro Profil und Objekt.
- Jedes benutzerdefinierte Objekt darf nicht größer als 8 KB sein.
- Jeder Datensatz eines benutzerdefinierten Objekts darf nicht größer als 2 KB sein.
Ein Objekt erstellen
Um mit der Erstellung eines Objekts in Klaviyo zu beginnen, navigiere zu Content > Objects.
Folge den Schritten, um eine Datenquelle für dein benutzerdefiniertes Objekt zu erstellen und zu synchronisieren. Wenn du diese Schritte abgeschlossen hast, klicke auf die Schaltfläche Benutzerdefiniertes Objekt erstellen , um das Objekt zu erstellen.
Von hier aus kannst du entweder ein Objekt von Grund auf neu erstellen oder eine empfohlene Objektvorlage auswählen. Um ein Objekt von Grund auf neu zu erstellen, wähle die Schaltfläche " Eigene erstellen".
Im ersten Teil des Workflow zur Objekterstellung musst du die folgenden Informationen für dein Objekt festlegen:
-
Name
Ein Name zur Identifizierung deines Objekts -
Beschreibung (optional)
Eine Beschreibung der Daten, die dein Objekt darstellt -
Datenquelle
Die Datenquelle, aus der Objektdaten abgerufen werden sollen. Mindestens ein Datensatz muss mit der API des benutzerdefinierten Objekts an Klaviyo gesendet werden, damit er als Option in der Drop-down-Liste angezeigt wird.Â
Die Objekt-ID festlegen
Sobald du einen Namen für dein Objekt festgelegt und die Datenquelle ausgewählt hast, besteht der nächste Schritt darin, eine Objekt-ID festzulegen und die gewünschten Objekteigenschaften zuzuordnen. In diesem Schritt kannst du eine Vorschau der Daten sehen, die mit der Datenquelle verbunden sind, die Klaviyo über das benutzerdefinierte Objekt an API gesendet wurde.
Das Festlegen der Objekt-ID ist notwendig, um Objektdatensätze voneinander zu unterscheiden. Du musst eine Eigenschaft der Datenquelle angeben, die für die eindeutige Objekt-ID verwendet werden soll.
Die Objekt-ID sollte eine eindeutige Datenquelleneigenschaft sein, mit der bestimmte Instanzen eines Objektsatzes identifiziert werden können. Zum Beispiel kannst du bei einem Geschenkkartenobjekt so was wie den einzigartigen Rabattcode als Objekt-ID nehmen. Das ist für jede Instanz der Datenquelle einzigartig und wird für jeden Objektdatensatz vorhanden sein.
Immer wenn Klaviyo Daten von deiner Datenquelle mit der gleichen Objekt-ID erhält, wird der zugehörige Objektdatensatz aktualisiert. Aus diesem Grund ist es wichtig, dass die Objekt-ID eindeutig ist, damit der richtige Datensatz aktualisiert wird.
Objekt Daten senden
Wenn du einen vorhandenen Objektdatensatz aktualisierst, wird der gesamte Datensatz ersetzt. Daher ist es wichtig, den gesamten Objektdatensatz zu senden, auch wenn du nur eine Eigenschaft aktualisieren möchtest.
Angenommen, du möchtest nur eine von fünf Eigenschaften in einem Datensatz aktualisieren. Wenn du aktualisierte Daten mit der ID und nur der 1 Eigenschaft sendest, die du aktualisieren möchtest, werden die anderen 4 Eigenschaften auf Null gesetzt. Wenn eines der neuen Nullfelder in deiner Profilbeziehung verwendet wurde (z. B. eine Profilkennung wie eine E-Mail-Adresse), wird das Objekt nicht mehr mit diesem Profil verknüpft.
Wenn du Telefonnummern verschickst, müssen sie im E.164-Format sein. Wenn du Daten sendest, müssen sie in einem der von uns akzeptierten Zeitstempelformate vorliegen.
Eigenschaften des Kartenobjekts
Indem du Objekteigenschaften zuordnest, kannst du auswählen, welche Informationen aus der Datenquelle in einem Objekt in Klaviyo verfügbar sein sollen.
In der Dropdown-Liste sind nur die Daten verfügbar, die in der jeweiligen Instanz der Datenquelle angezeigt werden, die du gerade ansiehst. Mit der Schaltfläche Neue Datenprobe kannst du die Instanzen der Datenquelle durchlaufen.
Aus diesem Grund empfehlen wir, Objektdaten über den Objekt-Ingestions API in standardisierten Datums- und Zeitstempelformaten zu senden. Wenn du den Wert für eine bestimmte Eigenschaft nicht kennst, kannst du einfach null eingeben.
Um Objekteigenschaften zuzuordnen:
- Wähle in der Spalte Datenquelleneigenschaft die Datenquelleneigenschaft aus, die du in dein Objekt aufnehmen möchtest.
- In der Spalte Zugeordnete Eigenschaft gibst du den Namen ein, den die Eigenschaft der Datenquelle im Objekt haben soll.
- Wähle in der Spalte Datentyp den entsprechenden Datentyp deiner Datenquelleneigenschaft aus.
- Aktiviere in der Spalte Erforderlich das Kontrollkästchen, wenn du möchtest, dass diese Eigenschaft für das Objekt erforderlich ist.
- Wähle die Schaltfläche Zuordnung hinzufügen , wenn du weitere Objekteigenschaften zuordnen möchtest.
Wenn eine Objekteigenschaft auf Erforderlich gesetzt wird, muss sie in der Datenquelle vorhanden sein und darf keinen Nullwert haben. Wenn die erforderliche Eigenschaft nicht vorhanden ist, wird der Objektdatensatz nicht erstellt.
Standardmäßig unterstützt die Objektmanager-Schnittstelle eine Verschachtelungsebene. Um auf tiefere Daten zuzugreifen, musst du den Pfad deiner Wahl manuell eingeben.
Schau dir zum Beispiel die Datenquelle unten an.
{ „type“: „data-source-record“, „attributes“: { „record“: { „child“: { „child_id“: „d64b8458“, „name“: {
"first": "Theodore",
"last": "Customer"
}, „birth_date“: „12.04.2022“, „E-Mail“: „jon.customer@klaviyo.com“,
„phone_numbers“: [ „+11234567899“, „+13456789123“ ] } } }Beziehung hinzufügen
Nachdem du eine Objekt-ID festgelegt und deine Objekteigenschaften zugewiesen hast, musst du im nächsten Schritt eine Beziehung zu deinem Objekt hinzufügen.
Beziehungen verbinden dein Objekt mit relevanten Profilen. Definiere die folgenden Informationen, um eine Beziehung herzustellen:
-
Name der Beziehung
Lege einen Namen für deine Beziehung fest. Wenn du z. B. ein Haustierobjekt hast, kannst du den Beziehungsnamen so einstellen, dass er etwa „Haustierbesitzer“ lautet. -
Quelldaten
Wähle die Datenquelleneigenschaften aus, die du einem Profil zuordnen möchtest. -
Profil-ID
Lege die Profilkennung fest (z. B. E-Mail, Telefonnummer usw.). Dies muss in der Datenquelle enthalten sein, damit ein Objekt mit einem Profil verknüpft werden kann. Verwende die Schaltfläche Andere Eigenschaft verknüpfen , um zusätzliche Eigenschaften- und Kennungspaare hinzuzufügen.
Mappings bestätigen und Objekt erstellen
Wenn du die Zuordnung der Objekteigenschaften und die Festlegung der Beziehung abgeschlossen hast, bestätigst du die Zuordnungen im Bestätigungsmodal und wählst die Schaltfläche Objekt erstellen. Beachte, dass bestehende Zuordnungen nicht mehr bearbeitet werden können, sobald das Objekt erstellt ist, und die Daten sofort synchronisiert werden.
Du siehst dein Objekt auf der Objektseite in Klaviyo zusammen mit den folgenden Informationen:
- Objektname
- Erstellt am
- Datum der letzten Aktualisierung
- Status
Benutzerdefinierte Objektstatuszustände
Bei der Veröffentlichung von benutzerdefinierten Objekten gibt es drei Statuszustände:
-
Entwurf
Das Objekt ist weiterhin bearbeitbar und nicht veröffentlicht oder aktiv. -
Veröffentlichen
Das Objekt erstellt benutzerdefinierte Objektdatensätze aus den Daten, die du an deine Datenquelle gesendet hast. Wenn du ein paar Tausend Datensätze aus deiner Datenquelle gesendet hast, wird dein Objekt sofort veröffentlicht. Wenn du ein paar Millionen Datensätze versendet hast, kann die Veröffentlichung Stunden dauern. Nach Abschluss wird der Status in Aktiv geändert. -
Aktiv
Das Objekt ist veröffentlicht und live. Alle benutzerdefinierten Objektdatensätze wurden anhand der Daten erstellt, die von deiner Datenquelle gesendet wurden. Alle neuen Daten, die für dieses Objekt gesendet werden, generieren zusätzliche benutzerdefinierte Objektdatensätze, die mit deinen Profilen verknüpft sind.
Objekte auf Profilseiten
Relevante Objekte werden auch auf einer Profilseite angezeigt, damit du die Objektdatensätze, die zu einem Profil gehören, einsehen kannst. Um die Objektdatensätze anzuzeigen, navigiere auf einer Profilseite zur Registerkarte Objekte. Du kannst zwischen den Objekten wechseln, indem du das Dropdown-Menü über den Objektkarten benutzt.
Um einen vollständigen Objektdatensatz anzuzeigen, wähle das 3-Punkte-Menü und klicke auf Anzeigen. Es erscheint ein Seitenfenster, das den vollständigen Objektdatensatz enthält.
Update ein Objekt
Jede Änderung, die du an einem benutzerdefinierten Objekt vornimmst, führt zu einer Änderung des aktiv benutzerdefinierten Objekts.
Wenn du neue Daten für ein Objekt senden möchtest, füge die zusätzlichen Objekteigenschaften zu deiner Datenquelle hinzu und bearbeite dann deine Objektzuordnung, um diese neue Eigenschaft aufzunehmen. Alle zuvor erstellten Objekte geben für diese Eigenschaft eine Null zurück, da diese Daten nicht verfügbar sind, aber in Zukunft werden Objekte mit dieser Eigenschaft erstellt und aktualisiert.
Wenn du neue Objekteigenschaften sendest, die noch nicht einem Objekt zugeordnet wurden, kannst du dein benutzerdefiniertes Objekt aktualisieren, um es einzubeziehen. Alle benutzerdefinierten Objektdatensätze werden dann neu bearbeitet, um diese Daten einzubeziehen.
Um ein Objekt zu aktualisieren:
- Klicke auf Inhalt > Objekte in der Klaviyo-Seitenleiste.
- Wähle den Namen des Objekts aus, das du bearbeiten möchtest.
- Klicke in der oberen rechten Ecke auf Weiter .
-
Klicke im Bereich Eigenschaften des Kartenobjekts auf Zuordnung hinzufügen.
Diese Option ist nur verfügbar, wenn dein Objekt zusätzliche Eigenschaften hat, die hinzugefügt werden können.
- Wähle in der Spalte Datenquelleneigenschaft die Datenquelleneigenschaft aus, die du in dein Objekt aufnehmen möchtest.
- In der Spalte Zugeordnete Eigenschaft gibst du den Namen ein, den die Eigenschaft der Datenquelle im Objekt haben soll.
-
Wähle in der Spalte Datentyp den entsprechenden Datentyp deiner Datenquelleneigenschaft aus.
Neu zugeordnete Eigenschaften können nicht als erforderlich markiert werden.
- Klicke in der oberen rechten Ecke auf Weiter .
- Klicke in der oberen rechten Ecke auf Weiter . Du musst keine Änderungen an deinen Beziehungen vornehmen.
- Klicke auf Änderungen veröffentlichen.
Sobald du diesen Vorgang abgeschlossen hast, werden alle Datensätze aus deiner Datenquelle neu verarbeitet und bestehende benutzerdefinierte Objektdatensätze werden entsprechend aktualisiert.
Ein Objekt löschen
Sobald du ein Objekt gelöscht hast, kann es nicht mehr zurückgeholt oder rückgängig gemacht werden. Alle Segmente, Flüsse, Vorlagen oder Kampagnen, die diese benutzerdefinierten Objekte verwendet haben, funktionieren nicht mehr wie vorgesehen.
Um ein Objekt zu löschen:
- Klicke auf Inhalt > Objekte in der Klaviyo-Seitenleiste.
- Klicke im Menü auf der rechten Seite deines Objekts auf Löschen.
- Klicke erneut auf Löschen , um das Entfernen des Objekts zu bestätigen.
- Das Objekt und alle zugehörigen benutzerdefinierten Objektdatensätze werden gelöscht.
Wenn du ein neues benutzerdefiniertes Objekt mit der Datenquelle eines früheren Objekts erstellst, werden neue Datensätze für das benutzerdefinierte Objekt mit den Daten erstellt, die du bereits synchronisiert hast. Obwohl es dieselben Daten verwendet, wird es als neues Objekt mit neuen Datensätzen betrachtet, so dass alle Segmente, Flüsse, Vorlagen und Kampagnen aktualisiert werden müssen, um dieses neue Objekt zu verwenden.
Zusätzliche Ressourcen
Wie man benutzerdefinierte Objekte in der Vorlage verwendet
Wie man benutzerdefinierte Objekte in Segment verwendet