Unterstützte Personalisierungs-Tags

Dieser Referenzartikel enthält eine vollständige Liste der unterstützten Liquid-Personalisierungs-Tags.

Zusammenfassung der unterstützten Tags

Zur besseren Übersicht finden Sie hier eine Zusammenfassung der unterstützten Personalisierungs-Tags. Für weitere Details zu den einzelnen Tag-Typen und Best Practices lesen Sie bitte weiter.

Hinweis

API-Trigger-Eigenschaften müssen zwei geschweifte Klammern pro Tag verwenden: {{api_trigger_properties.${your_api_trigger_property}}}. Dreifache Klammern (zum Beispiel {{{...}}}) sind keine gültige Braze-Personalisierungssyntax. Siehe Warum schlägt mein API-getriggertes Liquid in Braze fehl?.

Unterstützte Attribute

Campaign-, Card- und Canvas-Attribute werden nur in ihren entsprechenden Messaging-Templates unterstützt. Zum Beispiel wird dispatch_id in Liquid für Messaging-Kanäle wie E-Mail, Push, SMS und WhatsApp unterstützt, jedoch nicht für In-App-Nachrichten oder Banner.

Weitere Details finden Sie unter Campaign- und Canvas-Attribute über verschiedene Quellen hinweg.

Unterschiede zwischen Canvas- und Campaign-Tags

Das Verhalten der folgenden Tags unterscheidet sich zwischen Canvas und Campaigns:

• Das Verhalten von dispatch_id unterscheidet sich, da Braze Canvas-Schritte als getriggerte Ereignisse behandelt, auch wenn sie „geplant“ sind (mit Ausnahme von Entry-Schritten, die geplant werden können). Weitere Informationen finden Sie unter Dispatch-ID-Verhalten.
• Die Verwendung des {{campaign.${name}}}-Tags mit Canvas zeigt den Namen der Canvas-Komponente an. Bei der Verwendung dieses Tags mit Campaigns wird der Campaign-Name angezeigt.

Campaign-Namen in URLs

Campaign- und Nachrichtenvarianten-Namen können Zeichen enthalten, die nicht URL-sicher sind, wie %, Leerzeichen oder &. Wenn Sie {{campaign.${name}}} oder {{campaign.${message_name}}} in einen Link oder Query-String einfügen, z. B. als utm_campaign-Parameter, wenden Sie den url_encode-Filter an, damit die URL korrekt geparst wird. Zum Beispiel:

1
https://example.com/?utm_campaign={{ campaign.${name} | url_encode }}

Informationen zum zuletzt verwendeten Gerät

Sie können die folgenden Attribute für das zuletzt verwendete Gerät der Nutzer:innen über alle Plattformen hinweg als Template verwenden. Wenn Nutzer:innen Ihre Anwendung nicht verwendet haben (z. B. wenn Sie die Nutzer:innen über die REST API importiert haben), sind alle diese Werte null.

Da es eine große Bandbreite an Mobilfunkanbietern, Modellnamen und Betriebssystemen gibt, empfehlen wir Ihnen, jedes Liquid gründlich zu testen, das bedingt von einem dieser Werte abhängt. Diese Werte sind null, wenn sie auf einem bestimmten Gerät nicht verfügbar sind.

Informationen zur Ziel-App

Für In-App-Nachrichten können Sie die folgenden App-Attribute in Liquid verwenden. Die Werte basieren darauf, welchen SDK-API-Schlüssel Ihre Apps verwenden, um Messaging anzufordern.

Dieser Liquid-Code bricht beispielsweise eine Nachricht ab, wenn die anfragenden Apps nicht einem der beiden API-Schlüssel in der Liste entsprechen:

1
2
3
4
5
6
{% assign allowed_api_keys = 'sdk_api_key_1,sdk_api_key_2' | split: ',' %}
{% if allowed_api_keys contains {{app.${api_id}}} %}
User is in list of apps
{% else %}
{% abort_message("User not in list of apps") %}
{% endif %}

Informationen zum Zielgerät

Für Push-Benachrichtigungen, In-App-Nachrichten und Banner können Sie die folgenden Attribute für das Gerät, das die Nachricht empfängt, als Template verwenden. Eine Push-Benachrichtigung, In-App-Nachricht oder ein Banner kann Attribute des Geräts enthalten, auf dem die Nutzer:innen die Nachricht lesen. Diese Attribute funktionieren nicht für Content Cards oder E-Mails. Bei E-Mails werden Nachrichten vor dem Versand gerendert, sodass das Gerät, auf dem die Nutzer:innen die E-Mail öffnen, zu diesem Zeitpunkt unbekannt ist.

