Liquid verwenden

Dieser Artikel zeigt Ihnen, wie Sie verschiedene Nutzerattribute verwenden können, um persönliche Informationen dynamisch in Ihr Messaging einzufügen.

Liquid ist eine Open-Source-Template-Sprache, die von Shopify entwickelt und in Ruby geschrieben wurde. Sie können sie in Braze nutzen, um Nutzerprofildaten in Ihre Nachrichten einzubinden und diese Daten anzupassen. Beispielsweise können Sie Liquid-Tags verwenden, um bedingte Nachrichten zu erstellen, etwa um verschiedene Angebote basierend auf dem Abo-Jubiläumsdatum einer Nutzerin oder eines Nutzers zu versenden. Darüber hinaus können Filter Daten manipulieren, z. B. das Registrierungsdatum einer Nutzerin oder eines Nutzers von einem Zeitstempel in ein besser lesbares Format umwandeln, wie „15. Januar 2022“. Weitere Details zur Liquid-Syntax und ihren Möglichkeiten finden Sie unter Unterstützte Personalisierungs-Tags.

So funktioniert es

Liquid-Tags fungieren als Platzhalter in Ihren Nachrichten, die freigegebene Informationen aus dem Konto Ihrer Nutzer:innen abrufen und Personalisierung sowie relevante Messaging-Praktiken ermöglichen.

Im folgenden Block sehen Sie eine doppelte Verwendung eines Liquid-Tags, um den Vornamen der Nutzerin oder des Nutzers abzurufen, sowie einen Standard-Tag für den Fall, dass kein Vorname hinterlegt ist.

1
Hi {{ ${first_name} | default: 'Valued User' }}, thanks for using the App!

Für eine Nutzerin namens Janet Doe würde die Nachricht entweder so erscheinen:

1
Hi Janet, thanks for using the App!

Oder…

1
Hi Valued User, thanks for using the App!

Wichtig

HTML-Kommentare (<!-- -->) werden entfernt, bevor Liquid gelesen wird. Daher werden Liquid-Tags innerhalb von HTML-Kommentaren nicht in Ihrer Nachricht gerendert. Stellen Sie für eine korrekte Darstellung sicher, dass sich alle Liquid-Tags, die Sie verwenden möchten, außerhalb von HTML-Kommentaren befinden.

Unterstützte Werte zum Ersetzen

Die folgenden Werte können je nach Verfügbarkeit in eine Nachricht eingesetzt werden:

• Grundlegende Nutzerinformationen (z. B. first_name, last_name, email_address)
• Angepasste Attribute
  • Verschachtelte angepasste Attribute
• Angepasste Event-Eigenschaften
• Zuletzt verwendete Geräteinformationen
• Zielgeräteinformationen

Sie können Inhalte auch direkt von einem Webserver über Braze Connected-Content abrufen.

Wichtig

Braze unterstützt derzeit Liquid bis einschließlich Liquid 5 von Shopify.

Liquid verwenden

Mit Liquid-Tags können Sie die Qualität Ihrer Nachrichten steigern, indem Sie ihnen eine persönliche Note verleihen.

Liquid-Syntax

Liquid folgt einer bestimmten Struktur bzw. Syntax, die Sie beim Erstellen dynamischer Personalisierung beachten müssen. Hier sind einige grundlegende Regeln:

1. Verwenden Sie gerade Anführungszeichen in Braze: Es gibt einen Unterschied zwischen typografischen Anführungszeichen (’ ‘) und geraden Anführungszeichen (' '). Verwenden Sie gerade Anführungszeichen (' ') in Ihrem Liquid in Braze. Beim Kopieren und Einfügen aus bestimmten Texteditoren können typografische Anführungszeichen erscheinen, die Probleme in Ihrem Liquid verursachen können. Wenn Sie Anführungszeichen direkt im Braze-Dashboard eingeben, sind Sie auf der sicheren Seite!
2. Klammern kommen paarweise vor: Jede Klammer muss sowohl geöffnet als auch geschlossen werden { }. Achten Sie darauf, geschweifte Klammern zu verwenden!
3. If-Anweisungen kommen paarweise vor: Für jedes if benötigen Sie ein endif, um anzuzeigen, dass die if-Anweisung beendet ist.
4. Case-Anweisungen kommen paarweise vor: Für jedes case benötigen Sie ein endcase, um den Block zu schließen.
5. Variablennamen müssen ASCII-Zeichen verwenden: Liquid-Variablennamen (erstellt mit assign oder capture) unterstützen nur ASCII-Buchstaben, Ziffern und Unterstriche. Braze-Personalisierungsattributnamen (innerhalb von custom_attribute.${...} oder event_properties.${...}) können Nicht-ASCII-Zeichen enthalten.

Wo Operatoren und Filter verwendet werden können

Operatoren (wie ==, !=, >, and, or) und Filter (wie | size, | plus) können jeweils nur in bestimmten Liquid-Kontexten verwendet werden.

Wenn Sie einen gefilterten Wert in einem Kontext benötigen, der keine Filter unterstützt, weisen Sie das Ergebnis zuerst einer Variablen zu.

Ein Filterergebnis in einer Bedingung verwenden

Sie können einen Filter nicht direkt in einer bedingten Anweisung verwenden. Dies ist falsch:

1
2
3
{% if my_array | size > 3 %}
You have more than 3 items!
{% endif %}

