Event - Amazon Personalize
コンテンツその他の参照資料

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Event

PutEvents API を使用して送信されるアイテムインタラクションのイベント情報を表します。

コンテンツ

eventType

イベントのタイプ (クリックやダウンロードなど)。このプロパティは、アイテムインタラクションデータセットスキーマの EVENT_TYPE フィールドに対応し、追跡しているイベントのタイプによって異なります。

型: 文字列

長さの制限：最小長は 1 です。最大長は 256 です。

必須: はい

sentAt

イベントが発生したときのクライアント側のタイムスタンプ (Unix 時間)。

型: タイムスタンプ

必須: はい

eventId

イベントに関連付けられた ID。イベント ID が指定されていない場合、Amazon Personalize はイベントの一意の ID を生成します。イベント ID はモデルへの入力として使用されません。Amazon Personalize は、イベント ID を使用して一意のイベントを区別します。同じイベント ID を持つ最初のイベント以降の後続のイベントは、モデルトレーニングでは使用されません。

型: 文字列

長さの制限：最小長は 1 です。最大長は 256 です。

必須: いいえ

eventValue

アイテムインタラクションスキーマの EVENT_VALUE フィールドに対応するイベント値。

タイプ: 浮動小数点

必須: いいえ

impression

ユーザーに表示したアイテムのシーケンスを表すアイテム ID のリスト。例えば ["itemId1", "itemId2", "itemId3"] です。イベントのインプレッションデータを手動で記録する項目のリストを提供します。インプレッションデータの記録についての詳細は、「インプレッションデータの記録」を参照してください。

タイプ：文字列の配列

配列メンバー：最小数は 1 項目です。最大数は 25 項目です。

長さの制限：最小長は 1 です。最大長は 256 です。

必須: いいえ

itemId

アイテムインタラクションデータセットのスキーマの ITEM_ID フィールドに対応するアイテム ID キー。

型: 文字列

長さの制限：最小長は 1 です。最大長は 256 です。

必須: いいえ

metricAttribution

イベントに関連するメトリクス属性に関する情報が含まれています。メトリクス属性についての詳細は、「レコメンデーションの影響の測定」を参照してください。

タイプ：MetricAttribution オブジェクト

必須: いいえ

properties

記録することを選択する可能性のあるイベント固有のデータの文字列マップ。例えば、ユーザーがサイトで映画を評価した場合 (映画 ID (itemId) とレーティング (eventValue) 以外)、ユーザーが行った映画のレーティングの数を送信することもできます。

マップの各アイテムは、キーバリューペアで設定されています。例:

{"numberOfRatings": "12"}

キーは、アイテムインタラクションデータセットのスキーマのフィールドと一致するキャメルケース名を使用します。上の例では、numberOfRatings はアイテムインタラクションデータセットのスキーマで定義された「NUMBER_OF_RATINGS」フィールドと一致します。

以下はプロパティのキーワードとして含めることはできません (大文字と小文字は区別されません)。

  • userId

  • sessionId

  • eventType

  • timestamp

  • recommendationId

  • インプレッション

型: 文字列

長さの制限: 最小長は 1 です。最大長は 1,024 です。

必須: いいえ

recommendationId

ユーザーが操作したアイテムを含むレコメンデーションのリストの ID。Amazon Personalize がユーザーに表示したレコメンデーションをインプレッションデータとして暗黙のうちに記録するには、recommendationId を指定します。または、メトリクス属性を使用してレコメンデーションの影響を測定する場合は recommendationId を指定します。

インプレッションデータの記録についての詳細は、「インプレッションデータの記録」を参照してください。メトリクス属性の作成について詳しくは、「レコメンデーションの影響の測定」を参照してください。

型: 文字列

長さの制限：最小長は 1 です。最大長は 40 です。

必須：いいえ

その他の参照資料

言語固有の AWS SDK でこの API を使用する方法の詳細については、以下を参照してください。