Da es eine große Bandbreite an Mobilfunkanbietern, Modellnamen und Betriebssystemen gibt, empfehlen wir Ihnen, jede Logik, die bedingt von einem dieser Werte abhängt, gründlich zu testen. Diese Werte sind null, wenn sie auf einem bestimmten Gerät nicht verfügbar sind.

Darüber hinaus ist es bei Push-Benachrichtigungen möglich, dass Braze unter bestimmten Umständen das mit der Push-Benachrichtigung verknüpfte Gerät nicht ermitteln kann, z. B. wenn das Push-Token über die API importiert wurde, was dazu führt, dass die Werte für diese Nachrichten null sind.

Bedingte Logik anstelle eines Standardwerts verwenden

Unter bestimmten Umständen können Sie sich dafür entscheiden, bedingte Logik anstelle eines Standardwerts zu verwenden. Bedingte Logik ermöglicht es Ihnen, Nachrichten zu senden, die sich je nach Wert eines angepassten Attributs unterscheiden. Zusätzlich können Sie bedingte Logik verwenden, um Nachrichten an Kund:innen mit null- oder leeren Attributwerten abzubrechen.

Anwendungsfall

Nehmen wir beispielsweise an, Sie senden eine Benachrichtigung über den Rewards-Kontostand an Kund:innen. Es gibt keine gute Möglichkeit, Kund:innen mit niedrigen und null-Kontoständen mithilfe von Standardwerten zu berücksichtigen.

In diesem Fall gibt es zwei Optionen, die besser funktionieren können als das Setzen eines Standardwerts:

1. Brechen Sie die Nachricht für Kund:innen mit niedrigen, null- und leeren Kontoständen ab.

   1
   2
   3
   4
   5
   {% if {{custom_attribute.${balance}}} > 0 %}
   Your rewards balance is {{custom_attribute.${balance}}}
   {% else %}
   {% abort_message() %}
   {% endif %}
   

2. Senden Sie eine völlig andere Nachricht an diese Kund:innen, wie zum Beispiel:

   1
   2
   3
   4
   5
   {% if ${first_name} != blank and ${first_name} != null %}
   Hello {{${first_name} | default: 'there'}}, thanks for downloading!
   {% else %}
   Thanks for downloading!
   {% endif %}
   

In diesem Anwendungsfall erhält eine Nutzer:in mit einem leeren oder null-Vornamen die Nachricht „Thanks for downloading“. Sie sollten einen Standardwert für den Vornamen einfügen, um sicherzustellen, dass Ihre Kund:innen im Falle eines Fehlers kein Liquid sehen.

Variablen-Tags

Sie können den assign-Tag verwenden, um eine Variable im Nachrichten-Editor zu erstellen. Wir empfehlen, einen eindeutigen Namen für Ihre Variable zu verwenden. Wenn Sie eine Variable mit einem ähnlichen Namen wie die unterstützten Personalisierungs-Tags erstellen (z. B. language), kann dies Ihre Messaging-Logik beeinträchtigen.

Nachdem Sie eine Variable erstellt haben, können Sie diese Variable in Ihrer Messaging-Logik oder Nachricht referenzieren. Dieser Tag ist besonders nützlich, wenn Sie Inhalte umformatieren möchten, die von unserem Connected-Content-Feature zurückgegeben werden. Weitere Informationen finden Sie in der Shopify-Dokumentation zu Variablen-Tags.

Wichtig

Strings, die innerhalb eines assign-Tags in einfache Anführungszeichen eingeschlossen sind, werden als literale Strings behandelt. Liquid-Personalisierungs-Tags innerhalb einfacher Anführungszeichen werden nicht interpoliert. Zum Beispiel:

1
2
{% assign name_intro = 'My name is {{${first_name}}}' %}
{{ name_intro }}

Dies gibt den literalen Text My name is {{${first_name}}} aus, anstatt den Vornamen der Nutzer:innen.

Um Personalisierung einzubeziehen, verwenden Sie Variablen oder verketten Sie Strings mit dem append-Filter. Für URL-Templating mit Personalisierung lesen Sie den Abschnitt Link-Templates.

Tipp

Weisen Sie in jeder Nachricht dieselben Variablen zu? Anstatt den assign-Tag immer wieder auszuschreiben, können Sie diesen Tag als Content-Block speichern und ihn stattdessen an den Anfang Ihrer Nachricht setzen.

