フィルター

このリファレンス記事では、液体中のフィルターの概要と、ろう付けでサポートされているフィルターのカバーについて説明します。これらのフィルタをどのように使用できるかについてのアイデアを探していますか?液体ユースケースライブラリをチェックしてください。

フィルタは、液体内の数値、文字列、変数、およびオブジェクトの出力を変更する方法です。フィルタを使用して、文字列を小文字から大文字に変更したり、加算や除算などの数学的演算を実行したりするなど、静的テキストまたは動的テキストを再フォーマットできます。

フィルタは、出力タグ{{ }} 内に配置する必要があり、パイプ文字| で示されます。

• input
• output

1
{{"Big Sale" | upcase}}

1
BIG SALE

この例では、Big Sale は文字列で、upcase は適用されているフィルタです。

1つの出力に複数のフィルタを使用できます。それらは左から右に適用されます。

• input
• output

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

1
SALE

配列フィルタ

配列フィルタは、配列の出力を変更するために使用されます。

カラーフィルター

カラーフィルタはブレーズではサポートされていません。

フォントフィルタ

フォントフィルタはブレーズではサポートされていません。

演算フィルタ

演算フィルタを使用すると、数学演算を実行できます。1 つの出力で複数のフィルタを使用する場合、フィルタは左から右に適用されます。

カスタム属性を使用した数学演算

2 つのカスタム属性間で数学演算を実行することはできないことに注意してください。

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

この例は、Liquid の1 行で複数のカスタム属性を参照できないため、機能しません。代わりに、数学関数を実行する前に、これらの値の少なくとも1つに変数を割り当てる必要があります。2 つのカスタム属性を一緒に追加するには、2 行のLiquid が必要です。

1. カスタム属性を変数に割り当てるには、
2. 1 つは加算を実行します。

たとえば、ギフトカード残高と報酬残高を加算して、ユーザーの現在の残高を計算するとします。まず、assign タグを使用して、current_rewards_balance のカスタム属性を”balance” という用語で置き換えます。これは、balance という名前の変数があり、これを操作できることを意味します。

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

次に、plus フィルタを使用して、各ユーザーのギフトカード残高と、{{balance}} オブジェクトで示される報酬残高を組み合わせます。

• 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!

マネーフィルター

購入時のユーザー、口座残高、またはお金に関するものを更新する場合は、マネーフィルターを使用する必要があります。マネーフィルタは、小数点以下の桁数が適切な位置にあること、および更新の一部が失われないことを確認します(末尾のペスキー0 など)。

ShopifyのマネーフィルターとBrazeのマネーフィルター

カスタム属性(account_balance など) を入力する場合は、常にmoney フィルタを使用して、小数点以下の桁数が適切な位置にあること、およびゼロが数字の末尾から削除されないことを確認する必要があります。

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

MONEY FILTER	でMONEY FILTER
ここで、account_balance は17.8 で入力されます。	account_balance は17.8 で入力されます。

Brazeのmoneyフィルタは、プリセット設定に応じて自動的に小数点を適用しない点でShopifyと異なります。たとえば、rewards_redeemed に145 の値が含まれる次のシナリオを考えます。

• input
• output

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

1
$145.00

Shopify のmoney フィルタによれば、これは$1.45 の出力を持つはずですが、Braze では$145.00 の出力を持ちます。回避策として、divided_by フィルタを使用して、マネーフィルタを適用する前に数値を10 進数に操作できます。

• input
• output

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

1
$1.45

文字列フィルタ

文字列フィルタは、文字列の出力と変数を操作するために使用されます。文字列は英数字の組み合わせであり、引用符で囲む必要があります。

追加のフィルター

以下の一般的なフィルタは、コンテンツのフォーマットや変換など、さまざまな目的に役立ちます。

詳細フィルタ ページでは、エンコーディングやURL フィルタなど、サポートされているフィルタを見つけることができます。

日付フィルター

date フィルタを使用して、タイムスタンプを別の日付形式に変換できます。パラメータをdateフィルタに渡して、タイムスタンプを再フォーマットできます。これらのパラメータの例については、strfti.meを参照してください。

たとえば、date_attribute の値がタイムスタンプ2021-06-03 17:13:41 UTC であるとします。

• input
• output

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

1
03 June

strftime フォーマットオプションに加えて、Braze は%s 日付フィルタを使用してタイムスタンプをUnix 時刻に変換することもサポートしています。例えば、Unix 時刻でdate_attribute を取得するには、次のようにします。

• input
• output

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

1
1433351621

タイムゾーンフィルタ

Shopifyのドキュメントに記載されているフィルタに加えて、Brazeはtime_zoneフィルタもサポートしています。

time_zoneフィルタは、時刻、タイムゾーン、日付の形式を取り、指定された日付形式でそのタイムゾーンの時刻を返します。たとえば、{{custom_attribute.$date_attribute}}} の値が2021-08-04 9:00:00 UTC であるとします。

• input
• output

1
{{custom_attribute.${date_attribute} | time_zone: 'America/Los_Angeles' | date: '%a %b %e %T' }}

1
Wed August 4 2:00:00

また、予約変数now を使用して、現在の日付と時刻にアクセスして操作することもできます。

• input
• output

1
{{ 'now' | date: '%Y-%m-%d %H:%M:%S' }}

1
2021-08-04 18:13:13