次の方法で共有

外部リスト データ エンティティ

  • [アーティクル]

Intelligent Recommendations を使用すると、手動で作成されたアイテム リストをキュレーションできます。 このリストは、たとえばコールド スタートのシナリオで、意味のあるレコメンデーションを生成するのに十分なユーザー対話データがない場合に役立ちます。 もう 1 つのシナリオは、「新学期」セールや「編集者のおすすめ」などの販売促進リストを作成することです。

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

次のデータ エンティティは外部リスト データ エンティティの一部です:

外部レコメンデーション リスト

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

説明: レコメンデーションの外部リスト

属性:

件名 データ型 必須 規定値 無効な値の動作 Comments
ListName String(64) Yes 値のトリミング 一意のリスト識別子はリストのクエリ時にも使用されます。 長さは 64 文字に制限されています。
肩書き String(256) イエス 値のトリミング 長さは 256 文字に制限されています。
ListAvailabilityStartDate DateTime 番号 0001-01-01T00:00:00.000Z エントリをドロップ DateTime 値については、レコメンデーション シナリオごとに必要なデータ エンティティ を参照してください。
ListAvailabilityEndDate DateTime 番号 9999-12-31T23:59:59.999Z エントリをドロップ DateTime 値については、レコメンデーション シナリオごとに必要なデータ エンティティ を参照してください。

ガイドライン:

  • このデータ エンティティは、今後対応する予定です。

  • ListName 属性には次の制限があります。

    • 使用できる文字のセット: A-Z、a-z、0-9、_、-、~、..
    • 大文字と小文字は区別されません。
    • 既存の RecoListName 値は予約されており、ListName 値として使用できません。 エンリッチメント データ エンティティ ページで予約名の完全なリストを参照してください。
    • リストの可用性の開始日と終了日を使用して、リストの可用性を判断できます。リストは、これらの指定された日付の間のみ Intelligent Recommendations が提供します。

サンプル データ:

ヘッダーは便宜上表示されるものであり、実際のデータの一部ではありません。

ListName 肩書き ListAvailabilityStartDate ListAvailabilityEndDate
SummerSale2020 2020 年夏のベストアイテム 2020-07-01T00:00:00.000Z 2020-08-31T23:59:59.999Z

外部レコメンデーション アイテム

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

説明: レコメンデーションの外部リストのアイテム

属性:

件名 データ型 必須 規定値 無効な値の動作 Comments
ListName String(64) Yes 値のトリミング 一意のリスト識別子はリストのクエリ時にも使用されます。 長さは 64 文字に制限されています。 ここで ListNames のテーブルを表示できます。
ItemId String(16) イエス エントリをドロップ itemId については、レコメンデーション シナリオごとに必要なデータ エンティティ を参照してください。
ItemVariantId String(16) 番号 エントリをドロップ itemVariantId については、レコメンデーション シナリオごとに必要なデータ エンティティ を参照してください。
Rank Int イエス エントリをドロップ 各アイテムを表示する位置の順序。

ガイドライン:

  • このデータ エンティティは、今後対応する予定です。

  • データ エンティティのListName ガイドライン Reco_ExternalRecommendationsListsを参照してください。

  • Intelligent Recommendations は、同じリスト内で同じ ランク に割り当てられた複数のアイテム間の内部順序を保証しません。

  • 同じアイテムまたはアイテムのバリアントがリストに複数回出現する場合、その最高ランクが使用され、他のすべてのエントリは無視されます。

  • このデータ エンティティ内の ListName 値ごとに、同じ ListName 値を持つ対応するエントリが存在する必要があります。Reco_ExternalRecommendationsLists データ エンティティ。それ以外の場合、エントリは無視されます。

サンプル データ:

ヘッダーは便宜上表示されるものであり、実際のデータの一部ではありません。

ListName ItemId ItemVariantId Rank
SummerSale2020 アイテム 2 6
SummerSale2020 Item3 Item3Var1 2
SummerSale2020 アイテム 1 Item1Var2 3

参照

データ コントラクトの概要
データ エンティティ マッピング テーブル
カタログ データ エンティティ
画像から品目へのマッピング データ エンティティ
対話データ エンティティ
Reco 構成データ エンティティ
オプトアウト済みユーザー データ エンティティ
レコメンデーション エンリッチメント データ エンティティ
Intelligent Recommendations API
クイック スタート ガイド: サンプル データで Intelligent Recommendations を設定し、実行する