ECOMMERCE datasets and schemas
When you create a Domain dataset group for the ECOMMERCE domain, each dataset type has a default schema with a set of ECOMMERCE-specific required and recommended fields. You can use the default schema or create a new one based on the default schema. The data you import must match your schema in format and type. Use the default domain schemas listed in the sections below as a guide to determine what data to import to create your ECOMMERCE-based recommender.
You are free to add additional fields. As long as the fields aren't listed as required or reserved, and the data types are listed in Schema data types, the field names and data types are up to you.
For information about general Amazon Personalize schema requirements, such as formatting requirements and available field data types, see Creating schema JSON files for Amazon Personalize schemas. These requirements apply to all schemas, regardless of domain.
The following topics provide information about each dataset's required and recommended fields for the ECOMMERCE domain. Each dataset section includes the default ECOMMERCE schema in JSON format.
Topics
ECOMMERCE domain dataset and schema requirements
Each dataset type has the following required fields and reserved keywords.
Reserved keywords are optional, non-metadata fields. These fields are considered reserved because you must define the fields
as their required data type when you use them. Reserved categorical string fields must have categorical
set to true
, while reserved string fields can't be
categorical. The keywords can't be in your data.
Dataset type | Required fields | Reserved keywords |
---|---|---|
Item interactions (default schema) |
USER_ID ( ITEM_ID ( TIMESTAMP ( EVENT_TYPE ( |
EVENT_VALUE ( IMPRESSION ( RECOMMENDATION_ID ( EVENT_ATTRIBUTION_SOURCE ( |
Users (default schema) |
USER_ID ( 1 metadata field (categorical |
|
Items (default schema) |
ITEM_ID ( PRICE ( CATEGORY_L1 (categorical |
CATEGORY_L2 (categorical CATEGORY_L3 (categorical PRODUCT_DESCRIPTION (textual CREATION_TIMESTAMP ( AGE_GROUP (categorical ADULT (categorical GENDER (categorical |