View a markdown version of this page

PutEvents - Amazon Personalize

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 entre les objets. Pour plus d'informations, consultez la section Enregistrement des événements d'interaction entre les éléments.

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 relatives aux é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 pour la première fois votre site Web ou utilise votre application. 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 entre les éléments.

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'CreateEventTrackerAPI.

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

Fournissez une valeur valide pour le champ ou le paramètre.

Code d’état HTTP : 400

Voir aussi

Pour plus d'informations sur l'utilisation de cette API dans l'un des AWS kits SDK spécifiques à une langue, consultez les rubriques suivantes :