Benutzerdefinierte Objekte in Vorlagen
Du musst Zugriff auf benutzerdefinierte Objekte haben, um diese Funktion zu nutzen.
Übersicht
Erfahre, wie du benutzerdefinierte Objekte in Vorlagen verwendest, damit du Objektdaten in Flow- und Kampagnensendungen nutzen kannst.
Du musst ein Objekt erstellen, bevor du benutzerdefinierte Objektdaten in Vorlagen verwenden kannst. Verwende für das Personalisierungsmenü, Objektfilter und Empfänger*innendatensatzlisten ein Objekt mit einer Profil-Beziehung. Die zugehörigen Datensätze müssen mit den Empfänger*innen verknüpft sein, damit sie in deren Nachricht angezeigt werden.
Auf Objektdaten über das Personalisierungsmenü zugreifen
Du kannst Textblöcke im Drag-and-drop-Vorlageneditor mithilfe von Eigenschaften aus einem benutzerdefinierten Objekt oder anhand der Anzahl der Datensätze für ein Objekt personalisieren.
Erfahre mehr darüber, wie du Klaviyos Vorlagen-Editor verwendest.
Wenn du mit einer HTML-Vorlage beginnst, kannst du zuerst eine Drag-and-Drop-Kopie erstellen:
- Navigiere zu Content > Vorlagen und öffne dann E-Mail: gespeichert. Öffne das 3-Punkte-Menü deiner HTML-Vorlage und wähle Klonen, um Drag-and-Drop zu verwenden aus.
- Öffne Konvertierte Vorlagen, um den Fortschritt zu prüfen. Wenn der Status Bereit zur Verwendung ist, klicke auf den Namen der konvertierten Vorlage, um sie zu öffnen.
- Überprüfe das Layout des Textes und die personalisierten Inhalte, bevor du ihn verwendest. Die ursprüngliche HTML-Vorlage bleibt unverändert.
So startest du mit dem Hinzufügen von Objektdaten in deine Vorlagen:
- Füge einen neuen Textblock hinzu oder wähle einen vorhandenen Textblock aus.
- Doppelklicke in den Textblock und positioniere dann den Cursor an der Stelle, an der du deine dynamische Eigenschaft einfügen möchtest.
- Wähle im Text-Toolbalken die Schaltfläche Personalization aus.

- Wähle im Personalisierungsmodal im Dropdown-Menü Alle Typen Objekte aus.

