メッセージングでアイテムのおすすめを活用する
おすすめのトレーニングが完了したら、Liquid を使用して
product_recommendationLiquid オブジェクトを直接操作することで、メッセージ内のおすすめアイテムをフェッチして表示できます。
ステップバイステップのウォークスルーについては、Brazeラーニングコースをご覧ください:Crafting Personalized Experiences with AI。
前提条件
メッセージングでおすすめを使用する前に、レコメンデーションエンジンを作成してトレーニングする必要があります。トレーニングには10分から36時間かかります—完了時またはエラー発生時にメールが届きます。
メッセージングでのおすすめの使用
ステップ 1:Liquid コードの追加
おすすめのトレーニングが完了したら、Liquid でメッセージをパーソナライズして、そのカタログで最も人気のある製品を挿入できます。

メッセージ作成画面のパーソナライゼーションを追加セクションから Liquid を生成できます。
- パーソナライゼーションをサポートするメッセージ作成画面で、 を選択してパーソナライゼーションウィンドウを開きます。
- パーソナライゼーションタイプで、アイテムのおすすめを選択します。
- アイテムのおすすめ名で、先ほど作成したおすすめを選択します。
- 予測アイテム数で、挿入する上位製品の数を入力します。たとえば、購入数の多い上位3つのアイテムを表示できます。
- 表示する情報で、カタログのどのフィールドを各アイテムに含めるかを選択します。各アイテムのこれらのフィールドの値は、このおすすめに関連付けられたカタログから取得されます。
- コピーアイコンを選択し、メッセージ内の必要な場所に Liquid を貼り付けます。
カタログの product_recommendation オブジェクトを参照することで、カスタムの Liquid コードを記述できます。これには、そのカタログのダイナミックに生成されたすべての製品レコメンデーションデータが含まれ、オブジェクトの配列として構造化されます。各オブジェクトはおすすめアイテムを表します。
| 仕様 | 詳細 |
|---|---|
| 構造 | 各アイテムは items[index] としてアクセスされます。インデックスは0(最初のアイテム)から始まり、後続のアイテムごとにインクリメントされます。 |
| カタログフィールド | 配列内の各アイテムには、カタログ内のフィールド(列)に対応するキーと値のペアが含まれます。たとえば、製品レコメンデーションの一般的なカタログフィールドには次のようなものがあります: - name または title- price- image_url |
assign タグを使用して product_recommendation データをフェッチし、変数に割り当てます。
1
{% assign items = {{product_recommendation.${recommendation_name}}} %}
次のように置き換えます:
| プレースホルダー | 説明 |
|---|---|
recommendation_name |
Braze で作成した AI レコメンデーションの名前。 |
items |
おすすめアイテム配列を格納する変数。 |
次に、配列インデックスとドット表記を使用して、特定のアイテムとそのフィールドを参照します:
1
2
{% assign items = {{product_recommendation.${recommendation_name}}} %}
{{ items[0].name }} for {{ items[0].price }}
複数のアイテムを含めるには、各アイテムをインデックスで個別に参照します。.name と .price は、対応するフィールドをカタログからプルします。
1
2
3
4
{% assign items = {{product_recommendation.${recommendation_name}}} %}
{{ items[0].name }} for {{ items[0].price }}
{{ items[1].name }} for {{ items[1].price }}
{{ items[2].name }} for {{ items[2].price }}
AI レコメンデーションは複数の製品を配列として返します。items[0] は最初のアイテム、items[1] は2番目のアイテム、というようになります。レコメンデーションが1つのアイテムのみを返す場合、items[1] を参照しようとすると空のフィールドが返されます。
ステップ 2:画像を参照する(オプション)
おすすめのカタログに画像リンクが含まれている場合は、メッセージで参照できます。
メールのドラッグ&ドロップエディターで、メールに画像ブロックを追加し、画像ブロックを選択して画像のプロパティを開きます。

Liquid を含む画像を切り替え、ダイナミック URL フィールドに以下を追加します(URL フィールドは改行をサポートしていないため、コードが1行で表示されていることを確認してください):
1
{% assign items = {{product_recommendation.${recommendation_name}}} %}{{ items[0].image_url_field }}
次のように置き換えます:
| プレースホルダー | 説明 |
|---|---|
recommendation_name |
おすすめの名前。 |
image_url_field |
画像 URL を含むカタログ内のフィールドの名前。 |
プレビューおよびテストメールにプレースホルダー画像を含めるには、画像を選択を選択し、メディアライブラリーから画像を選択するか、ホスティングサイトの画像 URL を入力します。
HTML 画像参照の場合、画像の src 属性をカタログの画像 URL フィールドに設定します。製品名や説明など、別のフィールドを alt テキストとして使用することもできます。
1
2
{% assign items = {{product_recommendation.${recommendation_name}}} %}
<img src="{{ items[0].image_url_field }}" alt="{{ items[0].name }}">
次のように置き換えます:
| プレースホルダー | 説明 |
|---|---|
recommendation_name |
おすすめの名前。 |
image_url_field |
画像 URL を含むカタログ内のフィールドの名前。 |
GitHub でこのページを編集