次の方法で共有


レコメンデーション エンリッチメント データ エンティティ

この記事では、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 の既定です。 類似 APINextBestAction 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 を設定し、実行する