Using the PutActionInteractions operation
After you create an Action interactions dataset, you are ready to record action interaction events with the PutActionInteractions operation. The following sections show how to record a single event and how to record multiple events with event value data.
Recording a single action interaction event
The following code
shows a PutActionInteractions operation that passes a TAKEN event. You might record this
event when you show a user recommendations from Amazon Personalize and they take an action, such as applying for your credit card.
The actionInteractions is an array of ActionInteraction objects.
The trackingId comes from the event tracker Amazon Personalize created when you created your Action interactions dataset.
For more information, see Finding the ID of your action interaction event tracker.
Your application generates a unique sessionId when a user first visits your website or uses your
application. You must use the same sessionId in all events throughout the session. Amazon Personalize uses the
sessionId to associate events with the user before they log in (is anonymous). For more information, see
Recording events for
anonymous users.
The userId, actionId, and sentAt parameters map to the USER_ID, ACTION_ID,
EVENT_TYPE, and TIMESTAMP fields of the Action interactions dataset.
Corresponding Action interactions dataset
USER_ID, ACTION_ID, TIMESTAMP, EVENT_TYPE user123, action-xyz, 1543631760, TAKEN
Code example
Recording multiple action interaction events
The following code shows how to record multiple action interaction events for the same user with the same sessionId.
Corresponding Action interactions dataset
USER_ID, ACTION_ID, EVENT_TYPE, TIMESTAMP user123, action123, Taken, 1543531139 user123, action345, Not Taken, 1543531139