Erste Schritte mit benutzerdefinierten Objekten

Übersicht

Erfahre mehr über benutzerdefinierte Objekte, z.B. wie du ein Objekt einrichtest und wie du Objekte in Klaviyo verwenden kannst.

Bevor du anfängst

Du musst Zugriff auf benutzerdefinierte Objekte haben, um diese Funktion nutzen zu können. 

Was sind benutzerdefinierte Objekte?

Benutzerdefinierte Objekte sind eine Art von Datenstruktur in Klaviyo, die dich aktivieren, verschiedene, multirelationale Datenkonzepte in Klaviyo abzubilden, die nicht mit Profileigenschaften geladen werden können. Nehmen wir zum Beispiel an, du willst Daten über Kunde' Haustiere in Klaviyo laden. Jedes Haustier hat eine Reihe von Eigenschaften (z. B. Name, Alter, Rasse). etc.), was es schwierig macht, diese Informationen mit Profileigenschaften zu laden, wenn ein Profil mehrere Haustiere hat. 

Du kannst diese Objektdaten dann in Flow, Vorlage und Segment über Klaviyo verwenden, um dein Marketing besser zu personalisieren. 

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 

Für benutzerdefinierte Objekte gibt es 3 Arten von Kontolimits: 

• Objekt-Limit
  Gesamtzahl der Objekte, die ein Konto haben kann.
• Objekt-Eigenschaftsgrenzen 
  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.

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. 

Von hier aus folgst du den Schritten zum Erstellen und Synchronisieren einer Datenquelle für dein benutzerdefiniertes Objekt. Sobald diese Schritte abgeschlossen sind, wähle die Schaltfläche Benutzerdefiniertes Objekt erstellen , um das Objekt zu 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 repräsentiert
• Datenquelle
  Die Datenquelle, aus der die Objektdaten stammen. Es muss mindestens ein Datensatz über die benutzerdefinierte Objekt-API an Klaviyo gesendet werden, damit er als Option in der Dropdown-Liste erscheint. 

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 Eigenschaft der Datenquelle sein, die verwendet werden kann, um bestimmte Instanzen eines Objektdatensatzes zu identifizieren. Bei einem Geschenkkartenobjekt kannst du zum Beispiel den eindeutigen Rabattcode als Objekt-ID verwenden. Sie ist für jede Instanz der Datenquelle eindeutig und wird für jeden Objektdatensatz existieren. 

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 bestehenden Objektdatensatz aktualisierst, wird das gesamte Objekt ersetzt. Deshalb ist es wichtig, jedes Mal das gesamte Objekt zu senden, auch wenn du nur einen Datensatz aktualisieren willst. 

Angenommen, du möchtest nur 1 von 5 Datensätzen in einem Objekt aktualisieren. Wenn du Daten aktualisieren mit der ID und nur dem 1 Datensatz, den du aktualisieren willst, sendest, werden die anderen 4 Datensätze auf null gesetzt. Wenn eines der neuen Null-Felder in deiner Profil-Beziehung verwendet wurde (z.B. eine Profil-Kennung wie eine E-Mail-Adresse), dann ist das Objekt nicht mehr mit diesem Profil verbunden.

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.

Aus diesem Grund empfehlen wir jedoch, Objektdaten über die Objektaufnahme API in standardisierten Formaten zu senden. Wenn der Wert für eine bestimmte Eigenschaft nicht bekannt ist, kannst du einen Nullwert für sie festlegen.

Um Objekteigenschaften zuzuordnen:

1. Wähle in der Spalte Datenquelleneigenschaft die Datenquelleneigenschaft aus, die du in dein Objekt aufnehmen möchtest. 
2. In der Spalte Zugeordnete Eigenschaft gibst du den Namen ein, den die Eigenschaft der Datenquelle im Objekt haben soll. 
3. Wähle in der Spalte Datentyp den entsprechenden Datentyp deiner Datenquelleneigenschaft aus.
4. Aktiviere in der Spalte Erforderlich das Kontrollkästchen, wenn du möchtest, dass diese Eigenschaft für das Objekt erforderlich ist.
5. Wähle die Schaltfläche Zuordnung hinzufügen , wenn du weitere Objekteigenschaften zuordnen möchtest. 

Verschachtelte Daten im Mapping

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": "Daten-Quellen-Datensatz",
   "attributes": {
   "record": {
    "child_id": "d64b8458",
    "child": { 
     "name": {
      “first”: “Theodore”,
      “last”: “Customer”
     }
    }
    "birth_date": "2022-04-12",
    "E-Mail": "jon.customer@klaviyo.com",
    "Telefon_Nummern": [
     "+11234567899",
     "+13456789123"
    ]
   }
  }
 }
]

Um auf die Daten über den Vornamen eines Kindes zuzugreifen, kannst du den folgenden Pfad eingeben, da die Daten sonst zu weit verschachtelt sind, um über die Schnittstelle darauf zuzugreifen.

Wenn du ein Array in deinen Quelldaten hast, kannst du Eigenschaften finden, die du nach Position zuordnen kannst. Du könntest zum Beispiel die erste Telefonnummer aus dem Array phone_numbers ziehen, indem du [0] am Ende deines Pfades einfügst. 

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: 

• Beziehungsname
  Lege einen Namen für deine Beziehung fest. Wenn du z.B. ein Haustierobjekt hast, kannst du den Namen der Beziehung auf "Haustierbesitzer" setzen. 
• Quelldaten
  Wähle die Eigenschaften der Datenquelle aus, die du mit einem Profil verknüpfen möchtest. 
• Profilkennzeichen
  Lege die Profilkennung fest (z.B. E-Mail, Telefonnummer, etc.). Dieser muss in der Datenquelle enthalten sein, damit ein Objekt mit einem Profil verknüpft werden kann. Benutze die Schaltfläche Eine weitere Eigenschaft verknüpfen , um weitere Eigenschaften und Bezeichnerpaare 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 

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 

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:

1. Klicke auf Inhalt > Objekte in der Klaviyo-Seitenleiste.
2. Wähle den Namen des Objekts aus, das du bearbeiten möchtest. 
3. Klicke in der oberen rechten Ecke auf Weiter .
4. 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.

5. Wähle in der Spalte Datenquelleneigenschaft die Datenquelleneigenschaft aus, die du in dein Objekt aufnehmen möchtest. 
6. In der Spalte Zugeordnete Eigenschaft gibst du den Namen ein, den die Eigenschaft der Datenquelle im Objekt haben soll. 
7. Wähle in der Spalte Datentyp den entsprechenden Datentyp deiner Datenquelleneigenschaft aus.

   Neu zugeordnete Eigenschaften können nicht als erforderlich markiert werden.

   
8. Klicke in der oberen rechten Ecke auf Weiter . 
9. Klicke in der oberen rechten Ecke auf Weiter . Du musst keine Änderungen an deinen Beziehungen vornehmen.
10. 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 

Um ein Objekt zu löschen: 

1. Klicke auf Inhalt > Objekte in der Klaviyo-Seitenleiste.
2. Klicke im Menü auf der rechten Seite deines Objekts 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 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

Wie man benutzerdefinierte Objekte in Flow verwendet

Übersicht über die Custom Objects API