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?

Ja, diese Funktion hängt von der Nutzung von APIs ab, um Datenquellen zu senden und letztlich Objekte zu erstellen.

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

Klaviyo erfordert derzeit, dass Konten neue benutzerdefinierte Objekte erstellen, indem sie uns Daten per API senden.

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.

Beim Tracking von Elementen wie einem Mitgliedschaftsstatus, 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 geeignet sein.

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 deinem benutzerdefinierten Objekt jederzeit zusätzliche, nicht erforderliche Eigenschaften hinzufügen. Weitere Informationen findest du unter 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. Verwende das Tag „ {{ event }}“, um relevante Eigenschaften in den Metadaten deines Events zur Verwendung in deiner Vorlage hinzuzufügen. Das funktioniert gut, wenn Aktualität wichtig ist.
2. Füge die ID des Objekts in die Metadaten des Ereignisses ein. So kannst du das Objekt in der Vorlage mit {% customobject id={{ event.pet_id }} as pet %} abrufen. Es kann jedoch einige Zeit dauern, bis das Objekt mit den neuesten Eigenschaften aktualisiert wird. Daher ist es möglich, dass der Flow eine Nachricht zum Senden ausgelöst hat, bevor das Objekt aktualisiert wurde.

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 (siehe Beispiel-JSON).
3. Sende deine Datensatz-Einträge der Datenquelle über die API an Klaviyo.
4. Erstelle dein benutzerdefiniertes Objekt.
5. Erstelle die Beziehung zwischen deinem benutzerdefinierten Objekt und deinen Profilen.

Wie werden Datenquellen erstellt und verwendet?

Nachdem du eine neue Datenquelle erstellt hast, gibt Klaviyo als Teil der Antwort auf deine API-Anfrage einen eindeutigen Bezeichner zurück. Dadurch kann Klaviyo Datenquellen identifizieren, insbesondere wenn ein Konto mehrere Datenquellen hat (z. B. 1 für jede benutzerdefinierte Integrationen, jedes Data Warehouse oder jede benutzerdefinierte Drittanbieter-Integrationen, auf die sich die Marke für ihr Business verlässt).

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. Wir empfehlen, deine Daten als Text mit einer durch Kommas getrennten Liste zu senden. Du kannst den Operator „enthält“ in der Segmentierung und in den Flow-Filtern verwenden, um nach den Werten in dieser kommagetrennten Zeichenfolge zu filtern. Weitere Informationen zum Filtern findest du in der Referenz zu Segmentbedingungen. 

Unterstützte Datentypen in benutzerdefinierten Objekten:

• Text
• Ganzzahl
• Dezimalzahl
• Datum – Alle Datums- und Uhrzeitangaben werden in unserem System in UTC konvertiert. Wenn du zum Beispiel „2025-04-03“ hochlädst, wird es in „2025-04-03 00:00:00“ umgewandelt. Für Kund*innen mit Zeitzonen, die drei Stunden voraus sind, würde der Datums- und Zeitwert „2025-04-02 21:00:00“ lauten.
• Boolescher Wert

Der Datentyp „Liste“ wird derzeit nicht unterstützt. 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?

Du kannst maximal 2 KB pro Eigenschaft und 8 KB pro gesamtem Datensatz hochladen.

Kann ich mit verschachtelten Daten zuordnen?

Wir empfehlen, dein JSON-Objekt zu definieren, ohne die Eigenschaften zu verschachteln, die du für dein benutzerdefiniertes Objekt verwenden möchtest. Wenn deine Quelldaten tief verschachtelt sind oder eine Liste verwenden, musst du den JSON-Pfad manuell in den Objektmanager eingeben. Bei Listen kannst du eine Eigenschaft nur einer Position innerhalb dieser Liste zuordnen (z. B. dem ersten oder zweiten Wert).

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?

Derzeit ist es nicht möglich, die Vorschaufunktion in der App zu verwenden, um eine Nachricht anzuzeigen, wenn du den Tag {{ object }} verwendest.

So testest du eine Flow-Nachricht:

1. Erstelle einen Flow mit Datumsauslöser und schalte ihn live.
2. Erstelle ein Profil mit einem Objekt, das ein Datum hat, das frühestens in 24 Stunden ausgelöst wird.

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.