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 を使用する方法の詳細については、以下を参照してください。

• AWS SDK for C++

• AWS Java V2 用 SDK

• AWS ルビー V3 用 SDK