Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Conjuntos de datos y esquemas de ECOMMERCE
Al crear un grupo de conjuntos de datos de dominio para el dominio de ECOMMERCE, cada tipo de conjunto de datos tiene un esquema predeterminado con un conjunto de campos obligatorios y recomendados específicos de ECOMMERCE. Puede usar el esquema predeterminado o crear uno nuevo basado en el esquema predeterminado. Los datos que importe deben coincidir con su esquema en cuanto a formato y tipo. Use los esquemas de dominio predeterminados que se enumeran en las secciones siguientes como guía para determinar qué datos importar para crear su generador de recomendaciones basado en ECOMMERCE.
Tiene la libertad de añadir campos adicionales. Siempre que los campos no figuren como obligatorios o reservados, y los tipos de datos figuren en [Tipos de datos de esquema](how-it-works-dataset-schema.md#personalize-datatypes), puede elegir los nombres de los campos y los tipos de datos.
Para obtener información sobre los requisitos generales de esquema de Amazon Personalize, como los requisitos de formato y los tipos de datos de campo disponibles, consulte [Creación de archivos JSON de esquema para los esquemas de Amazon Personalize](how-it-works-dataset-schema.md). Estos requisitos se aplican a todos los esquemas, con independencia del dominio.
Los siguientes temas proporcionan información sobre los campos obligatorios y recomendados de cada conjunto de datos para el dominio de ECOMMERCE. Cada sección del conjunto de datos incluye el esquema de ECOMMERCE predeterminado en formato JSON.
**Topics**
+ [Requisitos de esquema y conjunto de datos del dominio de ECOMMERCE](#ECOMMERCE-dataset-requirements)
+ [Requisitos del conjunto de datos de interacciones de elementos (dominio ECOMMERCE)](ECOMMERCE-interactions-dataset.md)
+ [Requisitos del conjunto de datos de usuarios (dominio de ECOMMERCE)](ECOMMERCE-users-dataset.md)
+ [Requisitos del conjunto de datos de elementos (dominio de ECOMMERCE)](ECOMMERCE-items-dataset.md)
## Requisitos de esquema y conjunto de datos del dominio de ECOMMERCE
Cada tipo de conjunto de datos tiene los siguientes campos obligatorios y palabras clave reservadas. Las palabras clave reservadas son campos opcionales que no son de metadatos. Estos campos se consideran reservados porque debe definirlos como su tipo de datos obligatorio cuando los utilice. Los campos de cadenas categóricas reservadas deben tener `categorical` establecido en `true`, mientras que los campos de cadenas reservadas no pueden ser categóricos. Las palabras clave no pueden estar en sus datos.
| Tipo de conjunto de datos | Campos obligatorios | Palabras clave reservadas |
| --- | --- | --- |
| Interacciones de elementos ([esquema predeterminado](ECOMMERCE-interactions-dataset.md#ECOMMERCE-interactions-schema)) | USER\$1ID (`string`) ITEM\$1ID (`string`) TIMESTAMP (`long`) EVENT\$1TYPE (`string` y según el [caso de uso](domain-use-cases.md), los tipos de eventos `Purchase` y `View`) | EVENT\$1VALUE (`float`, `null`) IMPRESSION (`string`, `null`) RECOMMENDATION\$1ID (`string`, `null`) EVENT\$1ATTRIBUTION\$1SOURCE (`string`, `null`) |
| Usuarios ([esquema predeterminado](ECOMMERCE-users-dataset.md#ECOMMERCE-users-dataset-schema)) | USER\$1ID (`string`) 1 campo de metadatos (`string` categórica o numérica) | |
| Elementos ([esquema predeterminado](ECOMMERCE-items-dataset.md#ECOMMERCE-items-dataset-schema)) | ITEM\$1ID (`string`) PRICE (`float`) CATEGORY\$1L1 (`string` categórica) | CATEGORY\$1L2 (`string`, categórica, `null`) CATEGORY\$1L3 (`string`, categórica, `null`) PRODUCT\$1DESCRIPTION (`string` textual, `null`) CREATION\$1TIMESTAMP (`long`) AGE\$1GROUP (`string` categórica, `null`) ADULT (`string` categórica, `null`) GENDER (`string` categórica, `null`) |
# Requisitos del conjunto de datos de interacciones de elementos (dominio ECOMMERCE)
Un *conjunto de datos de interacciones de elementos* almacena datos históricos y en tiempo real de las interacciones entre los usuarios y los elementos de su catálogo de ECOMMERCE. Para obtener más información acerca de los tipos de datos que puede almacenar en un conjunto de datos de interacciones, consulte [Datos de interacciones de elementos](interactions-datasets.md). Para obtener información sobre los requisitos generales de esquema de Amazon Personalize, como los requisitos de formato y los tipos de datos de campo disponibles, consulte [Creación de archivos JSON de esquema para los esquemas de Amazon Personalize](how-it-works-dataset-schema.md). Estos requisitos se aplican a todos los esquemas, con independencia del dominio.
Como mínimo, debe crear un conjunto de datos de interacciones de elementos y su esquema debe tener los siguientes campos:
+ USER\$1ID (`string`)
+ ITEM\$1ID (`string`)
+ TIMESTAMP (`long`)
+ EVENT\$1TYPE (`string` y según el [caso de uso](domain-use-cases.md), los tipos de eventos `Purchase` y `View`)
El esquema también puede incluir las siguientes palabras clave reservadas:
+ EVENT\$1VALUE (`float`, `null`)
+ IMPRESSION (`string`, `null`)
+ RECOMMENDATION\$1ID (`string`, `null`)
Los datos que importe deben coincidir con su esquema. Tiene la libertad de añadir campos adicionales según su caso de uso y sus datos. Siempre que los campos no figuren como obligatorios o reservados, y los tipos de datos figuren en [Tipos de datos de esquema](how-it-works-dataset-schema.md#personalize-datatypes), puede elegir los nombres de los campos y los tipos de datos. Para ver un ejemplo del esquema predeterminado de los conjuntos de datos de interacciones de elementos para dominios ECOMMERCE, consulte [Esquema de interacciones predeterminado (dominio de ECOMMERCE)](#ECOMMERCE-interactions-schema).
Si lo desea, añada la palabra clave reservada EVENT\$1VALUE si tiene datos de valor para eventos. Si desea incluir datos de impresiones explícitos e implícitos, también puede añadir la palabra clave reservada IMPRESSION. Para obtener más información acerca del registro de datos de impresiones, consulte [Datos de impresiones](interactions-datasets.md#interactions-impressions-data).
El número máximo total de campos de metadatos opcionales que puede agregar a un conjunto de datos de interacciones de elementos, combinado con el número total de tipos de eventos *distintos* en sus datos de interacciones de elementos, es de 10. Los campos de metadatos incluidos en este recuento son los campos EVENT\$1TYPE y EVENT\$1VALUE, junto con cualquier campo de metadatos personalizados que añada al esquema. El número máximo de campos de metadatos, excluidos los campos reservados, como IMPRESSION, es 5. Los valores categóricos pueden tener 1000 caracteres como máximo. Si tiene una interacción con un valor categórico con más de 1000 caracteres, se generará un error en su trabajo de importación del conjunto de datos.
Para obtener más información sobre los requisitos mínimos y los límites máximos de datos de un conjunto de datos de interacciones de elementos para el dominio ECOMMERCE, consulte [Cuotas de servicio](limits.md#limits-table).
## Esquema de interacciones predeterminado (dominio de ECOMMERCE)
El siguiente es el esquema del dominio ECOMMERCE predeterminado para los conjuntos de datos de interacciones de elementos.
```
{
"type": "record",
"name": "Interactions",
"namespace": "com.amazonaws.personalize.schema",
"fields": [
{
"name": "USER_ID",
"type": "string"
},
{
"name": "ITEM_ID",
"type": "string"
},
{
"name": "EVENT_TYPE",
"type": "string"
},
{
"name": "TIMESTAMP",
"type": "long"
}
],
"version": "1.0"
}
```
# Requisitos del conjunto de datos de usuarios (dominio de ECOMMERCE)
Un *conjunto de datos de usuarios* almacena metadatos sobre sus usuarios. Esto puede incluir información como la edad, el sexo y el grado de fidelización para cada usuario. Para obtener más información sobre los tipos de datos de usuario que puede importar en Amazon Personalize, consulte [Metadatos de usuario](users-datasets.md). Para obtener información sobre los requisitos generales de esquema de Amazon Personalize, como los requisitos de formato y los tipos de datos de campo disponibles, consulte [Creación de archivos JSON de esquema para los esquemas de Amazon Personalize](how-it-works-dataset-schema.md). Estos requisitos se aplican a todos los esquemas, con independencia del dominio.
Un conjunto de datos de usuarios es opcional para todos los casos de uso de ECOMMERCE. Si tiene datos de usuario, te recomendamos crear uno para obtener las recomendaciones más relevantes. Si crea un conjunto de datos de usuarios, su esquema debe incluir los siguientes campos.
+ USER\$1ID
+ 1 campo de metadatos (`string` categórica o numérica)
Los datos que importe deben coincidir con su esquema. Tiene la libertad de añadir campos adicionales según su caso de uso y sus datos. Siempre que los campos no figuren como obligatorios o reservados, y los tipos de datos figuren en [Tipos de datos de esquema](how-it-works-dataset-schema.md#personalize-datatypes), puede elegir los nombres de los campos y los tipos de datos. Para ver un ejemplo del esquema predeterminado de los conjuntos de datos de usuarios para dominios de ECOMMERCE, consulte [Esquema de usuarios predeterminado (dominio de ECOMMERCE)](#ECOMMERCE-users-dataset-schema).
Para obtener más información sobre los requisitos mínimos y los límites máximos de datos para un conjunto de datos de usuarios, consulte [Cuotas de servicio](limits.md#limits-table).
## Uso de datos categóricos
Para usar datos categóricos, agregue un campo de tipo `string` y establezca el atributo categórico del campo en `true` en su esquema. A continuación, incluya los datos categóricos en el archivo CSV masivo y en las importaciones de registros individuales. Para los usuarios con varias categorías, separe cada valor con la barra vertical, “\$1”. Por ejemplo, para un campo SUBSCRIPTION\$1MODEL, sus datos para un usuario pueden ser estudiante\$1mensual\$1descuento.
Los valores categóricos pueden tener 1000 caracteres como máximo. Si tiene un usuario con un valor categórico con más de 1000 caracteres, se generará un error en su trabajo de importación del conjunto de datos.
## Esquema de usuarios predeterminado (dominio de ECOMMERCE)
El siguiente es el esquema de dominio de ECOMMERCE predeterminado para los conjuntos de datos de usuarios con un campo CATEGORY como el campo de metadatos obligatorio.
```
{
"type": "record",
"name": "Users",
"namespace": "com.amazonaws.personalize.schema",
"fields": [
{
"name": "USER_ID",
"type": "string"
},
{
"name": "MEMBERSHIP_STATUS",
"type": "string",
"categorical": true
}
],
"version": "1.0"
}
```
# Requisitos del conjunto de datos de elementos (dominio de ECOMMERCE)
Un *conjunto de datos de elementos* almacena metadatos sobre sus elementos de ECOMMERCE. Esto puede incluir información como el precio, la categoría y la descripción del producto de cada elemento. Para obtener más información sobre los tipos de datos de elementos que puede importar en Amazon Personalize, consulte [Metadatos de elemento](items-datasets.md). Para obtener información sobre los requisitos generales de esquema de Amazon Personalize, como los requisitos de formato y los tipos de datos de campo disponibles, consulte [Creación de archivos JSON de esquema para los esquemas de Amazon Personalize](how-it-works-dataset-schema.md). Estos requisitos se aplican a todos los esquemas, con independencia del dominio.
Un conjunto de datos de elementos es opcional para todos los casos de uso de ECOMMERCE. Si tiene datos de elementos, recomendamos crear uno para obtener las recomendaciones más relevantes. Si crea un conjunto de datos de elementos, su esquema debe incluir los siguientes campos:
+ ITEM\$1ID
+ PRICE (`float`)
+ CATEGORY\$1L1 (`string` categórica)
El esquema también puede incluir las siguientes palabras clave reservadas. Para los campos categóricos, puede definir su propio rango de valores en función de su caso de uso.
+ CATEGORY\$1L2 (`string`, categórica, `null`)
+ CATEGORY\$1L3 (`string`, categórica, `null`)
+ PRODUCT\$1DESCRIPTION (`string` textual, `null`)
+ CREATION\$1TIMESTAMP (`float`)
+ AGE\$1GROUP (`string` categórica, `null`): el grupo de edad al que pertenece el elemento. Los valores pueden ser recién nacidos, bebés, niños y adultos.
+ ADULTO (`string` categórica, `null`): si el elemento está restringido solo a adultos, por ejemplo, bebidas alcohólicas. Los valores pueden ser sí o no.
+ GÉNERO (`string` categórica, `null`): el género al que corresponde el elemento. Los valores pueden ser hombre, mujer y unisex.
Para obtener las mejores recomendaciones, le recomendamos que mantenga tantos campos de estos en el esquema como datos tenga. Los datos que importe deben coincidir con su esquema. Los datos que importe deben coincidir con su esquema. El número máximo de columnas de metadatos es 100. Tiene la libertad de añadir campos adicionales según su caso de uso y sus datos. Siempre que los campos no figuren como obligatorios o reservados, y los tipos de datos figuren en [Tipos de datos de esquema](how-it-works-dataset-schema.md#personalize-datatypes), puede elegir los nombres de los campos y los tipos de datos.
Utilice las palabras clave reservadas CATEGORY\$1L2 y CATEGORY\$1L3 para los elementos con varias categorías de múltiples niveles. Para obtener más información, consulte [Uso de datos categóricos](#ECOMMERCE-items-categorical-data). Para obtener información sobre metadatos textuales y categóricos, consulte [Metadatos de texto no estructurado](items-datasets.md#text-data). Para ver un ejemplo del esquema predeterminado para los conjuntos de datos de elementos para dominios de ECOMMERCE, consulte [Esquema de elementos predeterminados (dominio de ECOMMERCE)](#ECOMMERCE-items-dataset-schema).
## Uso de datos categóricos
Para usar datos categóricos, agregue un campo de tipo `string` y establezca el atributo categórico del campo en `true` en su esquema. A continuación, incluya los datos categóricos en su archivo CSV masivo y en las importaciones de elementos individuales. Puede definir su propio rango de valores en función de su caso de uso. Los valores categóricos pueden tener 1000 caracteres como máximo. Si tiene un elemento con un valor categórico con más de 1000 caracteres, se generará un error en su trabajo de importación del conjunto de datos.
Para los elementos con varias categorías, separe cada valor con la barra vertical, “\$1”. Por ejemplo, para un campo CATEGORY\$1L1, los datos para un elemento podrían ser `Electronics|Productivity|Mouse`. Si tiene varios niveles de datos categóricos y algunos elementos tienen varias categorías para cada nivel de la jerarquía, agregue un campo para cada nivel y un indicador de nivel después del nombre de cada campo: CATEGORY\$1L1, CATEGORY\$1L2, CATEGORY\$1L3. Esto le permite filtrar las recomendaciones en función de las subcategorías, incluso si un elemento pertenece a varias categorías de múltiples niveles. Por ejemplo, un elemento puede tener los siguientes datos para cada nivel de categoría:
+ CATEGORY\$1L1: Electrónica\$1Productividad
+ CATEGORY\$1L2: Productividad\$1Ordenadores
+ CATEGORY\$1L3: Ratón
En este ejemplo, el elemento se encuentra en la jerarquía electrónica > productividad > ratón *y* productividad > ordenadores > ratón. Recomendamos usar solo hasta L3, pero puede usar más niveles si es necesario. Para obtener información sobre la creación y el uso de filtros, consulte [Recomendaciones de filtrado y segmentos de usuarios](filter.md).
## Esquema de elementos predeterminados (dominio de ECOMMERCE)
El siguiente es el esquema predeterminado para conjuntos de datos de elementos para el dominio de ECOMMERCE con solo los campos obligatorios.
```
{
"type": "record",
"name": "Items",
"namespace": "com.amazonaws.personalize.schema",
"fields": [
{
"name": "ITEM_ID",
"type": "string"
},
{
"name": "PRICE",
"type": "float"
},
{
"name": "CATEGORY_L1",
"type": [
"string"
],
"categorical": true
}
],
"version": "1.0"
}
```