Erste Schritte mit benutzerdefinierten Objekten

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 zuordnen, die nicht über 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 der einzelnen Kund*innen speichern.

Aber was ist, wenn du mehr Daten oder mehrere Versionen dieser Eigenschaft brauchst? Ein gutes Beispiel sind Haustiere. Du kannst Profileigenschaften verwenden, um Dinge wie Name, Alter oder Rasse zu speichern, aber diese können pro Profil nur einmal 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, Gewicht usw., und Cheeks der Hamster hat die gleichen Informationen, aber mit (sehr) unterschiedlichen Antworten. 

Beispiele für Anwendungsfälle

Unten findest du einige Beispiele, die zeigen, wie benutzerdefinierte Objekte in den Daten, die du in Klaviyo speichern kannst, flexibel sind.

Termin

Wenn du ein Unternehmen bist, in dem Kund*innen Termine vereinbaren können, kannst du ein Appointment- Objekt verwenden, um Termindaten für Profile zu speichern. 

In jedem Objektdatensatz für das Appointment- Objekt solltest du u. a. die folgenden Daten einfügen:

• Termin-ID
• Termin-Datum
• Terminperson (z. B. bestimmter Arzt, Ausbilder usw.)
• Ort des Termins
• Termintyp

Profile können mehrere Objektdatensätze haben, wenn sie mehrere Termine haben, und du kannst diese Objektdaten verwenden, um Segmente zu erstellen und personalisierte Nachrichten und Flows zu senden.

Abonnement

Wenn du ein Unternehmen bist, in dem sich Kund*innen für ein Abonnement anmelden können, kannst du ein Abonnement- Objekt verwenden, um Abonnementdaten für Profile zu speichern. 

In jedem Objektdatensatz für das Subscription- Objekt kannst du u. a. die folgenden Daten verwenden:

• Abonnement-ID
• Abonnement-Produkt
• Abonnementpreis
• Abonnementstatus
• Nächstes Abrechnungsdatum

Profile können mehrere Objektdatensätze haben, wenn sie mehrere Abonnements haben, und du kannst diese Objektdaten verwenden, um Segmente zu erstellen und personalisierte Nachrichten und Flows zu senden.

Reservierung

Wenn du ein Unternehmen bist, in dem Kund*innen Reservierungen buchen können, kannst du ein Reservierungsobjekt verwenden, um Reservierungsdaten für Profile zu speichern. 

In jedem Objektdatensatz für das Reservierungsobjekt kannst du u. a. folgende Daten verwenden:

• Reservierungs-ID
• Reservierungsdatum
• Reservierungsort
• Anlass der Reservierung
• Anzahl der Reservierungsgäste

Profile können mehrere Objektdatensätze haben, wenn sie mehrere Reservierungen haben, und du kannst diese Objektdaten verwenden, um Segmente zu erstellen und personalisierte Nachrichten und Flows zu senden.

Haustier

Wenn du ein Unternehmen bist, das Haustierbesitzern dient, kannst du ein Pet- Objekt verwenden, um Daten über die Haustiere des Profils zu speichern. 

In jedem Objektdatensatz für das Pet- Objekt kannst du u. a. die folgenden Daten verwenden:

• Mikrochip-ID für Haustiere
• Name des Haustiers
• Haustiertyp (z. B. Hund oder Katze)
• Haustierrasse
• Geburtstag des Haustiers

Profile können mehrere Objektdatensätze haben, wenn sie mehrere Haustiere haben, und du kannst diese Objektdaten verwenden, um Segmente zu erstellen und personalisierte Nachrichten und Flows zu senden.

Konto-Limits

Benutzerdefinierte Objekte haben drei Gruppen von Kontolimits:

• Objektlimit
  Die Gesamtzahl der Objekte, die ein Konto haben kann.
• Objekteigenschaftslimits
  Die Anzahl der Eigenschaften, die ein Konto pro Objekt haben kann.
• Objektdatensatzlimits
  Die Anzahl der Objektdatensätze, die für ein Konto zulässig sind.

Die Anzahl der verfügbaren Objekte und Objektdatensätze basiert auf dem Profil-Limit deines Tarifs. Für eine Kontofamilie bestimmt das Profil-Limit des gemeinsamen Tarifs diese Kontingente. Datensatzlimits werden innerhalb der Familie geteilt, während Objektlimits für jedes Konto separat gelten.

Ein kostenloser E-Mail-Plan mit einem Limit von 250 Profilen umfasst 2.500 Objektdatensätze.

