翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
ActionInteraction
PutActionInteractions
API を使用して送信されるアクションインタラクションイベントを表します。
コンテンツ
- actionId
-
ユーザーが操作したアクションの ID。これはアクションインタラクションスキーマの
ACTION_ID
フィールドに対応します。型: 文字列
長さの制限:最小長は 1 です。最大長は 256 です。
必須: はい
- eventType
-
アクションインタラクションイベントのタイプ。
Viewed
、Taken
、およびNot Taken
イベントタイプを指定できます。アクションインタラクションのイベントタイプデータについて詳しくは、「Event type data」を参照してください。型: 文字列
長さの制限:最小長は 1 です。最大長は 256 です。
必須: はい
- sessionId
-
ユーザーの訪問に関連付けられたセッション ID。アプリケーションは、ユーザーが最初にウェブサイトにアクセスしたとき、またはアプリケーションを使用したときに、一意の
sessionId
を生成します。型: 文字列
長さの制限:最小長は 1 です。最大長は 256 です。
必須: はい
- timestamp
-
アクションインタラクションイベントが発生したときのタイムスタンプ。タイムスタンプは Unix エポック時刻形式 (秒単位) である必要があります。
型: タイムスタンプ
必須: はい
- eventId
-
イベントに関連付けられた ID。イベント ID が指定されていない場合、Amazon Personalize はイベントの一意の ID を生成します。イベント ID はモデルへの入力として使用されません。Amazon Personalize は、イベント ID を使用して一意のイベントを区別します。同じイベント ID を持つ最初のイベント以降の後続のイベントは、モデルトレーニングでは使用されません。
型: 文字列
長さの制限:最小長は 1 です。最大長は 256 です。
必須: いいえ
- impression
-
ユーザーに表示したアクションのシーケンスを表すアクション ID のリスト。例えば
["actionId1", "actionId2", "actionId3"]
です。Amazon Personalize は、アクションインタラクションイベントのインプレッションデータを使用しません。代わりに、アクションごとに複数のイベントを記録し、Viewed
イベントタイプを使用してください。タイプ:文字列の配列
配列メンバー:最小数は 1 項目です。最大数は 25 項目です。
長さの制限:最小長は 1 です。最大長は 256 です。
必須: いいえ
- properties
-
記録することを選択する可能性のあるイベント固有のデータの文字列マップ。例えば、ユーザーがアクションを実行した場合 (アクション ID 以外)、ユーザーが行ったアクションの数を送信することもできます。
マップの各アイテムは、キーバリューペアで設定されています。例:
{"numberOfActions": "12"}
キーは、アクションインタラクションスキーマのフィールドと一致するキャメルケース名を使用します。上の例では、
numberOfActions
はアクションインタラクションスキーマで定義された「NUMBER_OF_ACTIONS」フィールドと一致します。以下はプロパティのキーワードとして含めることはできません (大文字と小文字は区別されません)。
-
userId
-
sessionId
-
eventType
-
timestamp
-
recommendationId
-
インプレッション
型: 文字列
長さの制限: 最小長は 1 です。最大長は 1,024 です。
必須: いいえ
-
- recommendationId
-
ユーザーが操作したアイテムを含むレコメンデーションのリストの ID。
型: 文字列
長さの制限:最小長は 1 です。最大長は 40 です。
必須: いいえ
- userId
-
アクションを操作したユーザーの ID。これはアクションインタラクションスキーマの
USER_ID
フィールドに対応します。型: 文字列
長さの制限:最小長は 1 です。最大長は 256 です。
必須:いいえ
その他の参照資料
言語固有の AWS SDK でこの API を使用する方法の詳細については、以下を参照してください。