メッセージングでの項目の推奨事項の使用
おすすめがトレーニングされたら、Liquid を使用して、
product_recommendation
Liquid オブジェクトを直接操作することで、メッセージ内のおすすめ項目をフェッチして表示できます。
ステップバイステップのウォークスルーについては、以下のBraze Learning コースをご覧ください。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}}} %}
次のように置き換えます。
placeholder | 説明 |
---|---|
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] フィールドに以下を追加します。
1
2
{% assign items = {{product_recommendation.${recommendation_name}}} %}
{{ items[0].image_url_field }}
次のように置き換えます。
placeholder | 説明 |
---|---|
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 }}">
次のように置き換えます。
placeholder | 説明 |
---|---|
recommendation_name |
お勧めの名前。 |
image_url_field |
イメージURL を含むカタログ内のフィールドの名前。 |