Wenn du zum Beispiel eine Kontofamilie mit 5 Konten und einen gemeinsamen E-Mail-Plan mit einem Limit von 500.000 aktiven Profilen hast, beträgt der Multiplikator für Objektdatensätze 10. Diese Konten können zusammen maximal 5 Millionen Datensätze speichern (500.000 × 10). Das bedeutet, du könntest 1 Konto mit 3 Millionen Datensätzen haben, solange die verbleibenden 4 Konten zusammen nicht mehr als 2 Millionen Objektdatensätze haben. Da das gemeinsame Profil-Limit über 400.000 liegt, kann jedes Konto bis zu 5 Objekte haben.

Darüber hinaus gelten für alle Konten die folgenden Limits:

• Maximal 500 Datensätze pro Profil und Objekt.
• Jeder benutzerdefinierte Objektdatensatz darf nicht größer als 8 KB sein.
• Jeder Eigenschaftswert in einem benutzerdefinierten Objektdatensatz darf nicht größer als 2 KB sein.

Erstelle ein Objekt

Um mit dem Erstellen eines Objekts in Klaviyo zu beginnen, gehe zu Inhalte > Objekte und klicke auf Objekt erstellen.

Hier kannst du entweder ein Objekt von Grund auf neu erstellen oder eine empfohlene Vorlage auswählen. Um ein Objekt von Grund auf neu zu erstellen, klicke auf die Schaltfläche Eigene erstellen.

Im ersten Teil des Workflows 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, in der sich deine Objektdaten befinden.

Um eine neue Datenquelle zu erstellen, öffne das Dropdown-Menü Datenquelle und wähle Neue Datenquelle erstellen aus.

Zum Erstellen einer Datenquelle musst du folgende Informationen festlegen:

• Name
  Ein eindeutiger Name zur Identifizierung der Quelle deiner Objektdaten.
• Beschreibung (optional)
  Eine Beschreibung deiner Datenquelle.

Klicke auf Weiter, um fortzufahren.

Lege die Objekt-ID fest

Als Nächstes legst du eine Objekt-ID fest und definierst deine Objekteigenschaften. Wenn deine Datenquelle bereits Daten enthält, die über die Custom-Object-API gesendet wurden, kannst du eine Vorschau anzeigen und Eigenschaften auswählen, die du zuordnen möchtest. Wenn deine Datenquelle leer ist, kannst du zuerst die Eigenschaften definieren und die nach der Erstellung bereitgestellte Beispiel-Payload verwenden, um mit dem Senden von Daten zu beginnen.

Das Festlegen der Objekt-ID ist erforderlich, um Objektdatensätze voneinander zu unterscheiden. Wähle für eine Datenquelle, die bereits Daten enthält, eine Eigenschaft unter Objekt-ID aus. Für eine leere Datenquelle legt Klaviyo das Feld „Objekt-ID“ auf id fest; füge in jeden Datensatz, den du sendest, einen eindeutigen Wert dafür ein.

Die Objekt-ID sollte eine eindeutige Datenquelleneigenschaft sein, die verwendet werden kann, um bestimmte Instanzen eines Objektdatensatzes zu identifizieren. Bei einem Geschenkkartenobjekt kannst du z. B. so etwas wie den personalisierten Rabattcode als Objekt-ID verwenden. Dies ist für jede Instanz der Datenquelle eindeutig und wird für jeden Objektdatensatz vorhanden sein.

Wenn Klaviyo Daten aus deiner Datenquelle mit derselben Objekt-ID erhält, wird der zugehörige Objektdatensatz aktualisiert. Aus diesem Grund ist es wichtig, dass die Objekt-ID eindeutig ist, damit der entsprechende Datensatz aktualisiert wird.

Du kannst Objektdaten senden

Wenn du ein Update über die Data-Source-Ingestion-API sendest, wird der Objektdatensatz ersetzt. Sende den gesamten Datensatz, auch wenn du nur 1 Eigenschaft aktualisieren möchtest.

Angenommen, du möchtest zum Beispiel nur 1 von 5 optionalen Eigenschaften in einem Datensatz aktualisieren. Wenn du die ID und nur die Eigenschaft sendest, die du aktualisieren möchtest, sind die anderen 4 Eigenschaften null. Wenn du eine erforderliche Eigenschaft weglässt, wird das Update stattdessen abgelehnt. Behalte die Profil-Identifikatorfelder bei jeder Aktualisierung bei, damit Klaviyo den Datensatz mit dem vorgesehenen Profil verknüpfen kann.

Objekteigenschaften zuordnen

Durch die Zuordnung von Objekteigenschaften kannst du auswählen, welche Informationen innerhalb der Datenquelle innerhalb eines Objekts in Klaviyo verfügbar sein sollen.

Wir empfehlen, Objektdaten über die Object-Ingestion-API in standardisierten Datums- und Zeitstempelformaten zu senden. Wenn der Wert für eine optionale Eigenschaft nicht bekannt ist, kannst du dafür einen Nullwert festlegen.

So ordnen Sie Objekteigenschaften zu:

