PutEvents - Amazon Personalize
请求语法URI 请求参数请求正文响应语法响应元素错误另请参阅
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

PutEvents

记录物品交互事件数据。有关更多信息，请参阅记录物品交互事件。

注意

如果您使用 Amazon 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 将事件与用户关联起来。有关更多信息，请参阅记录物品交互事件。

类型：字符串

长度限制：最小长度为 1。最大长度为 256。

必需：是

trackingId

事件的跟踪 ID。该 ID 是通过调用 CreateEventTrackerAPI 生成的。

类型：字符串

长度限制：最小长度为 1。最大长度为 256。

必需：是

userId

与事件关联的用户。

类型：字符串

长度限制：最小长度为 1。最大长度为 256。

必需：否

响应语法

HTTP/1.1 200

响应元素

如果此操作成功，则该服务会发送回带有空 HTTP 正文的 HTTP 200 响应。

错误

InvalidInputException

为字段或参数提供有效值。

HTTP 状态代码：400

另请参阅

有关以特定语言之一使用此 API 的更多信息 Amazon SDKs，请参阅以下内容：