- In Objects siehst du alle Objekte in deinem Konto, die du verwenden kannst, um Daten in die Vorlage zu ziehen. Wähle das Objekt aus, das die Daten enthält, die du in der Vorlage verwenden möchtest.
- Wähle eine Eigenschaft aus, die angezeigt werden soll, oder Anzahl der Objekte, um eine Anzahl anzuzeigen. Wähle als Nächstes einen Objektfilter aus. Du kannst hier auch einen neuen Objektfilter erstellen.
- Klicke auf Einfügen, nachdem du einen vorhandenen Filter ausgewählt hast. Wenn du einen neuen Filter erstellst, wird sein Tag eingefügt, wenn du mit der Erstellung fertig bist.
- Wende alle Textstile an, die du benötigst. Füge für einen Eigenschaftswert Standardtext hinzu, indem du den Tag bearbeitest, sodass er
|default:'value'enthält. Ersetzevaluedurch den Text, den du anzeigen möchtest, wenn die Eigenschaft leer ist.
Um die Regeln für die Groß- und Kleinschreibung für Objektdaten festzulegen, musst du die Regel manuell im Personalisierungs-Tag festlegen. Zum Beispiel verwenden diese Tag das Objekt, das einen datumsbasierten Flow ausgelöst hat:
- {{ object.full_name|title|default:'value' }}
John Doe - {{ object.full_name|upper|default:'value' }}
JOHN DOE - {{ object.full_name|lower|default:'value' }}
john doe
Weitere Informationen zum Ändern von Werten mit Django-Filtern.
Auf Objektdaten mit Personalisierungs-Tags zugreifen
Personalisierungs-Tags können in E-Mails (einschließlich des E-Mail-Betreffs), SMS/MMS-Nachrichten, Push-Benachrichtigungen und im Klaviyo Customer Hub verwendet werden, um Objektdaten anzuzeigen.
Erfahre mehr darüber, wie du Personalisierungs-Tags in Klaviyo verwendest.
Referenz für Objekt-Personalisierungs-Tag
Du kannst die folgenden Personalisierungs-Tags mit Objekten verwenden.
Verwenden des Objekts, das einen Flow ausgelöst hat
{{ object }} ist nur verfügbar, wenn ein Objekt einen Flow ausgelöst hat. Das {{ object }}-Vorlagen-Tag ist nur in datumsgetriggerten Flows basierend auf einem Objekt verfügbar. Dies ist ähnlich wie das {{ event }}-Vorlagen-Tag für eventgetriggerte Flows.
Diese Beispiele verwenden Folgendes:
- Objekt namens Pet , das in der Vorlage mit dem object Tag referenziert wird.
- Objekteigenschaft mit dem Namen Name
Struktur | Beispiel |
{{ object.object_property }} | {{ object.Name }} |
{{ object | lookup:'object_property' }} | {{ object | lookup:'Name' }} |
Ein Objekt nach ID abrufen
Diese Beispiele verwenden Folgendes:
- Objekt namens Pet
- Objekteigenschaft mit dem Namen Name
- Ereignis, das den Flow mit einer Objekteigenschaft namens pet_id ausgelöst hat. Dieses Feld ist identisch mit der Objekt-ID für das Pet -Objekt.
Struktur | Beispiel |
{% customobject event.object_id object_type_title=„Title“ as alias %} | {% customobject event.pet_id object_type_title="Pet" as pet %} |
{% customobject event.object_id object_type_title="Title" as alias %} | {% customobject event.pet_id object_type_title="Haustier" as pet %} |
Gibt ein einzelnes Objekt aus einem Objektfilter zurück
Diese Beispiele verwenden Folgendes:
- Ein zusätzlicher Objektfilter namens oldestDog
- Objekteigenschaft mit dem Namen Name
Struktur | Beispiel |
{{ object_filter.object_filter_name.object_property}} | {{ object_filter.oldestDog.Name }} |
{{ object_filter.object_filter_name | lookup:'object_property' }} | {{ object_filter.oldestDog | lookup:'Name' }} |
Gib eine Ganzzahl aus einem Objektfilter zurück
Diese Beispiele verwenden Folgendes:
- Ein zusätzliches Objektfilter namens countOfDogs
Struktur | Beispiel |
{{ object_filter.object_filter_name }} | {{ object_filter.countOfDogs }} |
Gibt mehrere Objekte aus einem Objektfilter zurück
Für einen Filter mit dem Namen dogs, der mit Mehrfach konfiguriert ist, durchlaufe die übereinstimmenden Datensätze in einer Schleife, um die Eigenschaft Name jedes Haustiers anzuzeigen:
{% for pet in object_filter.dogs %}
{{ pet.Name }}
{% endfor %}
Objektdatensätze abrufen
Verwende customobjects, um bis zu 5 mit dem/der Empfänger*in verknüpfte Datensätze abzurufen, sortiert vom zuletzt hinzugefügten zum ältesten. Durchlaufe diese zurückgegebenen Datensätze in einer Schleife, um ihre Eigenschaften anzuzeigen. Dieses Beispiel verwendet Folgendes:
- Objekt namens Haustierprofil
- Objekteigenschaft namens name
Struktur | Beispiel |
{% customobjects object_type_title="Title" as alias %} | {% customobjects object_type_title="Pet Profile" as pets %} |
Objektdaten in Betreff
Verwende im Betreff dieselbe Syntax für benutzerdefinierte Objekte wie im Nachrichtentext. Diese Beispiele zeigen die Syntax für jede Datenquelle:
{{ object_filter.oldestDog.Name }}zeigt die Eigenschaft „Name“ aus dem Ein-Objekt-Filter oldestDog an.{{ object.Name }}zeigt die Eigenschaft „Name“ des Objekts an, das einen datumsgetriggerten Flow ausgelöst hat.{% customobject event.pet_id object_type_title="Pet" as pet %}{{ pet.Name }}{% endcustomobject %}Sucht einen Pet-Datensatz anhand der ID. Verwende es in einem Flow, der durch ein Ereignis ausgelöst wird, das pet_id enthält.
Verwende zum Beispiel {{ object.Name }} in einem datumsbasierten Flow-Trigger basierend auf dem Objekt „Pet“, um den Namen des Haustiers einer*s Kund*in im Betreff anzuzeigen.
Entwurfsansicht:

E-Mail-Vorschau:
Objektdaten in der Ein-/Ausblenden-Logik
Du kannst auch konfigurieren, ob ein Block in einer Vorlage basierend auf Objektdaten ein- oder ausgeblendet werden soll. Verwende eine Eigenschaft oder Anzahl aus einem Objektfilter oder das Objekt, das einen datumsausgelösten Flow ausgelöst hat. Du kannst Objektdaten in einer einzelnen Einblenden-/Ausblenden-Bedingung oder in der Bedingung für jede Einblenden-/Ausblenden-Logikvariante verwenden. Für Daten, die per ID abgerufen werden, verwende die unten beschriebene erweiterte bedingte Logik.
Du musst Objektfilter erstellen, bevor du in der Ein-/Ausblenden-Logik darauf verweisen kannst.
Wenn du beispielsweise einen datumsgetriggerten Flow verwendest, der auf einem Pet -Objekt basiert, verwende object.Breed == 'Labrador', um einen Block nur dann anzuzeigen, wenn die Breed des auslösenden Pets Labrador ist. Verwende den exakten Rassewert aus deinen Daten.
- Wähle den Block aus und öffne den Tab Anzeige. Wähle unter Ein-/Ausblendlogik Nur einer bestimmten Zielgruppe anzeigen aus oder wähle Für mehrere Zielgruppen personalisieren aus, um Logik-Varianten zu erstellen. Wähle dann Code verwenden aus.
- Gib eine Bedingung wie
object_filter.countOfDogs > 0ein, ohne{{ }}oder{% %}darum herum. Objektfilter können in Kampagnen und Flows verwendet werden. Verwendeobjectnur in einem datumsgetriggerten Flow, der auf Objektdaten basiert. - Klicke auf Speichern, um die Bedingung anzuwenden.

