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 Profildaten, dem Verhalten oder der Sprache der jeweiligen Empfänger:innen anpasst. Verwenden Sie die Artikel in diesem Abschnitt für unterstützte Tags, Filter, bedingte Logik, Standardwerte und gängige Personalisierungsmuster.

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. Wenn Liquid gefunden wird, werden die relevanten Daten für die jeweilige Nutzerin oder den jeweiligen Nutzer abgerufen und der Code durch den tatsächlichen Wert ersetzt, bevor die Nachricht gesendet wird.

    Beispielsweise können Sie ein angepasstes Attribut aus einem Kundenprofil abrufen, das ein Integer-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. Beispielsweise können Sie Tags verwenden, um intelligente Logik wie „if“-Anweisungen in Ihre Campaigns einzubinden.
    • Filter ermöglichen es Ihnen, personalisierte Attribute und dynamischen Content umzuformatieren. Beispielsweise könnten Sie 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 Personalisierungs-Tag-Typen für die Syntax und Whitespace-Kontrolle. Weitere Informationen zu spezifischen Tags finden Sie unter Syntax-Tags.

    Die folgenden neuen Array- und Mathematik-Filter stehen Ihnen zur Verfügung, wenn Sie Ihr Messaging mit Liquid erstellen.

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

    Definitionen finden Sie unter Filter.

    Begriffe, die Sie kennen sollten

    Diese Begriffe wurden aus Shopifys Dokumentation basierend auf unserem Unterstützungsumfang übernommen und angepasst.

    Begriff Definition Beispiel
    Liquid Eine weit verbreitete, nutzerorientierte Template-Sprache, die von Shopify entwickelt und in Ruby geschrieben wurde. Sie wird verwendet, um dynamischen Content zu laden und einzufügen. {{${first_name}}} fügt den Vornamen einer Nutzerin oder eines Nutzers in eine Nachricht ein.
    Objekt Eine Kennzeichnung einer Variablen und des Speicherorts des beabsichtigten Variablennamens, die Liquid mitteilt, wo Content in der Nachricht angezeigt werden soll. {{${city}}} fügt den Ort einer Nutzerin oder eines Nutzers in eine Nachricht ein.
    Tag für bedingte Logik Wird verwendet, um Logik zu erstellen und den Ablauf von Nachrichteninhalten zu steuern. In Braze werden Tags für bedingte Logik verwendet, um Ausnahmen und Variationen in Nachrichten basierend auf bestimmten, vordefinierten Kriterien zu erstellen. {% if ${language} == 'en' %} löst Ihre Nachricht auf eine bestimmte Weise aus, wenn eine Nutzerin oder ein Nutzer „Englisch“ als Sprache festgelegt hat.
    Filter Werden verwendet, um die Ausgabe des Liquid-Objekts zu ändern, einzugrenzen oder umzuformatieren. Sie werden häufig für mathematische Operationen eingesetzt. {{"Big Sale" | upcase}} bewirkt, dass die Wörter „Big Sale“ in der Nachricht als „BIG SALE“ erscheinen.
    Operatoren Werden in Nachrichten verwendet, um Abhängigkeiten oder Kriterien zu erstellen, die beeinflussen können, welche Nachricht Ihre Nutzerin oder Ihr Nutzer erhält. Wenn eine Nutzerin oder ein Nutzer die definierten Kriterien in einer Nachricht mit {% custom_attribute.${Total_Revenue} > 0%} erfüllt, erhält sie oder er die Nachricht. Andernfalls erhält sie oder er eine andere festgelegte Nachricht (oder keine), je nachdem, was Sie eingestellt haben.


    New Stuff!