Häufig gestellte Fragen zu benutzerdefinierten Objekten

Übersicht

Hier findest du häufig gestellte Fragen zu benutzerdefinierten Objekten in Klaviyo. Wenn du deine Frage in der Ressource unten nicht findest, melde dich bitte in unserem Community forum.

Allgemeine Fragen zu Objekten

Brauche ich eine*n Entwickler*in, um ein Objekt zu erstellen?

Du brauchst eine*n Entwickler*in, um benutzerdefinierte Daten über API zu senden. Du kannst die Datenquelle erstellen und das Objekt in Klaviyo konfigurieren.

Kann ich benutzerdefinierte Objekte mit Klaviyo-Formularen oder CSV-Uploads erstellen?

Klaviyo-Formulare und CSV-Uploads senden keine benutzerdefinierten Objekt-Datensätze. Verwende die API, um deine benutzerdefinierten Daten zu senden, und ordne sie dann einem Objekt in Klaviyo zu.

Wann sollte ich ein benutzerdefiniertes Objekt im Vergleich zu einer Profileigenschaft oder einem Ereignis verwenden?

Du solltest benutzerdefinierte Objekte verwenden, wenn du eine Viele-zu-eins-Beziehung zwischen der Kategorie, die dein benutzerdefiniertes Objekt darstellt, und deinen Profilen hast. Wenn du beispielsweise Informationen zu den Haustieren deiner Kund*innen speichern möchtest und deine Kund*innen mehr als ein Haustier haben können, funktioniert es viel besser, diese als benutzerdefiniertes Objekt darzustellen als über Profileigenschaften oder Ereignisse.

Wenn du Elemente wie einen Mitgliedschaftsstatus trackst, bei denen ein Profil jeweils nur einen Status gleichzeitig haben kann, sind Profileigenschaften besser geeignet. Wenn du jedoch auch andere Details zur Mitgliedschaft eines Profils speichern möchtest, kann ein Objekt besser funktionieren.

Wenn du etwas Allgemeines trackst, z. B. wie oft Empfänger*innen eine E-Mail geöffnet haben, empfehlen wir die Verwendung von Events.

Kann ich mein benutzerdefiniertes Objekt nach der Erstellung aktualisieren?

Ja, du kannst nicht erforderliche Eigenschaften bis zum Grenzwert für Objekteigenschaften deines Kontos hinzufügen. Weitere Informationen findest du unter ein benutzerdefiniertes Objekt aktualisieren.

Wann sollte ich ein Ereignis ausgeben statt die Eigenschaften des benutzerdefinierten Objekts zu aktualisieren?

Ereignisse sollen Flows schnell auslösen, sodass du zeitnahe und relevante Nachrichten senden kannst. Wenn sich der Status eines Objekts ändert und du daraufhin eine Nachricht auslösen möchtest, solltest du das Objekt mit den neuen Informationen aktualisieren und uns ein Ereignis senden, um den Flow auszulösen.

Du kannst Vorlagen personalisieren – mit den Objektinformationen im ereignisgetriggerten Flow. Es gibt zwei Möglichkeiten, dies zu erreichen:

1. Füge die Eigenschaften, die du in den Ereignisdaten benötigst, ein und verweise dann in deiner Vorlage darauf. Wenn das Ereignis zum Beispiel eine Eigenschaft pet_name enthält, verwende {{ event.pet_name }}. Das funktioniert gut, wenn Aktualität wichtig ist.
2. Schließe die ID des Objekts in die Ereignisdaten ein und rufe dann das Objekt in der Vorlage ab. Für ein Objekt namens Pet mit einer Eigenschaft Name und einer Ereigniseigenschaft namens pet_id verwende {% customobject event.pet_id object_type_title="Pet" as pet %}{{ pet.Name }}{% endcustomobject %}. Ersetze diese Namen durch die Namen für dein eigenes Objekt, deine Eigenschaft und dein Ereignisfeld. Es kann eine Weile dauern, bis Objektaktualisierungen verfügbar sind. Daher kann eine Flow-Nachricht gesendet werden, bevor das Objekt die neuesten Werte hat.

Fragen zum Senden von Objektdaten

Wie fange ich an, meine Daten für benutzerdefinierte Objekte zu senden?

1. Erstelle eine neue Datenquelle mit unserer API.
2. Definiere deine Datenstruktur mithilfe des Beispiel-JSON in Data-Source-Datensätze massenhaft erstellen.
3. Sende deine Datensatz-Einträge der Datenquelle über die API an Klaviyo.
4. Erstellen dein benutzerdefiniertes Objekt mit dieser Datenquelle. Wähle eine eindeutige Objekt-ID aus und ordne die Eigenschaften zu, die du verwenden möchtest.
5. Erstelle die Beziehung zwischen deinem benutzerdefinierten Objekt und deinen Profilen, indem du die Profil-IDs in deinen Daten zuordnest, z. B. E-Mail-Adresse oder Telefonnummer.
6. Überprüfe deine Zuordnungen, klicke auf Objekt erstellen und klicke dann erneut auf Objekt erstellen, um zu bestätigen.

Wie werden Datenquellen erstellt und verwendet?

