対話データ エンティティ
この記事では、Intelligent Recommendations データ コントラクトで対話データ エンティティを構成する方法を説明します。
データ エンティティ レビュー
データ エンティティ は、1 つ以上のデータ テキスト ファイルのセットであり、それぞれに実際のデータ値を含む列 (または 属性) と行の一覧があります。
Intelligent Recommendations は、それぞれ独自の目的を持つデータ エンティティの論理グループを定義します。
Note
データ エンティティはオプションなので (特に明記されていない限り)、データが空または欠落している可能性があります。
データ エンティティの全一覧については、データ エンティティ を参照してください。
対話データ エンティティの概要
対話は、ユーザーがカタログ品目を操作するすべての方法セットを表します。 一般的なユーザー アクションには、トランザクション インタラクション (購入)、ビュー (クリックスルー)、評価、ユーザーとアイテムまたはアイテム バリアント間で発生するその他のアクションが含まれます。
次のデータ エンティティは対話データ エンティティの一部です:
対話
データ エンティティ名: Reco_Interactions。
説明: 品目および品目バリアントとのすべてのユーザーとの対話。
属性:
| 件名 | データ型 | 必須 | 規定値 | 無効な値の動作 | Comments |
|---|---|---|---|---|---|
| InteractionGroupingId | String(256) | 有効 | エントリをドロップ | 複数の対話のグループ ID。 長さは 256 文字に制限されています。 | |
| ItemId | String(16) | 有効 | エントリをドロップ | 品目 ID については、レコメンデーション シナリオごとに必要なデータ エンティティ を参照してください。 | |
| ItemVariantId | String(16) | 番号 | エントリをドロップ | 品目バリアント ID については、レコメンデーション シナリオごとに必要なデータ エンティティ を参照してください。 | |
| UserId | String(256) | 番号 | エントリをドロップ | 空の値は匿名の対話を表します。 長さは 256 文字に制限されています。 | |
| InteractionType | 文字列 | 番号 | トランザクション | エントリをドロップ | トランザクションは、この属性の唯一の有効な値であり、レコメンデーション結果には影響しません。 |
| タイムスタンプ | DateTime | 番号 | 1970-01-01T00:00:00.000Z | エントリをドロップ | DateTime 値については、レコメンデーション シナリオごとに必要なデータ エンティティ を参照してください。 |
| 文字列属性 | String(64) | 番号 | エントリをドロップ | 長さは 64 文字に制限されています。 ビジネスのニーズに応じて使用でき、モデリング プロセスに影響を与えない文字列属性。 | |
| 倍精度浮動小数点属性 | 倍精度浮動小数点 | いいえ | エントリをドロップ | ビジネスのニーズに応じて使用でき、モデリング プロセスに影響を与えない二重属性。 | |
| Channel | String(64) | いいえ | 0 | 値のトリミング | 長さは 64 文字に制限されています。 |
| Catalog | String(64) | 番号 | 12 | 値のトリミング | 長さは 64 文字に制限されています。 |
| 長所 | 倍精度浮動小数点型 | 番号 | 1.0 | エントリをドロップ | 対話の重要性を (他の対話と比較して) 表します。 この属性はトランザクション プロセスとパフォーマンスの向上に役立ちますが、データの透明性と倫理的な使用は重要な考慮事項です。 次に行うべき最良の対応、User Picks などでサポートされています (AlgoType=MF)。 |
| IsPositive | Bool | 番号 | 真 | ブール値については、レコメンデーション シナリオごとに必要なデータ エンティティ を参照してください。 |
ガイドライン:
InteractionGroupingId は、1 つの複数品目の対話で品目をグループ化する主要なコラボレーション インジケーターです。 ビジネスの範囲内で、品目間の関係を作成するものであれば何でも構いません。 たとえば、同じやりとり (バスケット) で購入した品目は接続/関連する可能性があるため、バスケット/トランザクション ID はこのフィールドに適している可能性があります。 コラボレーション要因が品目を操作するユーザー (人) である場合は、このフィールドに UserId をコピーし、UserIdフィールドにも含めることができます。
対話データ エンティティに同じタイプの対話が含まれていることを確認してください (タイプは、いいね、トランザクション、ビューなどです)。 さまざまなインタラクション タイプに関する推奨事項を取得するには、モデリング コンポーネントが同じタイプのインタラクションを読み取ることをお勧めします。 異なるタイプのトランザクションを同じモデルに統合すると、別々のモデル/IR アカウントで作業する場合とは異なる、必ずしも望ましい意味ではない混合推奨事項が返されます。
サポートされていない対話の種類は無視されます。
同じ操作 (たとえば、複数品目のトランザクション) を表す、すべてのデータ行は、同じ一意のグループ ID を持つ必要があります。
ネガティブな対話 (品目返品や嫌いなど) は、IsPositive=False で表されます。
リストされている倍精度浮動小数点属性、文字列属性、および対話のタイプ列は、現時点では空のままにしておくことができます。
「チャネル」または「カタログ」属性の値として「0」を使用すると、処理エラーが発生します。
次に行うべき最良の対応シナリオでは、強度属性の上限は 10 です。 10 を超える値は 10 に置き換えられます。
強度を使用する場合の例としては、次のようなものがあります。
- インタラクション (閲覧、視聴など) される可能性が高い製品を優先します。 最近の購入をより優先したい場合は、ユーザーの最新の対話にすでに優先順位を付けている RecentPurchases アルゴ タイプを使用して、Picks API を試すことを検討してください。
- ユーザーがアイテムに付けた評価スコアとして、関連するトランザクションの強度を設定することで、製品に対する 1 ～ 5 のスケールの評価スコアを反映できます。
- 視聴時間が長い動画に、視聴時間が短い動画よりも高い重みを与えることで、動画の視聴時間を優先します。
サンプル データ:
ヘッダーは便宜上表示されるものであり、実際のデータの一部ではありません。
| InteractionGroupingId | ItemId | ItemVariantId | UserId | InteractionType | Timestamp | 文字列属性 | 倍精度浮動小数点属性 | Channel | カタログCatalog | 長所 | IsPositive |
|---|---|---|---|---|---|---|---|---|---|---|---|
| Interaction100 | アイテム 1 | Item1Var1 | トランザクション | 2020-04-01T10:00:00.000Z | |||||||
| Interaction100 | アイテム 2 | トランザクション | 2020-04-01T10:00:00.000Z | 2.0 | |||||||
| Interaction101 | アイテム 2 | User1 | いいね | 2020-05-01T13:25:00.000Z | Interaction-101-RT | 誤 | |||||
| Interaction101 | Item3 | User2 | レイティング | 2020-07-12T08:45:00.000Z | 欧州 | MySale | 4.0 | 誤 |
データ エンティティの全一覧については、データ エンティティ を参照してください。
参照
データ コントラクトの概要
データ エンティティ マッピング テーブル
カタログ データ エンティティ
Reco 構成データ エンティティ
外部リスト データ エンティティ
オプトアウト済みユーザー データ エンティティ
レコメンデーション エンリッチメント データ エンティティ
画像から品目へのマッピング データ エンティティ
Intelligent Recommendations API
クイック スタート ガイド: サンプル データで Intelligent Recommendations を設定し、実行する