液体を使用する
メッセージングに個人情報を動的に挿入するために使用できるさまざまなユーザー属性があります。
メッセージに次のテキストを含めると{{${first_name}}}
、メッセージが送信されるときに、(ユーザーのプロファイルから取得された)ユーザーの名が置き換えられます。カスタム属性の値を使用する場合は、変数に名前空間「custom_attribute」を追加する必要があります。たとえば、「zip code」という名前のカスタム属性を使用するには、{{custom_attribute.${zip code}}}
メッセージに含めます。
使用可能な値に応じて、次の値をメッセージに置き換えることができます。
- 基本ユーザー情報 (例:
first_name
、last_name
、email_address
) - カスタム属性
- カスタムイベントプロパティ
- 最近使用したデバイス情報
- ターゲットデバイス情報
Braze Connected Content経由でウェブサーバーから直接コンテンツを取得することもできます。
Brazeは現在、Shopifyのリキッド5までのリキッドをサポートしています。
液体を使用する
使用可能なLiquidタグがわかったら、Liquidを使用するとメッセージのパーソナライゼーションを驚くほど高めることができます。Liquidタグはメッセージ内のプレースホルダーとして機能し、ユーザーのアカウントから同意した情報を引き出し、パーソナライズや適切なメッセージングプラクティスを可能にします。
次のブロックでは、ユーザーのファーストネームを呼び出すためのLiquidタグと、ユーザーがファーストネームを登録しない場合のデフォルトタグを二重に使用していることがわかります。
1
Hi {{ ${first_name} | default: 'Valued User' }}, thanks for using the App!
Janet Doe という名前のユーザーには、メッセージは次のいずれかとして表示されます。
1
Hi Janet, thanks for using the App!
または
1
Hi Valued User, thanks for using the App!
リキッド構文
Liquidは特定の構造または構文に従っているため、動的パーソナライゼーションを作成する際に留意する必要があります。覚えておくべき基本的なルールは次のとおりです。
- Braze ではストレートクォートを使う:カーリークォート (’’) とストレートクォート (‘‘) には違いがあります。リキッド・イン・ブレイズではストレートクォート (’‘) を使用してください。特定のテキストエディターからコピーして貼り付けるときにカーリークォートが表示されることがあり、Liquidで問題が発生する可能性があります。Braze ダッシュボードに見積もりを直接入力する場合は問題ありません。
- ブラケットはペアになっています。すべての括弧は {} を開いたり閉じたりする必要があります。必ず中括弧を使用してください!
- ステートメントがペアになっている場合:いずれの場合も
if
、endif
if
ステートメントが終了したことを示すにはが必要です。
タグを挿入する
任意のメッセージに2つの開いた中括弧を入力することでタグを挿入できます。これにより、{{
入力中に更新され続けるオートコンプリート機能が起動します。入力時に表示されるオプションから変数を選択することもできます。
カスタムタグを使用している場合は、タグをコピーして任意のメッセージに貼り付けることができます。
メールメッセージでLiquidを使用する場合は、次の点を確認してください。
- 従来のエディターではなく、HTML エディターを使用して挿入します。クラシックエディターはLiquidをプレーンテキストとして解析することがあります。
<body>
Liquidコードはタグ内にのみ配置してください。このタグの外に配置すると、配信時にレンダリングに一貫性がなくなる可能性があります。
事前にフォーマットされた変数
テンプレート化されたテキストフィールドの右上にある「パーソナライゼーション属性の挿入」モーダルを使用して、事前にフォーマットされた変数をデフォルトで挿入できます。
モーダルは、カーソルが置かれた位置に、指定されたデフォルト値でLiquidを挿入します。挿入ポイントはプレビューボックスでも指定できます。プレビューボックスには変更前と変更後のテキストが表示されます。テキストのブロックが強調表示されている場合、強調表示されたテキストが置き換えられます。
![パーソナライゼーションを挿入] をクリックした後に表示されるパーソナライゼーションモーダルを追加。モーダルにはパーソナライゼーションタイプ、属性、オプションのデフォルト値のフィールドがあり、Liquid構文のプレビューが表示されます。] 45
変数を割り当てる
Liquidの一部の操作では、操作したい値を変数として保存する必要があります。これは、Liquidステートメントに複数の属性、イベントプロパティ、またはフィルターが含まれている場合によく見られます。
たとえば、2 つのカスタムデータ整数を加算するとします。以下を単純に使用することはできません。
1
{{custom_attribute.${one}}} | plus: {{custom_attribute.${two}}}
このLiquidは、1行で複数の属性を参照できないため機能しません。数学関数を実行する前に、これらの値の少なくとも1つに変数を割り当てる必要があります。2 つのカスタム属性を追加するには、2 行の Liquid が必要です。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!
すべてのメッセージに同じ変数を割り当てていることに気づきましたか?assign
タグを何度も書き出す代わりに、そのタグをコンテンツブロックとして保存し、代わりにメッセージの上部に配置できます。
- コンテンツブロックを作成します。
- コンテンツブロックに名前を付けます (スペースや特殊文字は使用しないでください)。
- ページの下部にある [編集] をクリックします。
assign
タグを入力します。
コンテンツブロックがメッセージの上部にある限り、変数がオブジェクトとしてメッセージに挿入されるたびに、選択したカスタム属性が参照されます。