Skip to content

Liquid-Referenz

Liquid ist eine Open-Source-Template-Sprache, die von Shopify entwickelt und von Braze für dynamische Personalisierung eingesetzt wird. Anstatt allen dieselbe statische Nachricht zu senden, können Sie mit Liquid Templates erstellen, deren Inhalt sich basierend auf den spezifischen Profildaten, dem Verhalten oder der Sprache der jeweiligen Empfänger:innen anpasst.

Artikel in diesem Abschnitt

    Über Liquid

    Liquid fungiert als Brücke zwischen Ihrer Nachricht und Ihren Nutzerdaten. Wenn Sie eine Nachricht senden, durchsucht Braze den Text nach Liquid-Syntax. Sobald Liquid gefunden wird, werden die relevanten Daten für die jeweilige Nutzer:in abgerufen und der Code durch den tatsächlichen Wert ersetzt, bevor die Nachricht gesendet wird.

    Sie können beispielsweise ein angepasstes Attribut aus einem Nutzerprofil abrufen, das ein ganzzahliger Datentyp ist, und diesen Wert auf die nächste ganze Zahl runden. Weitere Informationen zur Liquid-Syntax und -Verwendung finden Sie unter Unterstützte Personalisierungs-Tags.

    Die Liquid-Template-Sprache unterstützt die Verwendung von Objekten, Tags und Filtern.

    • Objekte ermöglichen es Ihnen, personalisierte Attribute in Ihre Nachrichten einzufügen.
    • Tags ermöglichen es Ihnen, Daten in Nachrichten einzufügen und bedingte Logik zu verwenden, um Nachrichten zu senden, wenn bestimmte Bedingungen erfüllt sind. Sie können Tags beispielsweise nutzen, um intelligente Logik wie „if“-Anweisungen in Ihre Campaigns einzubauen.
    • Filter ermöglichen es Ihnen, personalisierte Attribute und dynamischen Content umzuformatieren. Sie könnten beispielsweise den date-Filter verwenden, um einen Zeitstempel wie 2016-09-07 08:43:50 UTC in ein Datum wie 7. September 2016 umzuwandeln.

    Liquid-5-Unterstützung

    Braze unterstützt Liquid bis einschließlich Liquid 5 von Shopify. Die Liquid-Implementierung unterstützt Syntax-Personalisierungs-Tag-Typen und Whitespace-Kontrolle. Weitere Informationen zu bestimmten Tags finden Sie unter Syntax-Tags.

    Die folgenden neuen Array- und mathematischen Filter stehen Ihnen in Ihrem Liquid beim Erstellen Ihrer Nachrichten zur Verfügung.

    • at_least
    • at_most
    • compact
    • concat
    • sort_natural
    • where

    Definitionen finden Sie unter Filter.

    Wichtige Begriffe

    Diese Begriffe sind basierend auf unserem Unterstützungsumfang aus der Shopify-Dokumentation abgeleitet.

    Begriff Definition Beispiel
    Liquid Eine weit verbreitete, kundenorientierte Template-Sprache, die von Shopify erstellt und in Ruby geschrieben wurde und zum Laden und Abrufen dynamischer Inhalte verwendet wird. {{${first_name}}} fügt den Vornamen einer Nutzer:in in eine Nachricht ein.
    Objekt Eine Bezeichnung für eine Variable und den Ort des beabsichtigten Variablennamens, die Liquid mitteilt, wo Inhalt in der Nachricht angezeigt werden soll. {{${city}}} fügt den Ort einer Nutzer:in in eine Nachricht ein.
    Tag für bedingte Logik Wird verwendet, um Logik zu erstellen und den Fluss des Nachrichteninhalts zu steuern. In Braze werden Tags für bedingte Logik verwendet, um Ausnahmen und Varianten in Nachrichten basierend auf bestimmten, vordefinierten Kriterien zu erstellen. {% if ${language} == 'en' %} triggert Ihre Nachricht auf eine bestimmte Weise, wenn eine Nutzer:in „Englisch“ als Sprache angegeben hat.
    Filter Werden verwendet, um die Ausgabe des Liquid-Objekts zu ändern, einzugrenzen oder umzuformatieren. Häufig werden sie für mathematische Operationen eingesetzt. {{"Big Sale" | upcase}} bewirkt, dass die Wörter „Big Sale“ als „BIG SALE“ in der Nachricht erscheinen.
    Operatoren Werden in Nachrichten verwendet, um Abhängigkeiten oder Kriterien zu erstellen, die beeinflussen können, welche Nachricht Ihre Nutzer:in erhält. Wenn eine Nutzer:in die definierten Kriterien in einer Nachricht mit {% custom_attribute.${Total_Revenue} > 0%} erfüllt, erhält sie die Nachricht. Andernfalls erhält sie eine andere festgelegte Nachricht (oder keine), je nachdem, was Sie eingerichtet haben.


    New Stuff!