1. Erstellen Sie einen Content-Block.
2. Geben Sie Ihrem Content-Block einen Namen (ohne Leerzeichen oder Sonderzeichen).
3. Wählen Sie Bearbeiten am unteren Rand der Seite.
4. Geben Sie Ihre assign-Tags ein.

Solange sich der Content-Block am Anfang Ihrer Nachricht befindet, verweist die Variable jedes Mal, wenn sie als Objekt in Ihre Nachricht eingefügt wird, auf Ihr gewähltes angepasstes Attribut.

Anwendungsfall

Nehmen wir an, Sie erlauben Ihren Kund:innen, ihre Rewards-Punkte gegen Preise einzulösen, nachdem sie 100 Rewards-Punkte gesammelt haben. Sie möchten also nur Kund:innen ansprechen, deren Punktestand größer oder gleich 100 wäre, wenn sie diesen zusätzlichen Kauf tätigen würden:

1
2
3
4
5
6
{% assign new_points_balance = {{custom_attribute.${current_rewards_balance} | plus: 50}} %}
{% if new_points_balance >= 100 %}
Make a purchase to bring your rewards points to {{new_points_balance}} and cash in today!
{% else %}
{% abort_message('not enough points') %}
{% endif %}

Iterations-Tags

Iterations-Tags können verwendet werden, um einen Codeblock wiederholt auszuführen. Der folgende Anwendungsfall zeigt den for-Tag.

Anwendungsfall

Nehmen wir an, Sie haben einen Sale auf Nike-Sneaker und möchten Kund:innen ansprechen, die Interesse an Nike gezeigt haben. Sie haben ein Array von Produktmarken, die im Profil jeder Kund:in angesehen wurden. Dieses Array könnte bis zu 25 Produktmarken enthalten, aber Sie möchten nur Kund:innen ansprechen, die ein Nike-Produkt als eines ihrer 5 zuletzt angesehenen Produkte betrachtet haben.

1
2
3
4
5
6
7
8
9
10
{% for items in {{custom_attribute.${Brands Viewed}}} limit:5 %}
{% if {{items}} contains 'Converse' %}
{% assign converse_viewer = true %}
{% endif %}
{% endfor %}
{% if converse_viewer == true %}
Sale on Converse!
{% else %}
{% abort_message() %}
{% endif %}

In diesem Anwendungsfall prüfen wir die ersten fünf Einträge im Array der angesehenen Sneaker-Marken. Wenn einer dieser Einträge „Converse“ ist, erstellen wir die Variable converse_viewer und setzen sie auf „true“.

Anschließend senden wir die Sale-Nachricht, wenn converse_viewer den Wert „true“ hat. Andernfalls brechen wir die Nachricht ab.

Dies ist ein einfaches Beispiel dafür, wie Iterations-Tags im Braze-Nachrichten-Editor verwendet werden können. Weitere Informationen finden Sie in der Shopify-Dokumentation zu Iterations-Tags.

Syntax-Tags

Syntax-Tags können verwendet werden, um zu steuern, wie Liquid gerendert wird. Sie können den echo-Tag verwenden, um einen Ausdruck zurückzugeben. Dies entspricht dem Umschließen eines Ausdrucks mit geschweiften Klammern, außer dass Sie diesen Tag innerhalb von Liquid-Tags verwenden können. Sie können auch den liquid-Tag verwenden, um einen Liquid-Block ohne Trennzeichen für jeden Tag zu erstellen. Jeder Tag muss in einer eigenen Zeile stehen, wenn Sie den liquid-Tag verwenden. Weitere Informationen und Beispiele finden Sie in der Shopify-Dokumentation zu Syntax-Tags.

Mit Whitespace-Kontrolle können Sie Leerzeichen um Ihre Tags entfernen und so die Liquid-Ausgabe noch besser kontrollieren.

HTTP-Statuscodes

Sie können den HTTP-Status eines Connected-Content-Aufrufs nutzen, indem Sie ihn zunächst als lokale Variable speichern und dann den Schlüssel __http_status_code__ verwenden. Zum Beispiel:

