Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
PutEvents
Enregistre les données relatives aux événements d'interaction avec les objets. Pour plus d'informations, consultez la section Enregistrement des événements d'interaction avec un élément.
Note
Si vous utilisez une AWS Lambda fonction pour appeler l' PutEvents opération, le rôle d'exécution de votre fonction doit être autorisé à effectuer l'personalize:PutEventsaction avec le caractère générique * dans l'Resourceélément.
Syntaxe de la demande
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"
}Paramètres de demande URI
La demande n’utilise pas de paramètres URI.
Corps de la demande
Cette demande accepte les données suivantes au format JSON.
- eventList
-
Liste des données d'événements de la session.
Type : tableau d’objets Event
Membres du tableau : Nombre minimum de 1 élément. Nombre maximum de 10 éléments.
Obligatoire : oui
- sessionId
-
L'identifiant de session associé à la visite de l'utilisateur. Votre application génère le SessionID lorsqu'un utilisateur visite votre site Web ou utilise votre application pour la première fois. Amazon Personalize utilise le SessionID pour associer des événements à l'utilisateur avant qu'il ne se connecte. Pour plus d'informations, consultez la section Enregistrement des événements d'interaction avec un élément.
Type : chaîne
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 256.
Obligatoire : oui
- trackingId
-
L'identifiant de suivi de l'événement. L'ID est généré par un appel à l'API CreateEventTracker.
Type : chaîne
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 256.
Obligatoire : oui
- userId
-
L'utilisateur associé à l'événement.
Type : chaîne
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 256.
Obligatoire : non
Syntaxe de la réponse
HTTP/1.1 200
Eléments de réponse
Si l’action aboutit, le service renvoie une réponse HTTP 200 avec un corps HTTP vide.
Erreurs
- InvalidInputException
-
Entrez une valeur valide pour le champ ou le paramètre.
Code d’état HTTP : 400
consultez aussi
Pour plus d'informations sur l'utilisation de cette API dans l'un des AWS SDK spécifiques au langage, consultez les pages suivantes :