1. Wenn deine Datenquelle Daten enthält, wähle die Eigenschaft aus, die du aus der Spalte Quelldaten aufnehmen möchtest. Wenn deine Datenquelle leer ist, fahre mit dem nächsten Schritt fort.
2. Gib in der Spalte Zugeordnete Eigenschaft den Namen ein, den die Eigenschaft der Datenquelle im Objekt haben soll. Gib bei einer leeren Datenquelle den Namen in der Spalte Objekteigenschaft ein.
3. Wähle in der Spalte Datentyp den entsprechenden Datentyp der Eigenschaft deiner Datenquelle aus.
4. Aktiviere in der Spalte „Erforderlich“ das Kontrollkästchen, wenn du möchtest, dass diese Eigenschaft im Objekt erforderlich ist.
5. Klicke auf die Schaltfläche Zuordnung hinzufügen , wenn du zusätzliche Objekteigenschaften zuordnen musst.

Verschachtelte Daten in der Zuordnung

Das Eigenschaften-Dropdown enthält verschachtelte Felder aus den geladenen Datenbeispielen. Wenn ein Pfad nicht aufgeführt ist, kannst du ihn manuell eingeben.

Sieh dir zum Beispiel die folgende Datenquelle an.

textCopy

{
  "type": "data-source-record",
  "attributes": {
    "record": {
      "child": {
        "child_id": "d64b8458",
        "name": {
          "first": "Theodore",
          "last": "Customer"
        },
        "birth_date": "2022-04-12",
        "email": "jon.customer@klaviyo.com",
        "phone_numbers": [
              "+11234567899",
              "+13456789123"
        ]
      }
    }      
  }
}

Um auf den Vornamen des Kindes zuzugreifen, wähle oder gib child.name.first ein.

Wenn du ein Array in deinen Quelldaten hast, findest du Eigenschaften, die du nach Position zuordnen kannst. Du könntest zum Beispiel die erste Telefonnummer innerhalb des phone_numbers- Arrays abrufen, indem du [0] am Ende deines Pfads einfügst.

Beziehung hinzufügen

Nachdem du eine Objekt-ID festgelegt und deine Objekteigenschaften zugeordnet hast, klicke auf Weiter, um deinem Objekt eine Beziehung hinzuzufügen.

Beziehungen verbinden dein Objekt mit relevanten Profilen. Definiere die folgenden Informationen, um eine Beziehung festzulegen:

• Name der Beziehung
  Lege einen Namen für deine Beziehung fest. Wenn du z. B. ein Haustierobjekt hast, kannst du den Beziehungsnamen auf einen Wert wie „Haustierbesitzer“ setzen.
• Quelldaten
  Wähle für eine Datenquelle, die Daten enthält, die Eigenschaften aus, die das Profil identifizieren. Dieses Feld wird für eine leere Datenquelle nicht angezeigt.
• Profilkennung
  Wähle die Profilkennung (z. B. E-Mail oder Telefonnummer) für jede Quelleigenschaft aus. Schließe diese Kennungen in die Daten ein, die du sendest, damit das Objekt einem Profil zugeordnet werden kann. Verwende Weitere verknüpfen, um ein weiteres Paar hinzuzufügen, oder Profilkennung hinzufügen, wenn deine Datenquelle leer ist.

Mappings bestätigen und Objekt erstellen

Sobald du die Zuordnung der Objekteigenschaften abgeschlossen und die Beziehung festgelegt hast, klicke oben rechts auf Objekt erstellen. Überprüfe die Warnung und klicke dann im Bestätigungsdialog auf Objekt erstellen. Vorhandene Zuordnungen können nicht mehr bearbeitet werden, sobald das Objekt erstellt wurde, und Klaviyo beginnt mit der Verarbeitung aller Daten, die sich bereits in der Datenquelle befinden.

Klicke auf der Bestätigungsseite auf JSON kopieren, um eine Beispiel-Payload für dein Objekt zu kopieren. Nutze es als Referenz, wenn du deine Daten über die custom object API sendest.

Klicke auf Beenden, um zur Seite Objekte zurückzukehren. Du siehst dein Objekt in der Liste mit den folgenden Informationen:

• Objektname
• Eigentümer
• Status

Status benutzerdefinierter Objekte

Beim Veröffentlichen von custom objects gibt es 3 Hauptstatus:

• Entwurf
  Das Objekt kann weiterhin bearbeitet werden und ist weder veröffentlicht noch aktiv.
• Veröffentlichen
  Das Ziel ist, benutzerdefinierte Objekt-Datensätze aus den Daten zu erstellen, die du an deine Datenquelle gesendet hast. Ein paar Tausend Datensätze können schnell veröffentlicht werden. Ein paar Millionen Datensätze können Stunden dauern. Sobald der Vorgang abgeschlossen ist, ändert sich der Status in Veröffentlicht.