1
2
3
4
{% connected_content https://example.com/api/endpoint :save connected %}
{% if connected.__http_status_code__ != 200 %}
{% abort_message('Connected Content returned a non-200 status code') %}
{% endif %}

Hinweis

Dieser Schlüssel wird dem Connected-Content-Objekt nur automatisch hinzugefügt, wenn der Endpunkt ein JSON-Objekt zurückgibt. Wenn der Endpunkt ein Array oder einen anderen Typ zurückgibt, kann dieser Schlüssel nicht automatisch in der Antwort gesetzt werden.

Nachrichten basierend auf Sprache, letztem Gebietsschema und Zeitzone senden

In manchen Situationen möchten Sie möglicherweise Nachrichten senden, die auf bestimmte Gebietsschemas zugeschnitten sind. Beispielsweise unterscheidet sich brasilianisches Portugiesisch in der Regel von europäischem Portugiesisch.

Anwendungsfall: Lokalisierung basierend auf dem letzten Gebietsschema

Hier ist ein Anwendungsfall, wie Sie das letzte Gebietsschema verwenden können, um eine internationalisierte Nachricht weiter zu lokalisieren.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
{% if ${language} == 'en' %}
Message in English
{% elsif  ${language} == 'fr' %}
Message in French
{% elsif  ${language} == 'ja' %}
Message in Japanese
{% elsif  ${language} == 'ko' %}
Message in Korean
{% elsif  ${language} == 'ru' %}
Message in Russian
{% elsif ${most_recent_locale} == 'pt_BR' %}
Message in Brazilian Portuguese
{% elsif ${most_recent_locale} == 'pt_PT' %}
Message in European Portuguese
{% elsif  ${language} == 'pt' %}
Message in default Portuguese
{% else %}
Message in default language
{% endif %}

In diesem Anwendungsfall erhalten Kund:innen mit dem letzten Gebietsschema pt_BR eine Nachricht in brasilianischem Portugiesisch, und Kund:innen mit dem letzten Gebietsschema pt_PT erhalten eine Nachricht in europäischem Portugiesisch. Kund:innen, die die ersten beiden Bedingungen nicht erfüllen, aber deren Sprache auf Portugiesisch eingestellt ist, erhalten eine Nachricht in dem von Ihnen gewünschten Standard-Portugiesisch.

Anwendungsfall: Nutzer:innen nach Zeitzone ansprechen

Sie können Nutzer:innen auch nach ihrer Zeitzone ansprechen. Senden Sie beispielsweise eine Nachricht, wenn sie sich in der EST-Zeitzone befinden, und eine andere, wenn sie in der PST-Zeitzone sind. Speichern Sie dazu die aktuelle Uhrzeit in UTC und vergleichen Sie mit einer if/else-Anweisung die aktuelle Uhrzeit der Nutzer:innen, um die richtige Nachricht für die richtige Zeitzone zu senden. Sie sollten die Campaign so einstellen, dass sie in der Ortszeit der Nutzer:innen gesendet wird, damit sie die Campaign zur richtigen Zeit erhalten.

Im folgenden Anwendungsfall sehen Sie, wie Sie eine Nachricht verfassen, die zwischen 14:00 und 15:00 Uhr zugestellt wird, mit einer spezifischen Nachricht für jede Zeitzone.

1
2
3
4
5
6
7
8
{% assign hour_in_utc = 'now' | date: '%H' | plus:0 %}
{% if hour_in_utc >= 19 && hour_in_utc < 20 %}
It is between 2:00:00 pm and 2:59:59 pm ET!
{% elsif hour_in_utc >= 22 && hour_in_utc < 23 %}
It is between 2:00:00 pm and 2:59:59 pm PT!
{% else %}
{% abort_message %}
{% endif %}

Nachrichten mit einer Zufallszahl senden

Der {% random %}-Tag gibt eine Zufallszahl zurück. Sie können ihn für A/B-Logik, Stichproben oder die Variation von Nachrichteninhalten verwenden.

Anwendungsfall: Nutzer:innen zufällige Varianten senden

1
2
3
4
5
6
7
{% capture roll_str %}{% random %}{% endcapture %}
{% assign roll = roll_str | plus: 0 %}
{% if roll < 0.5 %}
Show variant A
{% else %}
Show variant B
{% endif %}

E-Commerce-Warenkorb-Tag

Der shopping_cart-Tag greift auf den Warenkorbinhalt von Nutzer:innen in E-Commerce-Canvas-Anwendungsfällen für Warenkorb-Abbruch und Checkout-Abbruch zu. Ersetzen Sie CART_ID durch den tatsächlichen Warenkorb-ID-Wert, wie z. B. {{context.${cart_id}}}.

1
{% shopping_cart CART_ID :abort_if_not_abandoned false %}

Der Parameter abort_if_not_abandoned in diesem Beispiel gilt nur für den Anwendungsfall Checkout-Abbruch, wenn er mit dem Ereignis ecommerce.checkout_started verwendet wird. Er ist nicht auf Warenkorb-Abbruch-Anwendungsfälle anwendbar. Weitere Details finden Sie unter abort_if_not_abandoned.