Usando a PutActionInteractions operação

Depois de criar um conjunto de dados de interações com ações, estará tudo pronto para registrar eventos de interação com ações com a operação PutActionInteractions. As seções a seguir mostram como registrar um único evento e como registrar vários eventos com dados de valor do evento.

Registrar um único evento de interação com ações

O código a seguir mostra uma operação PutActionInteractions que transmite um evento TAKEN. Você pode registrar esse evento quando mostrar recomendações do Amazon Personalize a um usuário e ele realizar uma ação, como solicitar um cartão de crédito.

actionInteractionsÉ uma matriz de ActionInteraction objetos. O trackingId vem do rastreador de eventos que o Amazon Personalize criou quando você criou o conjunto de dados de interações com ações. Para ter mais informações, consulte Encontrar o ID do rastreador de eventos de interações com ações.

Seu aplicativo gera um sessionId exclusivo quando alguém visita seu site ou usa seu aplicativo pela primeira vez. Você deve usar o mesmo sessionId em todos os eventos durante a sessão. O Amazon Personalize usa o sessionId para associar eventos ao usuário antes que ele faça login (com anonimato). Para ter mais informações, consulte Como registrar eventos de usuários anônimos.

Os parâmetros userId, actionId e sentAt são associados aos campos USER_ID, ACTION_ID, EVENT_TYPE e TIMESTAMP do conjunto de dados de interações com ações.

Conjunto de dados de interações com ações correspondente

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

Exemplo de código

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'
  }]
)

Registrar vários eventos de interação com ações

O código a seguir mostra como registrar vários eventos de interação com ações para o mesmo usuário com o mesmo sessionId.

Conjunto de dados de interações com ações correspondente

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'
  }]
)