Weisen Sie stattdessen das Filterergebnis einer Variablen zu:

1
2
3
4
{% assign array_size = my_array | size %}
{% if array_size > 3 %}
You have more than 3 items!
{% endif %}

Ein Filterergebnis in einer For-Schleife verwenden

Sie können keinen Filter auf das Iterable in einer for-Schleife anwenden. Dies ist falsch:

1
2
3
{% for item in my_array | reverse %}
{{ item }}
{% endfor %}

Weisen Sie stattdessen den gefilterten Wert einer Variablen zu:

1
2
3
4
{% assign reversed = my_array | reverse %}
{% for item in reversed %}
{{ item }}
{% endfor %}

Ein Filterergebnis für den Array-Zugriff verwenden

Sie können keinen Filter innerhalb eckiger Klammern verwenden. Dies ist falsch:

1
{{ my_array[my_var | minus: 1] }}

Weisen Sie stattdessen zuerst den gefilterten Wert zu:

1
2
{% assign adjusted_index = my_var | minus: 1 %}
{{ my_array[adjusted_index] }}

Ein Vergleichsergebnis in einer Variablen speichern

Sie können keinen Operator in einer assign-Anweisung verwenden. Dies ist falsch:

1
2
3
4
{% assign is_vip = total_spend > 100 %}
{% if is_vip %}
Welcome to the VIP lounge!
{% endif %}

Verwenden Sie stattdessen eine Bedingung, um die Variable zu setzen:

1
2
3
4
5
6
7
8
{% assign is_vip = false %}
{% if total_spend > 100 %}
{% assign is_vip = true %}
{% endif %}

{% if is_vip %}
Welcome to the VIP lounge!
{% endif %}

Standardattribute und angepasste Attribute

Wenn Sie den folgenden Text in Ihre Nachricht einfügen: {{${first_name}}}, wird beim Versand der Nachricht der Vorname der Nutzerin oder des Nutzers (aus dem Nutzerprofil abgerufen) eingesetzt. Sie können dasselbe Format mit anderen Standard-Nutzerattributen verwenden.

Wenn Sie den Wert eines angepassten Attributs verwenden möchten, müssen Sie den Namespace „custom_attribute“ zur Variablen hinzufügen. Um beispielsweise ein angepasstes Attribut namens „zip code“ zu verwenden, würden Sie {{custom_attribute.${zip code}}} in Ihre Nachricht einfügen.

Tags einfügen

Sie können Tags einfügen, indem Sie zwei öffnende geschweifte Klammern {{ in einer beliebigen Nachricht eingeben. Dadurch wird eine Autovervollständigungsfunktion ausgelöst, die sich während der Eingabe weiter aktualisiert. Sie können sogar eine Variable aus den Optionen auswählen, die während der Eingabe erscheinen.

Wenn Sie einen angepassten Tag verwenden, können Sie den Tag kopieren und in die gewünschte Nachricht einfügen.

Ausnahmen für doppelte Klammern

Wenn Sie einen Tag innerhalb eines anderen Liquid-Tags verwenden, wie z. B. {% assign %} oder {% if %}, können Sie entweder doppelte Klammern oder keine Klammern verwenden. Nur wenn der Tag allein steht, muss er in doppelte Klammern eingeschlossen werden. Der Einfachheit halber können Sie immer doppelte Klammern verwenden.

Die folgenden Tags sind alle korrekt:

1
2
3
4
5
{% if custom_attribute.${Number_Game_Attended} == 1 %}
{% if {{custom_attribute.${Number_Game_Attended}}} == 1 %}

{% assign value_one = {{custom_attribute.${one}}} %}
{% assign value_one = custom_attribute.${one} %}

Hinweis

Wenn Sie Liquid in Ihren E-Mail-Nachrichten verwenden, achten Sie darauf:

1. Es über den HTML-Editor einzufügen, nicht über den klassischen Editor. Der klassische Editor kann Liquid als Klartext interpretieren. Beispielsweise würde Liquid als Hi {{ ${first_name} }}, thanks for using our service! angezeigt, anstatt den Vornamen der Nutzerin oder des Nutzers einzusetzen.
2. Liquid-Code nur innerhalb des <body>-Tags zu platzieren. Eine Platzierung außerhalb dieses Tags kann bei der Zustellung zu inkonsistenter Darstellung führen.

Zwischen HTML- und klassischem Editor wechseln

Wenn Sie zwischen dem HTML- und dem klassischen Editor wechseln, können Liquid-Snippets und Content Blocks ihre Position in Ihrer Nachricht verschieben. Überprüfen Sie Ihr Template nach dem Wechsel des Editors. Wenn Sie eine besser vorhersagbare Layout-Kontrolle benötigen, verwenden Sie den Drag-and-Drop-Editor.

Vorformatierte Variablen einfügen

Sie können vorformatierte Variablen mit Standardwerten über das Modal Personalisierung hinzufügen einfügen, das sich neben jedem Template-Textfeld befindet.

Das Modal fügt Liquid mit Ihrem angegebenen Standardwert an der Stelle ein, an der sich Ihr Cursor befand. Die Einfügestelle wird auch durch das Vorschaufeld angezeigt, das den Text davor und danach enthält. Wenn ein Textblock markiert ist, wird der markierte Text ersetzt.