本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
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。当用户首次访问您的网站或使用您的应用程序时,您的应用程序会生成 SsessionId。Amazon Personalize 在用户登录之前使用 SsessionId 将事件与用户关联起来。有关更多信息,请参阅记录事件。
类型:字符串
长度限制:最小长度为 1。长度上限为 256。
必需:是
- trackingId
-
事件的追踪 ID。ID 是通过调用 CreateEventTrackerAPI 生成的。
类型:字符串
长度限制:最小长度为 1。长度上限为 256。
必需:是
- userId
-
与事件关联的用户。
类型:字符串
长度限制:最小长度为 1。长度上限为 256。
必需:否
响应语法
HTTP/1.1 200
响应元素
如果此操作成功,则该服务会发送回带有空 HTTP 正文的 HTTP 200 响应。
错误
- InvalidInputException
-
为字段或参数提供有效值。
HTTP 状态代码:400
另请参阅
有关在特定语言的 Amazon 软件开发工具包中使用此 API 的更多信息,请参阅以下内容: