液体を使用

メッセージングに個人情報を動的に挿入するために使用できる、さまざまなユーザー属性がある。

メッセージに以下のテキストを含める：{{${first_name}}}を含めると、メッセージ送信時にユーザーのファーストネーム（ユーザーのプロフィールから取得）が代入される。カスタム属性の値を使いたい場合は、変数に名前空間 “custom_attribute “を追加しなければならない。例えば、”zip code “というカスタム属性を使うには、メッセージに{{custom_attribute.${zip code}}} 。

以下の値は、メッセージに代入することができる：

• 基本ユーザー情報（例えば、first_name 、last_name 、email_address ）。
• カスタム属性
• カスタムイベントプロパティ
• 最近使用されたデバイス情報
• ターゲット・デバイス情報

また、BrazeConnected Contentを使ってウェブサーバーから直接コンテンツを引き出すこともできる。

液体の使用

Liquidのタグが利用できることを知れば、Liquidを使うことでメッセージのパーソナライゼーションを印象的な高みに引き上げることができる。リキッドタグはメッセージのプレースホルダーとして機能し、ユーザーのアカウントから同意した情報を取り込み、パーソナライゼーションと適切なメッセージングを可能にする。

次のブロックでは、ユーザーのファーストネームを呼び出すリキッドタグと、ユーザーがファーストネームを登録しない場合のデフォルトタグの二重の使い方を見ることができる。

1
Hi {{ ${first_name} | default: 'Valued User' }}, thanks for using the App!

ジャネット・ドウというユーザーには、メッセージは次のように表示される：

1
Hi Janet, thanks for using the App!

あるいは…

1
Hi Valued User, thanks for using the App!

液体構文

リキッドは特定の構造（シンタックス）に従っており、動的パーソナライゼーションを作成する際には、これを念頭に置く必要がある。ここで、いくつかの基本的なルールを覚えておこう：

1. ブレイズではストレートクォートを使う：カーリークオート（’‘）とストレートクオート（’‘）には違いがある。BrazeのLiquidにはストレートクォート(‘‘)を使う。特定のテキストエディタからコピー＆ペーストするとき、カール引用符が表示されることがある。Brazeのダッシュボードに直接見積もりを入力するのであれば、問題ないだろう！
2. ブラケットは2個1組である：すべてのブラケットは、{ }の開閉両方が必要である。必ず中括弧を使うこと！
3. ステートメントが対になっている場合：if に対し、if ステートメントが終了したことを示すendif が必要である。

タグを挿入する

どのメッセージでも、{{ を2つ入力することでタグを挿入することができる。このタグを入力すると、自動補完機能が作動し、入力した内容が更新され続ける。入力中に表示されるオプションから変数を選択することもできる。

カスタムタグを使用している場合は、そのタグをコピーして好きなメッセージに貼り付けることができる。

フォーマット済み変数

テンプレート化されたテキスト・フィールドの右上にある “パーソナライゼーション属性の挿入 “モーダルによって、デフォルトであらかじめフォーマットされた変数を挿入することができる。

モーダルは、カーソルがあった位置に、指定したデフォルト値でリキッドを挿入する。挿入位置はプレビュー・ボックスでも指定でき、プレビュー・ボックスには前後のテキストが表示される。テキストブロックがハイライトされている場合、ハイライトされたテキストは置き換えられる。

変数を割り当てる

Liquidのいくつかの操作では、操作したい値を変数として格納する必要がある。リキッドステートメントに複数のアトリビュート、イベントプロパティ、フィルターが含まれる場合、このようなケースになることが多い。

例えば、2つのカスタムデータの整数を足し合わせたいとしよう。単純に使うことはできない：

1
{{custom_attribute.${one}}} | plus: {{custom_attribute.${two}}}

なぜなら、1行で複数の属性を参照することができないからだ。数学関数が実行される前に、これらの値の少なくとも1つに変数を代入する必要がある。カスタム属性を2つ追加するには、2行のリキッドが必要になる。1つはカスタム属性を変数に代入すること、もう1つは追加を実行することだ。

チュートリアルだ：変数を使用してバランスを計算する

ギフトカードの残高とリワードの残高を足して、ユーザーの現在の残高を計算してみよう：

まず、assign タグを使って、current_rewards_balance のカスタム属性を “balance “という言葉に置き換える。つまり、balance という変数ができたことになる。

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

次に、plus フィルタを使って、各ユーザーのギフトカード残高と、{{balance}} で示されるリワード残高を結合する。

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