条件付きメッセージング・ロジック

[タグ]7 を使えば、メッセージング・キャンペーンにプログラミング・ロジックを含めることができる。タグは、条件文の実行だけでなく、変数の代入やコードブロックの反復のような高度なユースケースにも使うことができる。

タグは{% %} で囲む必要がある。

1
2
3
{% if X >0 %}
{% else %}
{% endif %}

1
2
3
4
5
{% if {{custom_attribute.${total_spend}}} >0 %}
Thanks for purchasing! Here's another 10% off!
{% else %}
Buy now! Would 5% off convince you?
{% endif %}

条件論理

]1 、条件文のような多くのタイプの[インテリジェント・ロジック]をメッセージに含めることができる。キャンペーンを国際化するために[conditionals]8 ]を使用した次の例を参照のこと：

1
2
3
4
5
6
7
8
9
{% if ${language} == 'en' %}
This is a message in English from Braze!
{% elsif ${language} == 'es' %}
Este es un mensaje en español de Braze !
{% elsif ${language} == 'zh' %}
这是一条来自Braze的中文消息。
{% else %}
This is a message from Braze! This is going to go to anyone who did not match the other specified languages!
{% endif %}

ステップ・バイ・ステップの例

この例では、”if”、”elsif”、”else “ステートメントを持つタグを使って、国際化されたコンテンツを配信している。

1
2
{% if ${language} == 'en' %}
This is a message in English from Braze!

顧客の言語が英語の場合、最初の条件が満たされ、顧客は英語のメッセージを受け取る。

1
2
3
4
{% elsif ${language} == 'es' %}
Este es un mensaje en español de Braze !
{% elsif ${language} == 'zh' %}
这是一条来自Braze的中文消息。

条件文はいくつでも指定できる。前の条件が満たされない場合、次の条件がチェックされる。この例では、顧客のデバイスが英語に設定されていない場合、このコードは顧客のデバイスがスペイン語または中国語に設定されているかどうかを確認する。顧客のデバイスがこれらの条件のいずれかに当てはまる場合、顧客は該当する言語でメッセージを受け取る。

1
2
{% else %}
This is a message from Braze! This is going to go to anyone who did not match the other specified languages!

条件ロジックに{% else %} 。設定した条件のどれにも当てはまらない場合、{% else %} ステートメントで送信すべきメッセージを指定する。この場合、顧客の言語が英語、スペイン語、中国語でない場合、デフォルトは英語になる。

1
{% endif %}

{% endif %} 、条件ロジックが終了したことを知らせる。を含めなければならない。 {% endif %} タグを、条件付きロジックを持つメッセージに使用する。条件ロジックに{% endif %} タグを含めないと、Brazeがメッセージを解析できず、エラーになる。

null、nil、および空白の属性値を処理する

条件ロジックは、ユーザープロファイルに設定されていない属性値を考慮するのに便利な方法である。

NULL および NIL 属性値

nullまたはnil値は、カスタム属性の値が設定されていない場合に発生する。例えば、まだファーストネームを設定していないユーザーは、Brazeにファーストネームが記録されない。

状況によっては、ファーストネームを設定しているユーザーと設定していないユーザーとで、まったく異なるメッセージを送りたい場合もあるだろう。

以下のタグは、”first name “属性がNULLのユーザーに対するメッセージを指定することができる：

1
2
3
{% if ${first_name} == null %}
  ....
{% endif %}

1
2
3
4
5
{% if ${first_name} == null %}
We're having a sale! Hurry up and get 10% off all items today only!
{% else %}
Hey {{${first_name} | default: 'there'}}, we're having a sale! Hurry up and get 10% off all items today only!
{% endif %}

したがって、上の例では、null属性値は設定されていないファーストネームを参照していることになる。

空白の属性値

空白の値は、ユーザープロファイルの属性が設定されていないか、空白文字列（ ）が設定されているか、false として設定されている場合に発生する。リキッド処理エラーを避けるため、ブランク値は他の変数より先にチェックすべきである。

以下のタグは、”first name “属性が空白のユーザーに対するメッセージを指定することができる。

1
2
3
{% if ${first_name} == blank %}
  ....
{% endif %}

カスタム属性を参照する

カスタム属性を作成[]2]したら、リキッドメッセージングでこれらのカスタム属性を参照できる。

条件付きロジックを使用する場合、正しい構文を使用していることを確認するために、カスタム属性のデータ型を知っておく必要がある。ダッシュボードのカスタム属性ページから、カスタム属性に関連するデータタイプを探し、各データタイプに記載されている以下の例を参照する。

ブール値

registration_complete: true はバイナリ値であり、true またはfalse のいずれかに設定することができる。ブール値にはアポストロフィは付かない。

1
{% if {{custom_attribute.${registration_complete}}} == true %}

数値

[]10 は数値であり、整数または浮動小数点数である。例えば、ユーザーはshoe_size: 10 やlevels_completed: 287 を持っているかもしれない。数値にはアポストロフィは付かない。

1
{% if {{custom_attribute.${shoe_size}}} == 10 %}

また、整数に対しては、小なり（<）や大なり（>）といった基本的な演算子も使える：

1
{% if {{custom_attribute.${flyer_miles}}} >= 500 %}

string

文字列]11 は英数字で構成され、ユーザーに関するデータの一部を保存する。例えば、favorite_color: red またはphone_number: 3025981329 。文字列の値にはアポストロフィをつけなければならない。

1
{% if {{custom_attribute.${favorite_color}}} == 'blue' %}

文字列の場合、Liquidでは”==”と “contains “の両方を使うことができる。

配列

配列]12 は、ユーザーに関する情報のリストである。例えば、ユーザーはlast_viewed_shows: stranger things, planet earth, westworld を持っているかもしれない。配列の値はアポストロフィで囲む必要がある。

1
{% if {{custom_attribute.${last_viewed_shows}}} contains 'homeland' %}

配列の場合、”contains “を使わなければならず、”==”は使えない。

時刻

イベントが発生した時刻を示すタイムスタンプ。条件ロジックで使用するには、[Time]13 value must have a [math filter]5 on them.

1
{% assign expire = {{custom_attribute.${subscription_end_date}}} | plus: 0 %}