Action interactions dataset - Amazon Personalize
Event type data
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Action interactions dataset

An action interaction is an interaction involving a user and an action in your Actions dataset. You import action interactions into an Amazon Personalize Action interactions dataset. Each action interaction consists of a userID, actionID, timestamp, event type, and any additional data about the interaction, such as categorical metadata.

For example, if you have an enroll action in your Actions dataset, and a user takes this action, you would record the user's ID, the action's ID, the timestamp, and for event type, record TAKEN. You can import action interaction events in bulk with a dataset import job, or you can stream them in real time with the PutActionInteractions API operation. For more information about importing data, see Step 2: Preparing and importing data.

Note

You can't create next best action resources, including Actions and Action Interactions datasets, in a domain dataset group.

When you use a PERSONALIZED_ACTIONS custom recipe, Amazon Personalize uses any data in your Action interactions dataset as input to predict the actions your users will most likely take. There is no minimum requirement for action interactions data. We recommend that you import it for quality action recommendations. If you don't have action interaction data, you can create an empty Action interactions dataset and record your customers' interactions with actions by using the PutActionInteractions API operation.

Until you import action interaction data, Amazon Personalize recommends actions in your without personalization, and propensity scores are 0.0. An action will have a score after the action has the following:

  • At least 50 action interactions with the TAKEN event type.

  • At least 50 action interactions with the NOT_TAKEN or VIEWED event type.

These action interactions must be present at the latest solution version training, and must occur within a span of 6 weeks from the latest interaction timestamp in the Action interactions dataset.

The following topics provide more information about the action interaction data that Amazon Personalize can use.

Event type data

Amazon Personalize can use patterns in event type data to identify the actions your users will most likely take. For example, if a customer frequently ignores an email subscription action (indicated with the NOT_TAKEN event type), Amazon Personalize might adjust recommendations to feature fewer of this type of action.

You can use only the following event types for action interaction events. Amazon Personalize uses these events to learn about your user and calculate what actions to recommend next.

  • Taken – Record Taken events when a user takes a recommended action.

  • Not Taken – Record Not Taken events when your user makes a deliberate choice to not take the action after viewing it. For example, if they choose No when you show them the action. Not Taken events can indicate the customer isn’t interested in the action.

  • Viewed – Record Viewed events when you show a user an action before they make a choice to take or not take an action. Amazon Personalize uses View events to learn about your users' interests. For example, if a user views an action but doesn't take it, this user might not be interested in this action in the future.