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 benötigst? Ein gutes Beispiel ist für Haustiere. Du kannst Profileigenschaften verwenden, um Dinge wie Name, Alter, 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, 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 der Gesamtzahl der aktiven Profile in all deinen Konten. Datensatzlimits werden für alle Konten gemeinsam genutzt, während Objektlimits für jedes Konto separat gelten.

Wenn du z. B. eine Kontogruppe mit 5 untergeordneten Konten hast, bei denen jedes Konto 100.000 aktive Profile hat, sind deine aktiven Profile insgesamt 500.000. Wie das folgende Diagramm zeigt, haben Konten mit mehr als 400.000 Profilen einen Objektdatensatzmultiplikator von 10. Infolgedessen können auf diesen Konten zusammen maximal 5 Millionen Datensätze (500.000 x 10) gespeichert werden. Das bedeutet, dass du 1 Konto mit 3 Millionen Einträgen haben kannst, solange die restlichen 4 Konten weniger als 2 Millionen Objektdatensätze zusammen haben. Was die Anzahl der Objekte pro Konto angeht, kann jedes Konto bis zu fünf Objekte haben, da die kombinierte Profilanzahl über 400.000 liegt.

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

• Maximal 500 Datensätze pro Profil und Objekt.
• Jedes benutzerdefinierte Objekt darf nicht mehr als 8 KB groß sein.
• Jeder Datensatz für benutzerdefinierte Objekte darf nicht mehr als 2 KB enthalten.

Erstelle ein Objekt

Um mit der Erstellung eines Objekts in Klaviyo zu beginnen, navigiere zu Inhalt > 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, klickst du auf das Drop-down-Menü Datenquelle auswählen und dann auf Neue Datenquelle erstellen.

Um eine Datenquelle zu erstellen, musst du die folgenden Informationen festlegen:

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

Lege die Objekt-ID fest

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. Während dieses Schritts kannst du eine Vorschau der Daten anzeigen, die mit der Datenquelle verknüpft sind und über die API für benutzerdefinierte Objekte an Klaviyo gesendet wurden.

Das Festlegen der Objekt-ID ist erforderlich, um Objektdatensätze voneinander zu unterscheiden. Du musst eine Datenquelleneigenschaft angeben, die für die eindeutige Objekt-ID verwendet werden soll.

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 einen bestehenden 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 in deiner Profilbeziehung eines der neuen Nullfelder verwendet wurde (z. B. eine Profilkennung wie eine E-Mail-Adresse), ist das Objekt nicht mehr mit diesem Profil verknüpft.

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 jedoch aus diesem Grund, Objektdaten über die Objektaufnahme-API in standardisierten Datums- und Zeitstempelformaten zu senden. Wenn der Wert für eine bestimmte Eigenschaft nicht bekannt ist, kannst du dafür einen Nullwert festlegen.

So ordnen Sie Objekteigenschaften zu:

1. Wähle in der Spalte Datenquelleneigenschaft die Datenquelleneigenschaft aus, die du in dein Objekt aufnehmen möchtest.
2. Gib in der Spalte Zugeordnete Eigenschaft den Namen ein, den du für die Datenquelleneigenschaft im Objekt verwenden möchtest.
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

Standardmäßig unterstützt die Objektmanager-Schnittstelle eine Verschachtelungsebene. Um auf umfassendere Daten zugreifen zu können, musst du den Pfad deiner Wahl manuell eingeben.

Sieh dir zum Beispiel die folgende Datenquelle an.

text Copy

{
  "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 Daten über den Vornamen eines Kindes zuzugreifen, kannst du den folgenden Pfad eingeben, da die Daten sonst zu weit verschachtelt sind, um mit der Schnittstelle darauf zugreifen zu können.

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, ist der nächste Schritt das Hinzufügen einer Beziehung zu deinem Objekt.

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 die Datenquelleneigenschaften aus, die du einem Profil zuordnen möchtest.
• Profilkennung
  Lege die Profilkennung fest (z. B. E-Mail-Adresse, Telefonnummer usw.). Diese muss in der Datenquelle enthalten sein, damit ein Objekt einem Profil zugeordnet werden kann. Mit der Schaltfläche Andere Eigenschaft verknüpfen kannst du zusätzliche Paare aus Eigenschaft und Kennung hinzufügen.

Mappings bestätigen und Objekt erstellen

Wenn du die Zuordnung der Objekteigenschaften und die Einstellung der Beziehung abgeschlossen hast, bestätige die Zuordnungen im Bestätigungsfenster und klicke auf die Schaltfläche Objekt erstellen. Beachte, dass bestehende Zuordnungen nicht mehr bearbeitet werden können, sobald das Objekt erstellt wurde. Die Synchronisierung der Daten beginnt sofort.

Du siehst dein Objekt auf der Seite „Objekte“in Klaviyo zusammen mit den folgenden Informationen:

• Objektname
• Erstellt am
• Datum der letzten Aktualisierung
• Status

Status benutzerdefinierter Objekte

Beim Veröffentlichen benutzerdefinierter Objekte gibt es drei Statusstatus:

• Entwurf
  Das Objekt kann weiterhin bearbeitet werden und ist weder veröffentlicht noch 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 gesendet hast, kann es Stunden dauern, bis die Veröffentlichung erfolgt ist. Nach Abschluss wird der Status in Aktiv geändert.
• Aktiv
  Das Objekt wird veröffentlicht und ist 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 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.

Objekt aktualisieren

Wenn du mit dem Senden neuer Daten für ein Objekt beginnen möchtest, füge die zusätzlichen Objekteigenschaften zu deiner Datenquelle hinzu und bearbeite dann deine Objektzuordnung, um diese neue Eigenschaft einzuschließen. Alle zuvor erstellten Objekte geben für diese Eigenschaft eine Null zurück, da diese Daten nicht verfügbar sind. In Zukunft werden jedoch Objekte mit dieser Eigenschaft erstellt und aktualisiert.

Wenn du neue Objekteigenschaften sendest, die noch keinem Objekt zugeordnet wurden, kannst du dein benutzerdefiniertes Objekt aktualisieren, um es einzuschließen. Alle benutzerdefinierten Objektdatensätze werden dann erneut verarbeitet, um diese Daten einzuschließen.

So aktualisierst du ein Objekt:

1. Klicke in der Klaviyo-Seitenleiste auf Inhalt > Objekte.
2. Wähle den Namen des Objekts, das du bearbeiten möchtest.
3. Klicke oben rechts auf Weiter .
4. Klicke im Abschnitt Objekteigenschaften zuordnen auf Zuordnung hinzufügen.

1. Wähle in der Spalte Datenquelleneigenschaft die Datenquelleneigenschaft aus, die du in dein Objekt aufnehmen möchtest.
2. Gib in der Spalte Zugeordnete Eigenschaft den Namen ein, den du für die Datenquelleneigenschaft im Objekt verwenden möchtest.
3. Wähle in der Spalte Datentyp den passenden Datentyp für die Eigenschaft deiner Datenquelle aus.

1. Klicke oben rechts auf Weiter .
2. Klicke oben rechts auf Weiter . Du musst keine Änderungen an deinen Beziehungen vornehmen.
3. Klicke auf Änderungen veröffentlichen.

Sobald du diesen Prozess abgeschlossen hast, werden alle Datensätze aus deiner Datenquelle erneut verarbeitet und vorhandene benutzerdefinierte Objektdatensätze werden 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. Klicke erneut auf Löschen , um das Entfernen des Objekts zu bestätigen.
4. 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.