PutEvents
Registra los datos de los eventos de interacción de elementos. Para obtener más información, consulte Registro de eventos de interacción de elementos.
nota
Si utiliza una función AWS Lambda para llamar a la operación PutEvents, el rol de ejecución de la función debe tener permiso para realizar la acción personalize:PutEvents con el carácter comodín * en el elemento Resource.
Sintaxis de la solicitud
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 de solicitud del URI
La solicitud no utiliza ningún parámetro de URI.
Cuerpo de la solicitud
La solicitud acepta los siguientes datos en formato JSON.
- eventList
-
Una lista de datos de eventos de la sesión.
Tipo: Matriz de Event objetos
Miembros de la matriz: número mínimo de 1 artículo. La cantidad máxima es de 10 elementos.
Obligatorio: sí
- sessionId
-
ID de sesión asociado a la visita del usuario. La aplicación genera el sessionId cuando un usuario visita por primera vez su sitio web o utiliza su aplicación. Amazon Personalize usa el sessionId para asociar eventos con el usuario antes de que inicie sesión. Para obtener más información, consulte Registro de eventos de interacción de elementos.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 256 caracteres.
Obligatorio: sí
- trackingId
-
ID de seguimiento del evento. El ID se genera mediante una llamada a la API CreateEventTracker.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 256 caracteres.
Obligatorio: sí
- userId
-
El usuario asociado al evento.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 256 caracteres.
Obligatorio: no
Sintaxis de la respuesta
HTTP/1.1 200
Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.
Errores
- InvalidInputException
-
Proporcione un valor válido para el campo o el parámetro.
Código de estado HTTP: 400
Véase también
Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
