Utilizzo dell'operazione PutActionInteractions

Dopo aver creato un set di dati sulle interazioni Action, sei pronto per registrare gli eventi di interazione con l'PutActionInteractionsoperazione. Le sezioni seguenti mostrano come registrare un singolo evento e come registrare più eventi con i dati relativi ai valori degli eventi.

Registrazione di un singolo evento di interazione

Il codice seguente mostra un'PutActionInteractionsoperazione che supera un evento TAKEN. Potresti registrare questo evento quando mostri i consigli di Amazon Personalize a un utente che intraprende un'azione, come richiedere la tua carta di credito.

actionInteractionsSi tratta di una serie di ActionInteraction oggetti. trackingIdViene dal tracker di eventi Amazon Personalize creato al momento della creazione del set di dati sulle interazioni Action. Per ulteriori informazioni, consulta Individuazione dell'ID del tracker degli eventi di interazione delle azioni.

La tua applicazione genera un codice univoco sessionId quando un utente visita per la prima volta il tuo sito Web o utilizza l'applicazione. È necessario utilizzare lo stesso sessionId in tutti gli eventi durante la sessione. Amazon Personalize lo utilizza sessionId per associare gli eventi all'utente prima che effettui l'accesso (è anonimo). Per ulteriori informazioni, consulta Registrazione di eventi per utenti anonimi.

I sentAt parametri userIdactionId, e vengono mappati ai campi USER_ID, ACTION_ID, EVENT_TYPE e TIMESTAMP del set di dati sulle interazioni Action.

Set di dati sulle interazioni Action corrispondenti

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

Esempio di codice

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

Registrazione di eventi di interazione con azioni multiple

Il codice seguente mostra come registrare più eventi di interazione con azioni per lo stesso utente con lo stesso SessionID.

Set di dati sulle interazioni di azione corrispondenti

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