As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
PutEvents
Registra os dados dos eventos de interações com itens. Para obter mais informações, consulte Registrar eventos de interação com itens.
nota
Se você usar um perfil AWS Lambda para chamar a operação PutEvents, seu perfil de execução da função deverá ter permissão para realizar a ação personalize:PutEvents
com o caractere curinga *
no elemento Resource
.
Sintaxe da Solicitação
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
"
}
Parâmetros da solicitação de URI
A solicitação não usa nenhum parâmetro de URI.
Corpo da Solicitação
A solicitação aceita os dados a seguir no formato JSON.
- eventList
-
Uma lista de dados de eventos da sessão.
Tipo: Matriz de objetos Event
Membros da matriz: número mínimo de 1 item. Número máximo de 10 itens.
Obrigatório: Sim
- sessionId
-
O nome do usuário associado à sessão. Seu aplicativo gera o sessionId quando um usuário visita seu site pela primeira vez ou usa seu aplicativo. O Amazon Personalize usa o sessionId para associar eventos ao usuário antes que ele faça login. Para obter mais informações, consulte Registrar eventos de interação com itens.
Tipo: string
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 256.
Obrigatório: Sim
- trackingId
-
O ID da transação do evento. O ID é gerado por uma chamada para a API CreateEventTracker.
Tipo: string
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 256.
Obrigatório: Sim
- userId
-
O usuário associado ao evento.
Tipo: string
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 256.
Obrigatório: Não
Sintaxe da Resposta
HTTP/1.1 200
Elementos de Resposta
Se a ação for bem-sucedida, o serviço reenviará uma resposta 200 HTTP com um corpo HTTP vazio.
Erros
- InvalidInputException
-
Forneça um valor válido para o campo ou parâmetro.
Código de Status HTTP: 400
Consulte Também
Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte: