Users dataset

A Users dataset stores metadata about your users. This might include information such as age, gender, or loyalty membership.

When you create a Users dataset, you must also create a schema for the dataset. A schema tells Amazon Personalize about the structure of your data and allows Amazon Personalize to parse the data. For an example of a Users schema, see Users schema example. For information on schema requirements see Dataset and schema requirements.

This section provides information about required user data and the kinds of user data you can upload for training. It also includes a Users schema example. For information about importing user data into a Users dataset, see Preparing and importing data.

Once you create a Users dataset and add user data, you can then filter recommendations to include or exclude items based on specific user conditions. For more information see Filtering recommendations.

Note

RELATED_ITEMS recipes, such as item-to-item similarities (SIMS), do not use Users datasets.

Required user data

The training data you provide for each user must match your schema. At minimum, you must provide a User ID for each user. Depending on your schema, user metadata can include empty/null values. Categorical values can have at most 1000 characters. Any user with a categorical value with more than 1000 is dropped during a dataset import job and is not used in training.

For more information on minimum requirements and maximum data limits for a Users dataset, see Service quotas.

Users schema example

The following example shows a Users schema in Avro format. The USER_ID field is required and the AGE and GENDER fields are metadata. At least one metadata field is required and you can add at most 5 metadata fields. For information on schema requirements see Dataset and schema requirements.

{
  "type": "record",
  "name": "Users",
  "namespace": "com.amazonaws.personalize.schema",
  "fields": [
      {
          "name": "USER_ID",
          "type": "string"
      },
      {
          "name": "AGE",
          "type": "int"
      },
      {
          "name": "GENDER",
          "type": "string",
          "categorical": true
      }
  ],
  "version": "1.0"
}