本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
PutEvents
记录物品交互事件数据。有关更多信息,请参阅记录物品交互事件。
注意
如果您使用 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 将事件与用户关联起来。有关更多信息,请参阅记录物品交互事件。
类型:字符串
长度限制:最小长度为 1。最大长度为 256。
必需:是
- trackingId
-
事件的跟踪 ID。ID 是通过调用CreateEvent追踪器 API 生成的。
类型:字符串
长度限制:最小长度为 1。最大长度为 256。
必需:是
- userId
-
与事件关联的用户。
类型:字符串
长度限制:最小长度为 1。最大长度为 256。
必需:否
响应语法
HTTP/1.1 200
响应元素
如果此操作成功,则该服务会发送回带有空 HTTP 正文的 HTTP 200 响应。
错误
- InvalidInputException
-
为字段或参数提供有效值。
HTTP 状态代码:400
另请参阅
有关在特定语言的 AWS SDK 中使用此 API 的更多信息,请参阅以下内容: