翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
PutEvents
アイテムインタラクションのイベントデータを記録します。詳細については、「Recording item interaction events」を参照してください。
注記
AWS Lambda 関数を使用して PutEvents オペレーションを呼び出す場合、関数の実行ロールには、 Resource要素*のワイルドカードを使用してpersonalize:PutEventsアクションを実行するアクセス許可が必要です。
リクエストの構文
POST /events HTTP/1.1
Content-type: application/json
{
"eventList": [
{
"eventId": "string",
"eventType": "string",
"eventValue": number,
"impression": [ "string" ],
"itemId": "string",
"metricAttribution": {
"eventAttributionSource": "string"
},
"properties": "string",
"recommendationId": "string",
"sentAt": number
}
],
"sessionId": "string",
"trackingId": "string",
"userId": "string"
}URI リクエストパラメータ
リクエストでは URI パラメータを使用しません。
リクエストボディ
リクエストは以下の JSON 形式のデータを受け入れます。
- eventList
-
セッションからのイベントデータのリスト。
型: Event オブジェクトの配列
配列メンバー：最小数は 1 項目です。最大数は 10 項目です。
必須：はい
- sessionId
-
ユーザーの訪問に関連付けられたセッション ID。アプリケーションは、ユーザーが最初にウェブサイトにアクセスしたとき、またはアプリケーションを使用したときに、sessionId を生成します。Amazon Personalize は、sessionId を使用して、ユーザーがログインする前にイベントをユーザーに関連付けます。詳細については、「Recording item interaction events」を参照してください。
型: 文字列
長さの制限：最小長は 1 です。最大長は 256 です。
必須：はい
- trackingId
-
イベントの追跡 ID。ID は、CreateEventトラッカー API の呼び出しによって生成されます。
型: 文字列
長さの制限：最小長は 1 です。最大長は 256 です。
必須：はい
- userId
-
イベントに関連付けられているユーザー。
型: 文字列
長さの制限：最小長は 1 です。最大長は 256 です。
必須: いいえ
レスポンスの構文
HTTP/1.1 200
レスポンス要素
アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。
エラー
- InvalidInputException
-
フィールドまたはパラメータに有効な値を指定します。
HTTP ステータスコード：400
その他の参照資料
言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
