AI 項目のレコメンデーションの作成
カタログ内のアイテムからAI レコメンドエンジンを作成する方法について説明します。
AI 項目の推奨事項について
AI 項目の推奨事項を使用して、最も人気のある製品を計算したり、特定のカタログ に対してカスタマイズされたAI 推奨事項を作成したりします。おすすめを作成した後、パーソナライゼーションを使用してメッセージにそれらの商品を挿入できます。
AI でパーソナライズされたおすすめは、数百から数千のアイテムがあり、通常は購入またはインタラクションデータを持つユーザーが 30,000 人以上いる場合に最も効果的です。これはあくまでも目安であり、様々です。他の推奨タイプは、より少ないデータで動作できます。
Plan-specific AI features
The following table describes the differences between the free and pro version of the AI Personalized, Popular, and Trending recommendation types:
| Area | Free version | Pro version |
|---|---|---|
| User update frequency1 | Weekly | Daily |
| Model retraining frequency | Monthly | Weekly |
| Maximum recommendation models | 1 model per type2 | 100 models per type2 |
1. This is the frequency at which user-specific item recommendations are updated (all models except Most Popular items, which updates when the model retrains). For example, if a user purchases an item recommended based on AI item recommendations, their recommended items will be updated according to this frequency
2. Available recommendation types are AI Personalized, Most recent, Most popular, and Trending.
AI によるアイテムのおすすめの作成
前提条件
始める前に、以下の作業を完了しておく必要があります。
- 以下に説明する推奨タイプを使用するには、少なくとも1 つのcatalog が必要です。
- Braze 上に、カタログに保存されている一意の商品 ID への参照を含む購入データまたはイベントデータ (カスタムイベントまたは購入オブジェクト) があること。
ステップ1:新しいレコメンデーションを作成する
ダッシュボードのいずれかの場所からAI アイテムの推奨を作成できます。
個々のカタログから直接おすすめを作成することもできます。[カタログ] ページからカタログを選択し、[レコメンデーションを作成] を選択します。
ステップ2:おすすめの詳細を追加する
おすすめに名前と説明 (オプション) を付けます。
!“推薦の詳細 “ステップに名前と説明のフィールドを追加する。
ステップ 3: おすすめを定義する
推奨タイプを選択します。各タイプは、過去6か月間のインタラクションデータ (購入またはカスタムイベントデータなど) を使用します。それぞれの詳細な情報と使用例については、Types and Uses Casesを参照してください。
[最新] または [AI によるパーソナライズ] を使用する場合、パーソナライズされたおすすめを作成するためのデータが不十分なユーザーには、フォールバックとして 「最も人気がある」アイテムが表示されます。[最も人気がある] フォールバックを受信したユーザーの割合は、[分析] ページに表示されます。
ステップ 3.1:事前の購入やインタラクションを除外する (オプション)
ユーザーが既に購入したアイテムや、ユーザーが既に使用したアイテムを推薦しないようにするには、[ユーザーが以前に操作したアイテムをおすすめとして表示しない] を選択します。このオプションは、おすすめの [タイプ] が [AI によるパーソナライズ] に設定されている場合にのみ使用できます。
!AIパーソナライズされた “をタイプとして選択し、”ユーザーが過去に使用したことのあるアイテムは勧めない “オプションを選択する。
この設定により、おすすめが最近更新された場合、ユーザーがすでに購入したアイテムやインタラクションしたアイテムがメッセージングに再利用されるのを防ぐことができます。ただし、おすすめ更新の間に購入したアイテムや、対話したアイテムが表示されることはあります。無料版のアイテムおすすめでは、更新は毎週行われます。プロバージョンの AI によるアイテムおすすめでは、更新が 24 時間ごとに行われます。
たとえば、AI によるアイテムのおすすめの Pro バージョンを使用している場合、ユーザーが何かを購入し、その後 30 分以内にマーケターメールを受信した場合、購入したばかりのアイテムが時間内にメールから除外されない可能性があります。ただし、24 時間後に送信されるメッセージには、そのアイテムは含まれません。
ステップ 3.2:カタログを選択する
まだ入力されていない場合は、レコメンデーションを取得するカタログを選択します。
ステップ3.3:セレクションを追加する (オプション)
おすすめをさらに制御したい場合は、[セレクション] を選択してカスタムフィルターを適用します。セレクションは、ブランド、サイズ、場所など、カタログ内の特定の列によって、おすすめアイテムをフィルタリングします。Liquid を含むセレクションは、おすすめで使用できません。
セレクションが見つからない場合は、まずカタログで設定されていることを確認してください。
ステップ4:おすすめを推進するインタラクションを選択する
このおすすめを最適化するイベントを選択します。このイベントは通常、「購入」ですが、アイテムとのインタラクションも可能です。
以下のイベントで最適化できます。
- [購入オブジェクト] のある購入イベント
- 購入を表すカスタムイベント
- 他のアイテムインタラクションを表すカスタムイベント (商品の表示、クリック、メディア再生など)
[カスタムイベント] を選択した場合は、リストからイベントを選択します。
!現在どのようにイベントがトラッキング, 追跡されるかとして選択された “Completed Purchase “カスタムイベント。
ステップ 5: 対応するプロパティ名を選択する
おすすめを作成するには、インタラクションイベント (購入オブジェクトまたはカスタムイベント) のどのフィールドが、カタログのアイテムの id フィールドと一致する一意の識別子を持っているかを Braze に伝える必要があります。よくわからない場合は要件を確認してください。
このフィールドを [プロパティ名] に選択します。
[プロパティ名] フィールドに、SDK 経由で Braze に送信されるフィールドのリストがあらかじめ入力されます。十分なデータが提供されていれば、これらのプロパティはそれが正しいプロパティである確率の順にランク付けされます。カタログの id フィールドに対応するものを選択します。
!カタログのアイテム ID に対応するプロパティ名”purchase_item” が選択されている。
要件
プロパティを選択するには、いくつかの要件があります。
- 選択したカタログの
idフィールドにマッピングする必要があります。 - 購入オブジェクトを選択した場合:
product_idまたはインタラクションイベントのpropertiesのフィールドである必要があります。 - カスタムイベントを選択した場合:カスタムイベントの
propertiesのフィールドである必要があります。 - ネストされたフィールドは、ドット表記を用いて
event_property.nested_propertyの形式で [プロパティ名] ドロップダウンに入力する必要があります。たとえば、イベントプロパティlocation内のネストされたプロパティdistrict_nameを選択する場合は、「location.district_name」と入力します。 - フィールドは商品の配列の中にあってもいいし、IDの配列で終わってもいい。いずれの場合も、各製品 ID は、同じタイムスタンプを持つ個別の連続したイベントとして扱われます。
マッピングの例
以下のマッピング例は、どちらもこのサンプルカタログを参照しています。
| id | 名称 | 価格 |
|---|---|---|
| ADI-BL-7 | アディダスブラックサイズ 7 | 100.00 米ドル |
| ADI-RD-8 | アディダスレッドサイズ 8 | 100.00 米ドル |
| ADI-WH-9 | アディダスホワイトサイズ 9 | 100.00 米ドル |
| ADI-PP-10 | アディダスパープルサイズ 10 | 75.00 米ドル |
たとえば、カスタムイベント added_to_cart を使用して、顧客がチェックアウトする前に同様の商品をお勧めできるようにするとします。イベント added_to_cart にはイベントプロパティ product_sku があります。
product_sku プロパティには、サンプルカタログの id 列の値のうち少なくとも 1 つが含まれている必要があります: “ADI-BL-7”、”ADI-RD-8”、”ADI-WH-9”、または “ADI-PP-10”。すべてのカタログアイテムにイベントは必要ありませんが、レコメンデーションエンジンの処理に十分なコンテンツを提供するために、いくつかのイベントが必要です。
カスタムイベントオブジェクトの例
このイベントには "product_sku": "ADI-BL-7" があり、サンプルカタログの最初のアイテムと一致します。
1
2
3
4
5
6
7
8
9
10
11
12
13
{
"events": [
{
"external_id": "user1",
"app_id": "your-app-id",
"name": "added_to_cart",
"time": "2024-07-16T19:20:30+01:00",
"properties": {
"product_sku": "ADI-BL-7"
}
}
]
}
商品の配列を持つカスタムイベントオブジェクトの例
イベント・プロパティが複数の製品を配列に含む場合、各製品IDは個別の連続したイベントとして扱われる。このイベントは、プロパティ products.sku を使用して、サンプルカタログの1番目のアイテムと3番目のアイテムに一致させることができます。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
{
"events": [
{
"external_id": "user1",
"app_id": "your-app-id",
"name": "added_to_cart",
"time": "2024-07-16T19:20:30+01:00",
"properties": {
"transaction_id": "2ff3f9a9-8803-4c3a-91da-14adbf93dc99",
"products": [
{ "sku": "ADI-BL-7" },
{ "sku": "ADI-WH-9" }
]
}
}
]
}
商品ID配列を含むネストされたオブジェクトを持つカスタムイベントオブジェクトの例
商品IDがオブジェクトではなく配列の値である場合も、同じ記法を使うことができ、各商品IDは個別の連続したイベントとして扱われる。これは、次のイベントでネストされたオブジェクトと柔軟に組み合わせることができます。このためには、サンプルカタログの1番目と3番目のアイテムに一致するようにこのプロパティを purchase.product_skus として設定します。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
{
"events": [
{
"external_id": "user1",
"app_id": "your-app-id",
"name": "added_to_cart",
"time": "2024-07-16T19:20:30+01:00",
"properties": {
"transaction_id": "13791e08-7c22-4f6c-8cc6-832c76af3743",
"purchase": {
"product_skus": ["ADI-BL-7", "ADI-WH-9"]
}
}
}
]
}
購入が行われると、API を通じて購入オブジェクトが渡されます。
マッピングに関しては、カスタムイベントと同様に購入オブジェクトにも同様のロジックが適用されますが、購入オブジェクトの product_id を使用するか、properties オブジェクトのフィールドを使用するかを選択できます。
ここで、すべてのカタログアイテムにイベントは必要ありませんが、レコメンデーションエンジンの処理に十分なコンテンツを提供するために、いくつかのイベントが必要であることを忘れないでください。
商品 ID にマッピングされた購入オブジェクトの例
このイベントには "product_id": "ADI-BL-7 があり、カタログの最初のアイテムにマッピングされます。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
{
"purchases": [
{
"external_id": "user1",
"app_id": "11ae5b4b-2445-4440-a04f-bf537764c9ad",
"product_id": "ADI-BL-7",
"currency": "USD",
"price": 100.00,
"time": "2024-07-16T19:20:30+01:00",
"properties": {
"color": "black",
"checkout_duration": 180,
"size": "7",
"brand": "Adidas"
}
}
]
}
プロパティフィールドにマッピングされた購入オブジェクトの例
このイベントのプロパティは "sku": "ADI-RD-8" で、カタログの 2 番目のアイテムにマッピングされます。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
{
"purchases": [
{
"external_id": "user1",
"app_id": "11ae5b4b-2445-4440-a04f-bf537764c9ad",
"product_id": "shoes",
"currency": "USD",
"price": 100.00,
"time": "2024-07-16T19:20:30+01:00",
"properties": {
"sku": "ADI-RD-8",
"color": "red",
"checkout_duration": 180,
"size": "8",
"brand": "Adidas"
}
}
]
}
ステップ 6: おすすめをトレーニングする
準備ができたら、[レコメンデーションを作成] を選択します。このプロセスは、完了するまで 10 分から 36 時間かかることがあります。おすすめが正常にトレーニングされるか、作成に失敗した場合にはその理由を説明するメール更新が送信されます。
おすすめは [予測] ページに表示され、必要に応じて編集したりアーカイブしたりできます。レコメンデーションは、毎週1回 (有料) または毎月1回 (無料) 自動的に再試行されます。
GitHub でこのページを編集