Skip to content

メッセージングでアイテムのおすすめを活用する

おすすめのトレーニングが完了したら、Liquidを使用してproduct_recommendation Liquidオブジェクトを直接操作することで、メッセージ内のおすすめアイテムをフェッチして表示できます。

前提条件

メッセージングでおすすめを使用する前に、レコメンデーションエンジンを作成してトレーニングする必要があります。トレーニングには10分から36時間かかります—完了時またはエラー発生時にメールが届きます。

メッセージングでのおすすめの使用

ステップ 1:Liquidコードの追加

おすすめのトレーニングが完了したら、Liquidでメッセージをパーソナライズして、そのカタログで最も人気のある製品を挿入できます。

パーソナライゼーションタイプとしてアイテムのおすすめを使用した「パーソナライゼーションを追加」モーダル

メッセージ作成画面のAdd personalizationセクションからLiquidを生成できます。

  1. パーソナライゼーションをサポートするメッセージ作成画面で、を選択してパーソナライゼーションウィンドウを開きます。
  2. Personalization Typeで、Item Recommendationを選択します。
  3. Item Recommendation Nameで、先ほど作成したおすすめを選択します。
  4. Number of Predicted Itemsで、挿入する上位製品の数を入力します。たとえば、購入数の多い上位3つのアイテムを表示できます。
  5. Information to Displayで、カタログのどのフィールドを各アイテムに含めるかを選択します。各アイテムのこれらのフィールドの値は、このおすすめに関連付けられたカタログから取得されます。
  6. Copyアイコンを選択し、メッセージ内の必要な場所に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:画像を参照する（オプション）

おすすめのカタログに画像リンクが含まれている場合は、メッセージで参照できます。

メールのドラッグ＆ドロップエディターで、メールに画像ブロックを追加し、画像ブロックを選択してImage propertiesを開きます。

ドラッグ＆ドロップエディターの画像プロパティパネル

Image with Liquidを切り替え、Dynamic URLフィールドに以下を追加します（URLフィールドは改行をサポートしていないため、コードが1行で表示されていることを確認してください）：

1

{% assign items = {{product_recommendation.${recommendation_name}}} %}{{ items[0].image_url_field }}

次のように置き換えます：

プレースホルダー 説明
recommendation_name おすすめの名前。
image_url_field 画像URLを含むカタログ内のフィールドの名前。

プレビューおよびテストメールにプレースホルダー画像を含めるには、Choose imageを選択し、メディアライブラリから画像を選択するか、ホスティングサイトの画像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を含むカタログ内のフィールドの名前。
New Stuff!