Filter

Dieser Referenzartikel bietet eine Übersicht über Filter in Liquid und behandelt, welche Filter von Braze unterstützt werden. Sie suchen nach Ideen, wie Sie diese Filter einsetzen können? Schauen Sie sich unsere Liquid-Anwendungsfallbibliothek an.

Filter ermöglichen es Ihnen, die Ausgabe von Zahlen, Strings, Variablen und Objekten in Liquid zu verändern. Sie können Filter verwenden, um statischen oder dynamischen Text umzuformatieren, z. B. um einen String von Kleinbuchstaben in Großbuchstaben umzuwandeln oder mathematische Operationen wie Addition oder Division durchzuführen.

Wichtig

Braze unterstützt nicht alle Liquid-Filter von Shopify. Diese Seite versucht, die Liquid-Filter aufzulisten, die Braze getestet hat, aber es handelt sich möglicherweise nicht um eine vollständige Liste. Testen Sie Ihr Liquid immer, bevor Sie Nachrichten versenden.

Wenn Sie Fragen zu einem Filter haben, der hier nicht aufgeführt ist, wenden Sie sich an Ihren Customer-Success-Manager.

Filter-Syntax

Filter müssen innerhalb eines Ausgabe-Tags {{ }} platziert werden und werden durch ein Pipe-Zeichen | gekennzeichnet.

• input
• output

1
{{"Big Sale" | upcase}}

1
BIG SALE

In diesem Beispiel ist Big Sale ein String und upcase der angewendete Filter.

Hinweis

Filter können in assign-Anweisungen und Ausgabe-Tags ({{ }}) verwendet werden, aber nicht in Bedingungen (if, elsif, unless), case/when, for-Schleifen oder Array-Zugriffsklammern. Um einen gefilterten Wert in einem dieser Kontexte zu verwenden, weisen Sie das Ergebnis zuerst einer Variablen zu. Weitere Details finden Sie unter Wo Operatoren und Filter verwendet werden können.

Syntax für mehrere Filter

Sie können mehrere Filter auf eine Ausgabe anwenden. Sie werden von links nach rechts angewendet.

• input
• output

1
 {{ "Big Sale" | upcase | remove: "BIG" }}

1
SALE

Array-Filter

Array-Filter werden verwendet, um die Ausgabe von Arrays zu verändern.

Farbfilter

Farbfilter werden in Braze nicht unterstützt.

Schriftfilter

Schriftfilter werden in Braze nicht unterstützt.

Mathematische Filter

Mathematische Filter ermöglichen es Ihnen, mathematische Operationen durchzuführen. Wenn Sie mehrere Filter auf eine Ausgabe anwenden, werden sie von links nach rechts angewendet.

Tipp

Wenn Sie in Liquid ganze Zahlen (Ganzzahlen) durch ganze Zahlen teilen und das Ergebnis eine Gleitkommazahl (Zahl mit Dezimalstelle) ist, rundet Liquid automatisch auf die nächste ganze Zahl ab. Wenn Sie jedoch ganze Zahlen durch Gleitkommazahlen teilen, erhalten Sie immer eine Gleitkommazahl. Das bedeutet, Sie können Ihre ganzen Zahlen in Gleitkommazahlen umwandeln (1.0, 2.0, 3.0), um eine Gleitkommazahl als Ergebnis zu erhalten.

Zum Beispiel gibt {{15 | divided_by: 2}} den Wert 7 aus, während {{15 | divided_by: 2.0}} den Wert 7.5 ausgibt.

Mathematische Operationen mit angepassten Attributen

Beachten Sie, dass Sie keine mathematischen Operationen zwischen zwei angepassten Attributen durchführen können.

1
{{custom_attribute.${current_rewards_balance} | plus: {{custom_attribute.${giftcard_balance}}}}}

Dieses Beispiel würde nicht funktionieren, da Sie nicht mehrere angepasste Attribute in einer einzigen Liquid-Zeile referenzieren können. Stattdessen müssten Sie mindestens einem dieser Werte eine Variable zuweisen, bevor die mathematischen Funktionen ausgeführt werden. Das Addieren zweier angepasster Attribute erfordert zwei Zeilen Liquid:

1. Eine, um das angepasste Attribut einer Variablen zuzuweisen,
2. Eine, um die Addition durchzuführen.

Anwendungsfall: Aktuellen Kontostand berechnen

Nehmen wir an, wir möchten den aktuellen Kontostand einer Nutzerin oder eines Nutzers berechnen, indem wir das Guthabenkarten-Guthaben und das Rewards-Guthaben addieren.

1. Verwenden Sie den assign-Tag, um das angepasste Attribut current_rewards_balance durch den Begriff „balance“ zu ersetzen. Das bedeutet, dass Sie jetzt eine Variable namens balance haben, die Sie bearbeiten können.

