Event - 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.

Event

Représente les informations relatives aux événements d'interaction entre articles envoyées via l'PutEventsAPI.

Table des matières

eventType

Type d'événement, tel qu'un clic ou un téléchargement. Cette propriété correspond au EVENT_TYPE champ du schéma de votre jeu de données d'interactions entre articles et dépend des types d'événements que vous suivez.

Type : chaîne

Contraintes de longueur : longueur minimum de 1. Longueur maximale de 256.

Obligatoire : oui

sentAt

L'horodatage (en heure Unix) côté client lorsque l'événement s'est produit.

Type : Timestamp

Obligatoire : oui

eventId

Un identifiant associé à l'événement. Si aucun identifiant d'événement n'est fourni, Amazon Personalize génère un identifiant unique pour l'événement. Aucun identifiant d'événement n'est utilisé comme entrée dans le modèle. Amazon Personalize utilise l'identifiant de l'événement pour distinguer les événements uniques. Les événements suivants après le premier avec le même ID d'événement ne sont pas utilisés dans l'entraînement du modèle.

Type : chaîne

Contraintes de longueur : longueur minimum de 1. Longueur maximale de 256.

Obligatoire : non

eventValue

La valeur de l'événement qui correspond au EVENT_VALUE champ du schéma des interactions entre articles.

Type : flottant

Obligatoire : non

impression

Une liste d'identifiants d'éléments qui représente la séquence des éléments que vous avez montrés à l'utilisateur. Par exemple, ["itemId1", "itemId2", "itemId3"]. Fournissez une liste d'éléments pour enregistrer manuellement les données d'impressions pour un événement. Pour plus d'informations sur l'enregistrement des données d'impressions, consultez la section Enregistrement des données d'impressions.

Type : tableau de chaînes

Membres du tableau : Nombre minimum de 1 élément. Nombre maximum de 25 articles.

Contraintes de longueur : longueur minimum de 1. Longueur maximale de 256.

Obligatoire : non

itemId

La clé d'ID d'élément qui correspond au ITEM_ID champ du schéma du jeu de données d'interactions entre articles.

Type : chaîne

Contraintes de longueur : longueur minimum de 1. Longueur maximale de 256.

Obligatoire : non

metricAttribution

Contient des informations sur l'attribution des métriques associées à un événement. Pour plus d'informations sur les attributions métriques, voir Mesurer l'impact des recommandations.

Type : objet MetricAttribution

Obligatoire : non

properties

Une carte de chaînes de données spécifiques à un événement que vous pouvez choisir d'enregistrer. Par exemple, si un utilisateur évalue un film sur votre site, autre que l'identifiant du film (itemId) et le classement (eventValue), vous pouvez également envoyer le nombre d'évaluations de films effectuées par l'utilisateur.

Chaque élément de la carte est constitué d'une paire clé-valeur. Par exemple,

{"numberOfRatings": "12"}

Les clés utilisent des noms de camel qui correspondent aux champs du schéma du jeu de données Item Interactions. Dans l'exemple ci-dessus, le champ « NUMBER_OF_RATINGS » défini dans le schéma du jeu de données d'interactions Item numberOfRatings correspondrait.

Le texte suivant ne peut pas être inclus comme mot clé pour les propriétés (sans distinction majuscules/minuscules).

  • userId

  • sessionId

  • eventType

  • timestamp

  • ID de recommandation

  • impression

Type : chaîne

Contraintes de longueur : Longueur minimum de 1. Longueur maximale de 1024.

Obligatoire : non

recommendationId

ID de la liste de recommandations contenant l'élément avec lequel l'utilisateur a interagi. Fournissez un recommendationId pour qu'Amazon Personalize enregistre implicitement les recommandations que vous présentez à votre utilisateur sous forme de données d'impressions. Ou fournissez un recommendationId si vous utilisez une attribution métrique pour mesurer l'impact des recommandations.

Pour plus d'informations sur l'enregistrement des données d'impressions, consultez la section Enregistrement des données d'impressions. Pour plus d'informations sur la création d'une attribution métrique, voir Mesurer l'impact des recommandations.

Type : chaîne

Contraintes de longueur : longueur minimum de 1. Longueur maximale de 40

Obligatoire : non

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 :