Utilisation de l' PutActionInteractions opération

Après avoir créé un jeu de données d'interactions d'action, vous êtes prêt à enregistrer les événements d'interaction d'action avec l'PutActionInteractionsopération. Les sections suivantes montrent comment enregistrer un seul événement et comment enregistrer plusieurs événements avec des données de valeur d'événement.

Enregistrement d'un événement d'interaction avec une seule action

Le code suivant montre une PutActionInteractions opération qui transmet un événement TAKEN. Vous pouvez enregistrer cet événement lorsque vous montrez à un utilisateur les recommandations d'Amazon Personalize et qu'il entreprend une action, telle qu'une demande de carte de crédit.

actionInteractionsIl s'agit d'un ensemble d' ActionInteraction objets. Il trackingId provient du système de suivi d'événements Amazon Personalize créé lorsque vous avez créé votre ensemble de données d'interactions Action. Pour plus d’informations, consultez Trouver l'identifiant de votre outil de suivi des événements d'interaction et d'action.

Votre application génère un code unique sessionId lorsqu'un utilisateur visite votre site Web ou utilise votre application pour la première fois. Vous devez utiliser le même sessionId dans tous les événements de la session. Amazon Personalize utilise le sessionId pour associer des événements à l'utilisateur avant qu'il ne se connecte (c'est anonyme). Pour plus d’informations, consultez Enregistrement d'événements pour les utilisateurs anonymes.

Les sentAt paramètres userIdactionId, et correspondent aux champs USER_ID, ACTION_ID, EVENT_TYPE et TIMESTAMP du jeu de données Action interactions.

Ensemble de données d'interactions Action correspondant

USER_ID, ACTION_ID, TIMESTAMP, EVENT_TYPE
user123, action-xyz, 1543631760, TAKEN

Exemple de code

AWS CLI

aws personalize-events put-action-interactions \
--tracking-id 12345678-xxxx-xxxx-xxxx-xxxxxxxxxxxx \
--action-interactions '[{
  "userId": "user123",
  "sessionId": "abcdefg",
  "timestamp": 1543631760,
  "eventType": "TAKEN",
  "actionId": "action-xyz"}]'

SDK for Python (Boto3)

import boto3

personalize_events = boto3.client(service_name='personalize-events')

response = personalize_events.put_action_interactions(
  trackingId='12345678-xxxx-xxxx-xxxx-xxxxxxxxxxxx',
  actionInteractions=[{
    'userId': 'user123',
    'sessionId': 'abcdefg',
    'timestamp': 1543631760,
    'eventType': 'Taken',
    'actionId': 'action-xyz'
  }]
)

Enregistrement de plusieurs événements d'interaction entre actions

Le code suivant montre comment enregistrer plusieurs événements d'interaction d'action pour le même utilisateur avec le même SessionId.

Ensemble de données d'interactions Action correspondant

USER_ID, ACTION_ID, EVENT_TYPE, TIMESTAMP
user123, action123, Taken, 1543531139
user123, action345, Not Taken, 1543531139

AWS CLI

aws personalize-events put-action-interactions \
--tracking-id 6ddfe6b7-cd83-4dd4-b09d-4c35ecbacfe1 \
--action-interactions '[{
  "userId": "user123",
  "sessionId": "abcdefg",
  "timestamp": 1543531139,
  "eventType": "Taken",
  "actionId": "action123"
},
{
  "userId": "user123",
  "sessionId": "abcdefg",
  "timestamp": 1543531139,
  "eventType": "Not Taken",
  "actionId": "action345"}]'

SDK for Python (Boto3)

import boto3

personalize_events = boto3.client(service_name='personalize-events')

response = personalize_events.put_action_interactions(
  trackingId='12345678-xxxx-xxxx-xxxx-xxxxxxxxxxxx',
  actionInteractions=[{
    'userId': 'user123',
    'sessionId': 'abcdefg',
    'timestamp': 1697848587,
    'eventType': 'Taken',
    'actionId': 'action123'
  },
  {
    'userId': 'user123',
    'sessionId': 'abcdefg',
    'timestamp': 1697848622,
    'eventType': 'Not Taken',
    'actionId': 'action345'
  }]
)