Abschnitte für benutzerdefinierte Objekte unterstützen die Ein-/Ausblenden-Logik nur für eine einzige Zielgruppe. Logikvarianten sind dafür nicht verfügbar. Erfahre mehr über Ein-/Ausblenden-Logikvarianten.
Wenn du mehr Flexibilität möchtest (z. B. um bestimmte Informationen abhängig von den von {% customobject %} oder {% customobjects %} zurückgegebenen Informationen darzustellen), solltest du die Verwendung von erweiterter bedingter Logik mit {% if ... %}-Logik direkt in einem Textblock in Betracht ziehen.
Objektfilter
Was ist ein Objektfilter?
Objektfilter wählen Datensätze aus, die mit jeder Empfänger*in verknüpft sind, anhand von Kriterien, die du festlegst. Du kannst eine Eigenschaft aus 1 übereinstimmenden Datensatz anzeigen, Eigenschaften aus bis zu 10 übereinstimmenden Datensätzen oder eine Anzahl übereinstimmender Datensätze.
Neuen Objektfilter erstellen
So startest du mit dem Erstellen eines Objektfilters:
- Füge deiner Vorlage einen neuen Textblock hinzu oder bearbeite den Text in einem vorhandenen Textblock in deiner Vorlage.
- Wähle die Schaltfläche Personalisierung aus.

- Wähle im Personalisierungsmodal Objekte aus dem Drop-down-Menü Alle Typen aus.
- Wähle das Objekt aus, das die Daten enthält, für die du einen Filter festlegen möchtest.
- Wähle die Eigenschaft aus, die du anzeigen möchtest. Um stattdessen einen Zählfilter zu erstellen, wähle Anzahl der Objekte aus.
- Klicke auf Erstellen, wenn noch keine Filter vorhanden sind. Wenn Filter aufgelistet sind, lasse sie nicht ausgewählt und klicke auf Objektfilter erstellen.
Lege im Modal Objektfilter erstellen die folgenden Informationen fest:
- Name
Gib einen eindeutigen Namen ein, der nur Buchstaben und Zahlen enthält, wie z. B. oldestDog. Verwende keine Leerzeichen oder Sonderzeichen. - Filterbedingungen festlegen
Definiere die Regeln, die ein Objekt erfüllen muss, um im Textblock enthalten zu sein. - Wie viele Objekte sollen angezeigt werden?
Wähle für einen Eigenschaftswert Einzeln für 1 Datensatz oder Mehrere für bis zu 10 Datensätze aus. Zählfilter zeigen diese Einstellung nicht an. - Eigenschaft auswählen und Sortierreihenfolge
Wähle für einen Eigenschaft-Wert-Filter die Eigenschaft aus, die zum Auswählen oder Sortieren von Datensätzen verwendet wird, und wähle dann die Sortierreihenfolge aus. Sortiere beispielsweise nach einer Geburtstagseigenschaft mit Älteste, um das älteste Haustier zuerst auszuwählen. Diese Felder werden bei Zählfiltern nicht angezeigt.

Klicke auf Objektfilter erstellen, um deinen Filter zu speichern und seinen Tag in den Textblock einzufügen.
Sobald dein Objektfilter erstellt ist, kannst du ihn in der Ein-/Ausblenden-Logik und in Personalisierungs-Tags verwenden, um basierend auf den von dir festgelegten Kriterien bestimmte Objektdatensätze anzuzeigen.
Weitere Ressourcen
- 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.
- Leitfaden zur Personalisierung von Nachrichten
Erfahre wie du die Vorlagen-Tags von Klaviyo verwendest, um deinen Kund*innen ein individuelles Erlebnis zu bieten.
- So verwendest du das Vorschaufenster für die Personalisierung von Nachrichten
Erfahre, wie du das Vorschaufenster nutzen kannst, um die für deine Nachrichten verfügbaren Personalisierungsdaten zu verstehen, und wie du auf Vorlagen-Tags zugreifst. Verwende das Vorschau-Modal als zuverlässige Quelle für Personalisierungsoptionen.