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

[アーティクル]
04/12/2023

この記事では、Intelligent Recommendations データコントラクトでレコメンデーションエンリッチメントデータエンティティを構成する方法を説明します。

データエンティティレビュー

データエンティティ は、1 つ以上のデータテキストファイルのセットであり、それぞれに実際のデータ値を含む列 (または属性) と行の一覧があります。

Intelligent Recommendations は、それぞれ独自の目的を持つデータエンティティの論理グループを定義します。

Note

データエンティティはオプションなので (特に明記されていない限り)、データが空または欠落している可能性があります。

データエンティティの全一覧に戻る

概要

Intelligent Recommendations は、生成されたレコメンデーションの手動エンリッチメントをサポートします。これにより、特定のアイテムまたはアイテムバリアントを任意のレコメンデーションリストから手動で追加または削除できます。

サポートされているエンリッチメントアクションは次のとおりです:

参照項目: 指定されたリストの一番上に、指定された品目または品目バリアントを追加します。これらの手動で追加された品目は、Rank 属性によって並べ替えられます。
除外項目: 前述のリスト内の品目のランクに関係なく、指定された品目または品目バリアントを指定されたリストから削除します。

品目の利用可能性は常に尊重されます。レコメンデーション API が呼び出された時点で利用可能とみなされていない品目は、応答の一部として返されません。

次のデータエンティティはレコメンデーションエンリッチメントデータエンティティの一部です:

データエンティティの全一覧に戻る

特定のアイテムのレコメンデーションエンリッチメント

データエンティティ名: Reco_SeededRecommendationsEnrichment

説明: SeedItemId と呼ばれる ItemId を使用した特定のアイテムのレコメンデーションエンリッチメント。特定のアイテムがキーオフされている "その他のおすすめ" などのリストにのみ適用されます。

属性:

件名	データ型	Mandatory	無効な値の動作	Comments
RecoListName	String	イエス	値のトリミング	対応しているリスト名については ListNames テーブルにアクセスしてください。
AlgoType	String	番号	値のトリミング	すべてのリスト名でこの値を設定する必要があるわけではありません。リスト名ごとにサポートされているアルゴリズム型については、AlgoTypes テーブルを参照してください。
SeedItemId	String(16)	イエス	エントリをドロップ	リストが推奨する ItemId。品目 ID については、レコメンデーションシナリオごとに必要なデータエンティティを参照してください。
SeedItemVariantId	String(16)	番号	エントリをドロップ	リストが推奨する ItemVariantId。品目バリアント ID については、レコメンデーションシナリオごとに必要なデータエンティティを参照してください。
ItemId	String(16)	有効	エントリをドロップ	品目 ID については、レコメンデーションシナリオごとに必要なデータエンティティを参照してください。
ItemVariantId	String(16)	番号	エントリをドロップ	品目バリアント ID については、レコメンデーションシナリオごとに必要なデータエンティティを参照してください。
EnrichmentAction	String	有効	エントリをドロップ	現時点では、参照項目または除外項目のみをサポートしています。
順位	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