PutEvents - Amazon Personalize

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 uma AWS Lambda função para chamar a PutEvents operação, a função de execução da função deverá ter permissão para realizar a personalize:PutEvents ação com o caractere curinga * no Resource elemento.

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 AWS SDKs específicos da linguagem, consulte o seguinte: