Benutzerdefinierte Objekte in Vorlagen

Übersicht

Erfahre, wie du benutzerdefinierte Objekte in Vorlagen verwendest, damit du Objektdaten in Flow- und Kampagnensendungen nutzen kannst.

Du musst zuerst ein Objekt erstellen, bevor du benutzerdefinierte Objektdaten in Vorlagen verwenden kannst.

Auf Objektdaten über das Personalisierungsmenü zugreifen

Textblöcke lassen sich im Vorlagen-Editor mit Eigenschaften aus einem benutzerdefinierten Objekt oder mit der Anzahl der Datensätze für ein Objekt personalisieren.

Erfahre mehr darüber, wie du Klaviyos Vorlagen-Editor verwendest.

So startest du mit dem Hinzufügen von Objektdaten in deine Vorlagen:

1. Füge einen neuen Textblock hinzu oder wähle einen vorhandenen Textblock aus.
2. Doppelklicke in den Textblock und platziere dann den Cursor an der Stelle, an der du deine dynamische Eigenschaft einfügen möchtest.
3. Wähle oben rechts die Schaltfläche Personalisierung aus.

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

5. 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.
6. Wähle die spezifische Objekteigenschaft oder den Objektfilter aus, die in die Vorlage aufgenommen werden soll. Hier kannst du auch einen neuen Objektfilter erstellen.
7. Lege den Standardtext und alle Styles für deinen Text fest.

Um die Großschreibungsregeln für Objektdaten festzulegen, musst du die Regel manuell im Personalisierungs-Tag festlegen. Zum Beispiel:

• {{ 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

Diese Beispiele verwenden Folgendes:

• Objekt namens Pet , das in der Vorlage mit dem object Tag referenziert wird. 
• Objekteigenschaft mit dem Namen 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.

Gibt ein einzelnes Objekt aus einem Objektfilter zurück

Diese Beispiele verwenden Folgendes:

• Ein zusätzlicher Objektfilter namens oldest_dog
• Objekteigenschaft mit dem Namen Name

Gib eine Ganzzahl aus einem Objektfilter zurück

Diese Beispiele verwenden Folgendes:

• Ein zusätzlicher Objektfilter namens count_of_dogs

Objektdatensätze abrufen

Um die aktuellsten Objektdatensätze für ein Objekt abzurufen, musst du alle Objektdatensätze durchlaufen. Dieses Beispiel verwendet Folgendes:

• Objekt namens Haustiere

Objektdaten in Betreff

Du kannst deine Betreff mit beliebigen Tags für benutzerdefinierte Objekte personalisieren:

• {% object_filter %}
• {% object %}
• {% customobject %}

Beispielsweise kann im Betreff der Nachricht das {% object %} Tag verwendet werden, um den Namen des Haustiers von Kund*innen direkt anzuzeigen.

Entwurfsansicht:

E-Mail-Vorschau:

Objektdaten in der Ein-/Ausblenden-Logik

Du kannst auch konfigurieren, ob ein Block in einer Vorlage basierend auf Objektdaten angezeigt oder ausgeblendet werden soll. Das dynamische Anzeigen oder Ausblenden eines Blocks basierend auf Objektdaten verwendet dieselben Tags wie der Vorlagen-Builder. Du kannst Objekte nach ID, Eigenschaften aus Objektfiltern oder Aggregationen aus Objektfiltern referenzieren.

Wenn du zum Beispiel ein Pet -Objekt mit einer Eigenschaft namens Breed hast, kannst du mit der Bedingung object.Breed auswählen, dass ein Block nur Tierhalter*innen mit einer bestimmten Hunderasse angezeigt wird.

Um die Ein-/Ausblenden-Logik festzulegen, klicke auf den Block, für den du die Regeln festlegen möchtest, und wähle im Tab Anzeige Code verwenden aus.

Gib die Bedingung direkt im Code-Editor ein. Du kannst Objektfilter und den Vorlagen-Tag für Objekte verwenden, wenn es sich um eine Nachricht für einen datumsgetriggerten Flow handelt, der auf Objektdaten basiert.

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?

Mit Objektfiltern kannst du die zurückgegebenen Objektdatensätze anhand spezifischer Kriterien, die du festlegst, einschränken, sodass du Datensätze eines bestimmten Typs anzeigen kannst.

Neuen Objektfilter erstellen

So startest du mit dem Erstellen eines Objektfilters:

1. Füge deiner Vorlage einen neuen Textblock hinzu oder bearbeite den Text in einem vorhandenen Textblock in deiner Vorlage.
2. Wähle die Schaltfläche Personalisierung aus.

3. Wähle im Personalisierungsmodell im Drop-down-Menü Alle Typen Objekte aus.
4. Wähle das Objekt aus, das die Daten enthält, für die du einen Filter festlegen möchtest.
5. Wähle die Objekteigenschaft aus, für die du einen Filter festlegen möchtest.
6. Wähle Neuen Filter erstellen aus.

Lege im Modal Objektfilter erstellen die folgenden Informationen fest:

• Name
  Erstelle einen Namen für deinen Objektfilter.
• Filterbedingungen
  Lege die Regeln fest, die ein Objekt erfüllen muss, um in den Textblock aufgenommen zu werden.
• Verhalten, wenn mehrere Datensätze die Bedingungen erfüllen
  Definiere das Verhalten für Fälle, in denen mehrere Datensätze die Bedingungen erfüllen.

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