パーソナライゼーション用ダッシュボードツール
Brazeのダッシュボードツールを使用すると、すべてのタグを手動で記述することなくLiquidパーソナライゼーションを挿入できます。パーソナライゼーションを追加フローが適切な構文を自動生成し、Liquidエディターがテンプレートの読み取りと拡張を素早くサポートします。
Liquidの構文ルール、サポートされているタグ、高度なパターンについては、Liquidの使用およびサポートされているパーソナライゼーションタグを参照してください。
コンポーザーと設定でパーソナライゼーションを追加する
パーソナライゼーションを追加ツールは、ダッシュボード全体のテンプレート対応テキストフィールドの近くに表示されます。以下のような場所で利用できます:
- キャンペーンとキャンバスのステップ：本文やヘッダーでLiquidをサポートするチャネル（メール、プッシュ、SMS、アプリ内メッセージ、Content Cards、webhookなど）。
- ドラッグ＆ドロップエディター：コントロールはブロックやエディターのツールバーに配置されていることが多いです。たとえば、ドラッグ＆ドロップのアプリ内メッセージでは、パーソナライゼーションを追加を選択し、パーソナライゼーションタイプを選んでから、生成されたスニペットをコンテンツに配置し、プレビューとテストでプレビューできます。チャネル固有の詳細については、各チャネルのドラッグ＆ドロップまたはコンポーザーの記事をご覧ください（アプリ内メッセージのスタイル設定やドラッグ＆ドロップでメールを作成するなど）。
- 専用コンポーザー：パーソナライゼーションピッカーを備えたもの。たとえば、アイテムレコメンデーションでは、同じスタイルのウィンドウ内でパーソナライゼーションタイプのオプション（アイテムレコメンデーションなど）を使用します。
- ランディングページ：ドラッグ＆ドロップエディターやページおよびブロックの設定でLiquidパーソナライゼーションを追加できます。詳細については、ランディングページをパーソナライズするをご覧ください。
事前にフォーマットされた変数とデフォルト値を挿入する
パーソナライゼーションを追加ツールを使用すると、オプションのデフォルト値を含むLiquidを挿入でき、プロファイルデータが空でもコピーが崩れないようにできます。
このツールは、カーソルがあった位置に、指定されたデフォルト値を含むLiquidを挿入します。挿入位置はプレビューボックスにも表示され、前後のテキストが確認できます。テキストブロックがハイライトされている場合、ハイライトされたテキストが置き換えられます。
多くのコンポーザーでは{{と入力してオートコンプリートを使用したり、他の場所からタグを貼り付けたりすることもできます。詳細については、Liquidの使用のタグの挿入を参照してください。
変数の割り当て
Liquidの一部の操作では、操作したい値を変数として保存する必要があります。これは、Liquidステートメントに複数の属性、イベントプロパティ、またはフィルターが含まれる場合によく発生します。
例えば、2つのカスタムデータ整数を合算したいとします。
不正なLiquidの例
以下のコードは使用できません：
{{custom_attribute.${one}}} | plus: {{custom_attribute.${two}}}
このLiquidは、1行で複数の属性を参照できないため機能しません。数学関数が実行される前に、これらの値の少なくとも1つに変数を割り当てる必要があります。2つのカスタム属性を加算するには、2行のLiquidが必要です。1行目でカスタム属性を変数に割り当て、2行目で加算を実行します。
正しいLiquidの例
以下のコードを使用できます：
{% assign value_one = {{custom_attribute.${one}}} %}
{% assign result = value_one | plus: {{custom_attribute.${two}}} %}
チュートリアル：変数を使用して残高を計算する
ギフトカード残高と報酬残高を加算して、ユーザーの現在の残高を計算しましょう。
まず、assignタグを使用して、カスタム属性current_rewards_balanceを「balance」という用語に置き換えます。これにより、操作可能なbalanceという名前の変数が作成されます。
{% assign balance = {{custom_attribute.${current_rewards_balance}}} %}
次に、plusフィルターを使用して、各ユーザーのギフトカード残高と{{balance}}で示される報酬残高を合算します。
{% assign balance = {{custom_attribute.${current_rewards_balance}}} %}
You have ${{custom_attribute.${giftcard_balance} | plus: {{balance}}}} to spend!
毎回同じ変数をすべてのメッセージで割り当てていませんか？assignタグを何度も書く代わりに、そのタグをコンテンツブロックとして保存し、メッセージの先頭に配置することができます。
- コンテンツブロックを作成します。
- コンテンツブロックに名前を付けます（スペースや特殊文字は使用不可）。
- ページの下部にある編集を選択します。
assignタグを入力します。
コンテンツブロックがメッセージの先頭にある限り、変数がオブジェクトとしてメッセージに挿入されるたびに、選択したカスタム属性を参照します。
Liquidエディターの拡張機能
これらのダッシュボード機能により、メッセージの作成中にLiquidをより簡単に扱えるようになります。
カラーラベル
各Liquid要素には色が対応しており、Liquidエディターで各Liquidを一目で区別できます。
予測Liquid
パーソナライズされたメッセージを作成する際に、カスタム属性や属性名などの予測Liquidを使用することもできます。