1
{% assign balance = {{custom_attribute.${current_rewards_balance}}} %}

2. Verwenden Sie den plus-Filter, um das Guthabenkarten-Guthaben jeder Nutzerin und jedes Nutzers mit dem Rewards-Guthaben zu kombinieren, dargestellt durch das {{balance}}-Objekt.

• input
• output

1
2
{% assign balance = {{custom_attribute.${current_rewards_balance}}} %}
You have ${{custom_attribute.${giftcard_balance} | plus: {{balance}}}} to spend!

1
You have $35 to spend!

Geldfilter

Wenn Sie Nutzer:innen über ihren Kauf, einen Kontostand oder irgendetwas im Zusammenhang mit Geld informieren, sollten Sie Geldfilter verwenden. Geldfilter stellen sicher, dass Ihre Dezimalstellen an der richtigen Stelle stehen und kein Teil Ihres Updates verloren geht (wie die lästige 0 am Ende).

Wichtig

Um eine Zahl mit dem money-Filter korrekt zu formatieren, entfernen Sie alle Kommas in der Zahl und fügen Sie den plus: 0-Filter vor dem money-Filter hinzu. Sehen Sie sich zum Beispiel das folgende Liquid an:

1
2
{% assign my_int = "350000.25" | plus: 0 %}
{{ my_int | money }}

Shopify-Geldfilter versus Braze-Geldfilter

Warnung

Das Verhalten des Shopify-money-Filters unterscheidet sich von der Verwendung in Braze. Beachten Sie die folgenden Beispiele für eine genaue Darstellung des erwarteten Verhaltens.

Wenn Sie ein angepasstes Attribut eingeben (wie account_balance), sollten Sie immer den money-Filter verwenden, um Ihre Dezimalstellen an die richtige Stelle zu setzen und zu verhindern, dass Nullen am Ende von Zahlen abgeschnitten werden:

1
${{custom_attribute.${account_balance} | money}}

MIT DEM GELDFILTER	OHNE DEN GELDFILTER
Wobei account_balance mit 17.8 eingegeben wird.	Wobei account_balance mit 17.8 eingegeben wird.

Der money-Filter in Braze unterscheidet sich von Shopify, da er nicht automatisch Dezimalpunkte gemäß einer voreingestellten Einstellung anwendet. Nehmen wir zum Beispiel das folgende Szenario, in dem rewards_redeemed den Wert 145 enthält:

• input
• output

1
${{event_properties.${rewards_redeemed} | money }}

1
$145.00

Gemäß dem Shopify-money-Filter sollte die Ausgabe $1.45 sein, in Braze wird die Ausgabe jedoch $145.00 sein. Als Workaround können wir den divided_by-Filter verwenden, um die Zahl in eine Dezimalzahl umzuwandeln, bevor der Geldfilter angewendet wird:

• input
• output

1
${{event_properties.${rewards_redeemed} | divided_by: 100.00 | money }}

1
$1.45

String-Filter

String-Filter werden verwendet, um die Ausgaben und Variablen von Strings zu bearbeiten. Strings sind eine Kombination aus alphanumerischen Zeichen und müssen in gerade Anführungszeichen eingeschlossen werden.

Hinweis

Gerade Anführungszeichen unterscheiden sich von typografischen Anführungszeichen in Liquid. Seien Sie vorsichtig, wenn Sie Liquid aus einem Texteditor in Braze kopieren und einfügen, da typografische Anführungszeichen Fehler in Ihrem Liquid verursachen. Wenn Sie Ihr Liquid direkt in Braze schreiben, werden gerade Anführungszeichen automatisch angewendet.

Zusätzliche Filter

Die folgenden allgemeinen Filter dienen vielen Zwecken, einschließlich der Formatierung oder Konvertierung von Inhalten.

Weitere unterstützte Filter, wie Encoding- und URL-Filter, finden Sie auf unserer Seite Erweiterte Filter.

Datumsfilter

Der date-Filter kann verwendet werden, um einen Zeitstempel in ein anderes Datumsformat umzuwandeln. Sie können Parameter an den date-Filter übergeben, um den Zeitstempel umzuformatieren. Beispiele für diese Parameter finden Sie unter strfti.me.

Nehmen wir zum Beispiel an, dass der Wert von date_attribute der Zeitstempel 2021-06-03 17:13:41 UTC ist.

• input
• output

1
{{custom_attribute.${date_attribute} | date: '%b %d'}}

1
03 June

Zusätzlich zu den strftime-Formatierungsoptionen unterstützt Braze auch die Konvertierung eines Zeitstempels in Unix-Zeit mit dem %s-Datumsfilter. Um zum Beispiel date_attribute in Unix-Zeit zu erhalten:

• input
• output

1
{{custom_attribute.${date_attribute} | date: '%s' }}

1
1433351621