Wenn du eine Datenquelle über die API erstellst, gibt Klaviyo als Teil der Antwort auf deine API-Anfrage eine eindeutige Kennung zurück. So kann Klaviyo Datenquellen identifizieren, besonders in Fällen, in denen ein Konto mehrere Datenquellen hat (z. B. 1 für jede benutzerdefinierte Integrationen, ein Data Warehouse oder eine benutzerdefinierte Integrationen eines Drittanbieters, auf die die Marke für ihr Geschäft angewiesen ist).

Mit dieser eindeutigen Kennung kann dein*e Entwickler*in dann Datenquellendatensätze über Klaviyo’s API erstellen.

Wie soll ich meine Daten formatieren?

Dein*e Entwickler*in muss JSON-formatierte Daten an Klaviyo senden. Für eine Eigenschaft mit mehreren Textwerten sende ein Array von Strings und mappe es als Liste (Text). Du kannst diese Werte in Segmenten und im Flow filtern. Weitere Informationen zum Filtern findest du in der Referenz zu Segmentbedingungen.

Unterstützte Datentypen in benutzerdefinierten Objekten:

• Text
• Zahl (ganze Zahl)
• Zahl (Dezimalzahl)
• Timestamp: Datums- und Uhrzeitangaben werden in UTC gespeichert. Ein Wert ohne Zeitzone, z. B. 2025-04-03, wird als 2025-04-03 00:00:00 UTC behandelt. Ein Wert mit einem Offset, z. B. 2025-04-03T00:00:00+03:00, wird in 2025-04-02 21:00:00 UTC konvertiert.
• Boolescher Wert
• Liste (Text)

Liste (Text) unterstützt Arrays aus Strings, z. B. ["dog", "cat"]. Sie unterstützt keine Arrays aus Zahlen, keine verschachtelten Listen und keine Objekte. Ein Beispiel-Payload für die Data-Source-Record-API findest du unter Bulk Create Data Source Records.

Was sind die Datenlimits für benutzerdefinierte Objekte?

Jede zugeordnete benutzerdefinierte Objekteigenschaft kann bis zu 2 KB enthalten, und jeder zugeordnete benutzerdefinierte Objektdatensatz kann bis zu 8 KB enthalten.

Kann ich mit verschachtelten Daten zuordnen?

Wir empfehlen, dein JSON-Objekt so zu definieren, dass die Eigenschaften, die du für dein benutzerdefiniertes Objekt verwenden möchtest, nicht verschachtelt sind. Wähle für verschachtelte Daten eine Eigenschaft aus dem Dropdown-Menü Datenquelleneigenschaft aus oder gib den JSON-Pfad manuell ein. Ordne für eine Liste von Textwerten die Liste selbst als Liste (Text) zu. Um ein einzelnes Element aus einem Array zuzuordnen, verwende seine Position, z. B. [0] für das 1. Element oder [1] für das 2.

Kann ich einem Profil mehrere Identifikatoren zuordnen?

Ja. Wenn du 2 oder mehr Profilkennungen (z. B. E-Mail und Telefonnummer) verwenden möchtest, um deine benutzerdefinierten Objektdatensätze einem Profil zuzuordnen, stelle sicher, dass du beide dieser Eigenschaften in jeder Synchronisierung einschließt, selbst wenn der Wert einer davon null ist. 

Fragen zur Verwendung von Objekten mit Flows

Wenn mein Objekt keinen Flow ausgelöst hat und ich keine Objekt-ID aus einem Ereignis habe, kann ich meine Nachrichten trotzdem personalisieren?

Ja, du kannst Objektfilter verwenden, um beim Personalisieren deiner Nachrichten das richtige Objekt zu finden.

Kann ich Flow-Nachrichten in der Vorschau anzeigen, wenn ein Objekt einen Flow auslöst?

Ja. Du kannst Nachrichten, die in einem datumsgetriggerten Flow auf Basis eines benutzerdefinierten Objekts {{ object }} -Daten verwenden, in der Vorschau anzeigen, bevor du den Flow live schaltest.

So zeigst du eine E-Mail in der Vorschau an:

1. Öffne eine E-Mail in einem datumsgetriggerten Flow basierend auf einem benutzerdefinierten Objekt, und klicke dann im E-Mail-Editor auf Vorschau.
2. Wähle ein Profil aus, das einem Datensatz für dieses Objekt zugeordnet ist, und überprüfe dann die personalisierte Nachricht.

Die Vorschau verwendet ein Beispielobjekt, das mit dem ausgewählten Profil verknüpft ist. Wenn keines verfügbar ist, verwendet sie einen Beispieldatensatz desselben Objekttyps. Überprüfe die angezeigten Werte: Die Vorschau bestätigt nicht, welcher Datensatz den Flow auslösen wird. Wenn keine Datensätze verfügbar sind, gibt es keine Objektdaten für eine Vorschau.

Kann ich meine Objekte mit Flow-Aktionen wie Webhooks und Klaviyo-Code aktualisieren?

Derzeit empfehlen wir, zuerst deine ursprüngliche Datenquelle zu aktualisieren und dann das überarbeitete Objekt im zulässigen Format an Klaviyo zurückzusenden. Wenn diese beiden Systeme nicht mehr synchron sind, riskierst du, einen veralteten Datensatz aus deinem System zurück an Klaviyo zu senden und ihn damit wieder auf den ursprünglichen Wert zurückzusetzen.