レコメンデーション エンリッチメント データ エンティティ
この記事では、Intelligent Recommendations データ コントラクトでレコメンデーション エンリッチメント データ エンティティを構成する方法を説明します。
データ エンティティ レビュー
データ エンティティ は、1 つ以上のデータ テキスト ファイルのセットであり、それぞれに実際のデータ値を含む列 (または 属性) と行の一覧があります。
Intelligent Recommendations は、それぞれ独自の目的を持つデータ エンティティの論理グループを定義します。
Note
データ エンティティはオプションなので (特に明記されていない限り)、データが空または欠落している可能性があります。
概要
Intelligent Recommendations は、生成されたレコメンデーションの手動エンリッチメントをサポートします。これにより、特定のアイテムまたはアイテム バリアントを任意のレコメンデーション リストから手動で追加または削除できます。
サポートされているエンリッチメント アクションは次のとおりです:
参照項目: 指定されたリストの一番上に、指定された品目または品目バリアントを追加します。 これらの手動で追加された品目は、Rank 属性によって並べ替えられます。
除外項目: 前述のリスト内の品目のランクに関係なく、指定された品目または品目バリアントを指定されたリストから削除します。
品目の利用可能性は常に尊重されます。 レコメンデーション API が呼び出された時点で利用可能とみなされていない品目は、応答の一部として返されません。
次のデータ エンティティはレコメンデーション エンリッチメント データ エンティティの一部です:
特定のアイテムのレコメンデーション エンリッチメント
データ エンティティ名: Reco_SeededRecommendationsEnrichment
説明: SeedItemId と呼ばれる ItemId を使用した特定のアイテムのレコメンデーション エンリッチメント。 特定のアイテムがキー オフされている "その他のおすすめ" などのリストにのみ適用されます。
属性:
件名 | データ型 | 必須 | 規定値 | 無効な値の動作 | Comments |
---|---|---|---|---|---|
RecoListName | 文字列 | イエス | 値のトリミング | 対応しているリスト名については ListNames テーブル にアクセスしてください。 | |
AlgoType | 文字列 | 番号 | 値のトリミング | すべてのリスト名でこの値を設定する必要があるわけではありません。 リスト名ごとにサポートされているアルゴリズム型については、AlgoTypes テーブル を参照してください。 | |
SeedItemId | String(16) | イエス | エントリをドロップ | リストが推奨する ItemId。 品目 ID については、レコメンデーション シナリオごとに必要なデータ エンティティ を参照してください。 | |
SeedItemVariantId | String(16) | 番号 | エントリをドロップ | リストが推奨する ItemVariantId。 品目バリアント ID については、レコメンデーション シナリオごとに必要なデータ エンティティ を参照してください。 | |
ItemId | String(16) | 有効 | エントリをドロップ | 品目 ID については、レコメンデーション シナリオごとに必要なデータ エンティティ を参照してください。 | |
ItemVariantId | String(16) | 番号 | エントリをドロップ | 品目バリアント ID については、レコメンデーション シナリオごとに必要なデータ エンティティ を参照してください。 | |
EnrichmentAction | 文字列 | 有効 | エントリをドロップ | 現時点では、参照項目 または 除外項目 のみをサポートしています。 | |
順位 | Int | 番号 | エントリをドロップ | 除外 エンリッチメント アクションでは、この値は無視されます。 |
ガイドライン:
参照項目 とマークされた品目は、生成されたレコメンデーション リストの一番上にのみ追加できます。
品目が表示されていない品目をリストから除外しても、何も起こりません。
除外は常に優先されます。 同じリストに同じ品目を含めたり除外したりすると、最終的な API 応答から除外されます。
Rank 属性は、追加された品目または品目バリアント間の順序のみを指定します。 いずれの場合も、常にリストの一番上に追加されます。 複数の品目に重複するランク値がある場合、ランダムな順序で追加されます。
サポートされていない AlgoType 値を持つエンリッチメントは無視されます。
サンプル データ:
ヘッダーは便宜上表示されるものであり、実際のデータの一部ではありません。
RecoListName | AlgoType | SeedItemId | SeedItemVariantId | ItemId | ItemVariantId | EnrichmentAction | 順位 |
---|---|---|---|---|---|---|---|
類似する | MF | アイテム 1 | アイテム 2 | 参照項目 | 6 | ||
類似する | MF | アイテム 1 | Item3 | Item3Var1 | 参照項目 | 2 | |
類似する | DAS | Item3 | Item3Var1 | アイテム 1 | Item1Var2 | 除外する | |
カート | Item3 | アイテム 1 | Item1Var1 | 参照項目 | 6 |
レコメンデーション エンリッチメント
データ エンティティ名:Reco_RecommendationsEnrichment
説明: 推奨結果のエンリッチメント
属性:
件名 | データ型 | 必須 | 規定値 | 無効な値の動作 | Comments |
---|---|---|---|---|---|
RecoListName | 文字列 | イエス | 値のトリミング | 対応しているリスト名については ListNames テーブル にアクセスしてください。 | |
ItemId | String(16) | イエス | エントリをドロップ | 品目 ID については、レコメンデーション シナリオごとに必要なデータ エンティティ を参照してください。 | |
ItemVariantId | String(16) | 番号 | エントリをドロップ | 品目バリアント ID については、レコメンデーション シナリオごとに必要なデータ エンティティ を参照してください。 | |
EnrichmentAction | 文字列 | 有効 | エントリをドロップ | 現時点では、参照項目 または 除外項目 のみをサポートしています。 | |
順位 | Int | 番号 | エントリをドロップ | 除外 エンリッチメント アクションでは、この値は無視されます。 |
ガイドライン:
ListNames、AlgoTypes と Refinements
ListNames のテーブル
使用可能な ListName の現在のリストを表に示します。
ListName | 請求 (標準/プレミアム) | モデル機能セット |
---|---|---|
BrowseLists | Standard | 基本 |
ExternalLists | Standard | 基本 |
PeopleAlso | Standard | 基本 |
NextBestAction (正式名 "カート") | Standard | 基本 |
ピッキング | Standard | Standard |
ViewedInSession | Standard | Standard |
VisualSimilarity | Premium | Premium |
TextualSimilarity | Premium | Premium |
AlgoTypes のテーブル
利用可能な AlgoType と、それらを使用できるさまざまな API を表に示します。
AlgoType | 説明 | サポートされる API |
---|---|---|
RecentPurchases | ピック レコメンデーションは、ユーザーの最新の購入 (または他の相互作用) に基づいて計算されます。 | ユーザー ピック API でのみ使用できます。 |
RecentViews | ピック レコメンデーションは、ユーザーの最新の閲覧履歴と好みに基づいて計算されます。 | ユーザー ピック API でのみ使用できます。 |
FullHistory | ピック レコメンデーションは、ユーザーの完全な購入履歴 (または他の相互作用) に基づいて計算されます。 | ユーザー ピック API でのみ使用できます。 |
MF(行列分解) | 類似 API のデフォルト表示。 | 類似 API でのみ使用できます |
ビジュアル | アイテムの類似性は、カタログ画像の視覚的な類似性に基づいて計算されます。 | 類似 API でのみ使用できます。 |
テキスト | 項目の類似性は、カタログのテキスト タイトルと説明に対する、テキスト (言語理解) の類似性に基づいて計算されます。 | 類似 API でのみ使用できます。 |
BringSimilarItems | 合成画像が与えられると、この AlgoType は、合成画像内で識別されたアイテムに視覚的に類似したアイテムを提案します。 | 類似 API でのみ使用できます。 |
CompleteSimilarStyles | シード アイテムが与えられると、この AlgoType はシード アイテムに類似した同様のスタイルの他の合成画像を提案します。 | 類似 API でのみ使用できます。 |
CompleteSimilarItems | シード アイテムが与えられると、この AlgoType はシード アイテムに類似した同様のスタイルの他の合成画像からのアイテムを提案します。 | 類似 API でのみ使用できます。 |
DAS | “DAS” とは直接関連スコアリングの略称です。 この AlgoType は、相互作用データ エンティティが含む品目の共起を使用して、類似性に基づくレコメンデーションを提供します。 この Algotype は NextBestAction API の既定です。 | 類似 API と NextBestAction API (正式名称は "Cart") のみで使用できます。 |
Refinements のテーブル
利用可能な絞り込みと、それらを併用できるさまざまな API を表に示します。互いに矛盾しない限り、カンマで区切って複数の絞り込みを追加できます。
絞り込み | Definition | サポートされる API | 既定の動作 |
---|---|---|---|
RemoveUserHistory | ユーザーがすでに購入したアイテムを削除し、そのユーザーに再度推奨されないようにします。 | すべての API | 「Get User Picks」API に対してのみ既定で有効になっています。 |
KeepUserHistory | ユーザーが購入したアイテムの履歴を保持し、レコメンデーション サービスが同じユーザーに対して再度考慮することができます。 | すべての API | 「Get User Picks」を除くすべての API で既定で有効になっています。 |
EnableShuffling | ユーザーが同じ推奨事項を何度も表示しないようにするために、関連性に重大な影響を与えずに項目の順序をわずかに変更します。 | すべての API | 「Get User Picks」API に対してのみ既定で有効になっています。 |
DisableShuffling | 結果をシャッフルせずに、推奨項目の順序を維持します。 | すべての API | 「Get User Picks」を除くすべての API で既定で有効になっています。 |
参照
データ コントラクトの概要
データ エンティティ マッピング テーブル
カタログ データ エンティティ
対話データ エンティティ
Reco 構成データ エンティティ
オプトアウト済みユーザー データ エンティティ
外部リスト データ エンティティ
レコメンデーション エンリッチメント データ エンティティ
Intelligent Recommendations API
クイック スタート ガイド: サンプル データで Intelligent Recommendations を設定し、実行する