• Veröffentlicht
  Das Objekt ist veröffentlicht und live. Klaviyo hat die Verarbeitung der von deiner Datenquelle gesendeten Daten abgeschlossen. Neue Daten erstellen Datensätze oder aktualisieren Datensätze mit übereinstimmenden Objekt-IDs, und Profil-Identifikatoren bestimmen, mit welchen Profilen sie verknüpft werden.

Objekte auf Profilseiten

Relevante Objekte werden auch auf einer Profilseite angezeigt, damit du die Objektdatensätze anzeigen kannst, die sich auf ein Profil beziehen. Um die Objektdatensätze anzuzeigen, navigiere auf einer Profilseite zur Registerkarte Objekte. Du kannst über das Drop-down-Menü über den Objektkarten zwischen Objekten wechseln.

Um einen vollständigen Objektdatensatz anzuzeigen, wählst du das 3-Punkte-Menü aus und klickst auf Anzeigen. Es erscheint ein Seitenbereich, der den vollständigen Objektdatensatz enthält.

Alle Datensätze in einem Objekt durchsuchen

Um jeden Datensatz in einem Objekt zu durchsuchen, nicht nur die Datensätze, die einem einzelnen Profil zugeordnet sind, verwende den Datensatz-Explorer. Klicke auf Inhalt > Objekte und klicke dann auf den Namen eines Objekts, um den Datensatz-Explorer zu öffnen und seine Datensätze anzuzeigen.

Objekt aktualisieren

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, damit sie enthalten sind. Wenn die Datensätze erneut verarbeitet werden, wird eine neu zugeordnete Eigenschaft befüllt, wenn ihr Wert bereits in den Quelldaten vorhanden war. Andernfalls ist sie null, bis du ein Update sendest, das sie enthält.

Wenn du neue Objekteigenschaften sendest, die noch keinem Objekt zugeordnet wurden, kannst du dein benutzerdefiniertes Objekt aktualisieren, um sie aufzunehmen. Alle Datensätze benutzerdefinierter Objekte werden dann erneut verarbeitet, um diese Daten aufzunehmen.

So aktualisierst du ein Objekt:

1. Klicke in der Klaviyo-Seitenleiste auf Inhalt > Objekte.
2. Öffne das Menü rechts neben dem Objekt, das du bearbeiten möchtest, und klicke auf Bearbeiten.
3. Klicke oben rechts auf Weiter .
4. Klicke unter Objekteigenschaften zuordnen auf Zuordnung hinzufügen. Wenn deine Datenquelle leer ist, ist dieser Abschnitt mit Objekteigenschaften beschriftet.

1. Wähle in der Spalte Quelldaten die Datenquelleneigenschaft aus, die du in dein Objekt aufnehmen möchtest. Wenn deine Datenquelle leer ist, fahre mit dem nächsten Schritt fort.
2. Gib in der Spalte Zugeordnete Eigenschaft den Namen ein, den die Eigenschaft der Datenquelle im Objekt haben soll. Für eine leere Datenquelle verwende die Spalte Objekteigenschaft.
3. Wähle in der Spalte Datentyp den passenden Datentyp für die Eigenschaft deiner Datenquelle aus.

1. Klicke oben rechts auf Weiter .
2. Überprüfe die Beziehungen und klicke dann oben rechts auf Änderungen veröffentlichen. Du musst die Beziehungen nicht ändern, um eine Eigenschaft hinzuzufügen.
3. Klicke im Bestätigungsdialog auf Änderungen veröffentlichen.

Klicke auf Beenden, um zu Objekte zurückzukehren. Nachdem du die Mapping-Änderungen veröffentlicht hast, werden die Datensätze aus deiner Datenquelle erneut verarbeitet und vorhandene Custom-Object-Datensätze entsprechend aktualisiert.

Lösche ein Objekt

So löschen Sie ein Objekt:

1. Klicke in der Klaviyo-Seitenleiste auf Inhalt > Objekte.
2. Klicke im Menü rechts neben deinem Objekt auf Löschen.
   

3. Gib für ein veröffentlichtes Objekt im Bestätigungsdialog DELETE ein, und klicke dann auf Löschen. Klicke bei einem Entwurfsobjekt zur Bestätigung auf Löschen.

Das Objekt und alle zugehörigen benutzerdefinierten Objektdatensätze werden gelöscht.

Wenn du ein neues benutzerdefiniertes Objekt aus der Datenquelle eines vorherigen Objekts erstellst, werden neue benutzerdefinierte Objektdatensätze anhand der Daten generiert, die du bereits synchronisiert hast. Obwohl es dieselben Daten verwendet, wird es als neues Objekt mit neuen Datensätzen betrachtet, sodass alle Segmente, Flows, Vorlagen und Kampagnen aktualisiert werden müssen, um dieses neue Objekt zu verwenden.

Weitere Ressourcen