ユーザーに製品をおすすめする

Braze REST API をカタログやコネクテッドコンテンツと組み合わせて使用し、パーソナライズ済みの製品おすすめをメッセージに表示できます。このアプローチにより、独自のレコメンデーションエンジンを Braze のメッセージングエコシステムに接続でき、技術者でないユーザーでも各おすすめに関するコンテンツやメッセージングを管理できます。

このアプローチでは、以下のことが可能です。

• REST API を使用して、バックエンドからユーザープロファイルに製品おすすめを保存する。
• 送信時にカタログまたはコネクテッドコンテンツを使用して製品メタデータを取得する。
• メール、プッシュ、アプリ内メッセージなど、あらゆるメッセージングチャネルでパーソナライズ済みのおすすめを表示する。

前提条件

このガイドを完了するには、以下が必要です。

ステップ 1: ユーザープロファイルにおすすめを保存する

まず、レコメンデーションエンジンが生成した製品おすすめを、カスタム属性として Braze ユーザープロファイルに保存します。これにより、メッセージ送信時に各ユーザーのおすすめ製品を参照できます。

1. 保存するおすすめデータ（製品 ID や好みのカテゴリなど）を決定します。
2. /users/track エンドポイントを使用して、おすすめをユーザープロファイルのカスタム属性として書き込みます。

リクエスト例

1
2
3
POST YOUR_REST_ENDPOINT/users/track
Content-Type: application/json
Authorization: Bearer YOUR_REST_API_KEY

YOUR_REST_ENDPOINT をワークスペースの REST エンドポイント URL に置き換えてください。

1
2
3
4
5
6
7
8
{
  "attributes": [
    {
      "external_id": "user123",
      "recommended_product_id": "1001"
    }
  ]
}

後で Liquid テンプレートで参照しやすいように、わかりやすい属性名（recommended_product_id など）を使用してください。レコメンデーションエンジンが新しい結果を生成するたびに定期的に更新し、おすすめの精度を維持してください。

ステップ 2: 製品メタデータを取得する

各ユーザープロファイルにおすすめの識別子を保存した後、メッセージに含める完全な製品メタデータ（名前、価格、画像など）を取得する必要があります。2つのオプションがあります。

• オプション A: Braze カタログ — 製品情報を Braze に直接保存し、高速な組み込みルックアップを行います。
• オプション B: コネクテッドコンテンツ — 送信時に外部 API から製品情報を取得します。

オプション A: Braze カタログ

製品インベントリを含むカタログを作成済みの場合、Liquid を使用してメッセージ内で直接アイテムを検索できます。詳しい手順については、カタログの使用を参照してください。

特定のカタログアイテムをおすすめする

ID で特定の製品を参照するには、catalog_items Liquid タグを使用します。たとえば、retail_products という名前のカタログから製品 1001 をおすすめするには：

1
2
3
4
5
6
{% catalog_items retail_products 1001 %}

We have a new item we think you'll like:
Category: {{ items[0].category }}
Name: {{ items[0].name }}
Price: ${{ items[0].price }}

複数のカタログアイテムをおすすめする

1つのタグで複数のアイテムを参照することもできます。たとえば、3つの製品を紹介するには：

1
2
3
4
5
6
7
8
{% catalog_items retail_products 1001 1003 1005 %}

New items added in:
- {{ items[0].category }}
- {{ items[1].category }}
- {{ items[2].category }}

Visit our store to learn more!

ユーザーのおすすめを使用してアイテムをテンプレート化する

ステップ 1 のカスタム属性とカタログルックアップを組み合わせて、各ユーザーに合わせたおすすめをパーソナライズします。

1
2
3
4
{% catalog_items retail_products {{custom_attribute.${recommended_product_id}}} %}

Hi {{${first_name}}}, check out our pick for you:
{{ items[0].name }} — ${{ items[0].price }}

オプション B: コネクテッドコンテンツ

製品メタデータが Braze カタログではなく外部サービスにある場合は、コネクテッドコンテンツを使用して送信時に取得します。

たとえば、内部 API が ID で製品詳細を返す場合：

1
2
3
4
{% connected_content https://api.yourcompany.com/products/{{custom_attribute.${recommended_product_id}}} :save product %}

Hi {{${first_name}}}, we think you'll love:
{{ product.name }} — ${{ product.price }}

メッセージからの API 呼び出しの詳細については、API 呼び出しを行うを参照してください。

ステップ 3: 統合を検証する

セットアップが完了したら、統合を検証します。

1. /users/track エンドポイントを使用して、自分のユーザープロファイルにテストおすすめを書き込みます。
2. カタログまたはコネクテッドコンテンツを使用しておすすめ製品を参照するテストメッセージを送信します。
3. 配信されたメッセージで製品詳細が正しく表示されることを確認します。
4. Braze ダッシュボードで、キャンペーンまたはキャンバスの結果ページに移動し、送信が記録されていることを確認します。

考慮事項

• レコメンデーションエンジンが新しい結果を生成するたびにカスタム属性を定期的に更新し、おすすめデータの精度を維持してください。
• Braze のパーソナライゼーション機能を使用して、製品詳細と合わせてユーザー固有のデータを組み込むなど、メッセージをさらにカスタマイズすることを検討してください。
• Braze ダッシュボードで定義されたテンプレートを使用してバックエンドからメッセージをトリガーするために、API トリガー配信の使用を検討してください。