Requisitos do conjunto de dados de itens (domínio ECOMMERCE)

Um conjunto de dados de itens armazena metadados sobre seus itens de ECOMMERCE. Isso pode incluir informações como preço, categoria e descrição do produto para cada item. Para obter mais informações sobre os tipos de dados de item que você pode importar para o Amazon Personalize, consulte conjunto de dados de itens. Para obter informações sobre os requisitos gerais de esquema do Amazon Personalize, como requisitos de formatação e tipos de dados de campo disponíveis, consulte Esquemas. Esses requisitos aplicam-se a todos os esquemas, independentemente do domínio.

Um conjunto de dados de itens é opcional para todos os casos de uso de ECOMMERCE. Se você tiver dados de itens , recomendamos criar um conjunto de dados de itens para obter as recomendações mais relevantes. Se você criar um conjunto de dados de itens, seu esquema deverá incluir os seguintes campos:

• ITEM_ID

• PRICE (float)

• CATEGORY_L1 (string categórico)

Seu esquema também pode incluir as seguintes palavras-chave reservadas. Para campos categóricos, você pode definir seu próprio intervalo de valores com base no seu caso de uso.

• CATEGORY_L2 (string categórico, null)

• CATEGORY_L3 (string categórico, null)

• PRODUCT_DESCRIPTION (string textual, null)

• CREATION_TIMESTAMP (float)

• AGE_GROUP (string categórico, null): a faixa etária para a qual o item se destina. Os valores podem ser recém-nascidos, bebês, crianças e adultos.

• ADULT (string categórico, null): se o item é restrito apenas a adultos, como bebidas alcoólicas. Os valores podem ser sim ou não.

• GENDER (string categórico, null): o gênero ao qual o item se destina. Os valores podem ser masculino, feminino e unissex.

Para obter as recomendações melhores, recomendamos que você mantenha uma quantidade desses campos em seu esquema equivalente aos dados que você tiver. Os dados que você importa devem corresponder ao seu esquema. Os dados que você importa devem corresponder ao seu esquema. O número máximo de colunas de metadados é 100. Você pode adicionar outros campos, dependendo do seu caso de uso e dos seus dados. Desde que os campos não estejam listados como obrigatórios ou reservados e os tipos de dados estejam listados em Tipos de dados do esquema, é você quem escolhe os nomes e tipos de dados dos campos.

Use as palavras-chave reservadas CATEGORY_L2 e CATEGORY_L3 para itens com várias categorias de vários níveis. Para ter mais informações, consulte Usar dados categóricos. Para obter informações sobre metadados textuais e categóricos, consulte Metadados de texto não estruturados. Para obter um exemplo do esquema padrão para conjuntos de dados de itens para domínios ECOMMERCE, consulte Esquema de itens padrão (domínio ECOMMERCE).

Usar dados categóricos

Para usar dados categóricos, adicione um campo do tipo string e defina o atributo categórico do campo como true em seu esquema. Em seguida, inclua os dados categóricos no arquivo CSV em massa e nas importações de itens individuais. Você pode definir seu próprio intervalo de valores com base em seu caso de uso. Os valores categóricos podem ter no máximo 1.000 caracteres. Se você tiver um item com um valor categórico com mais de 1.000 caracteres, sua tarefa de importação do conjunto de dados falhará.

Para itens com várias categorias, separe cada valor com a barra vertical '|'. Por exemplo, para um campo CATEGORY_L1, seus dados de um item podem ser Electronics|Productivity|Mouse. Se você tiver vários níveis de dados categóricos e alguns itens tiverem várias categorias para cada nível na hierarquia, adicione um campo para cada nível e acrescente um indicador de nível após cada nome de campo: CATEGORY_L1, CATEGORY_L2, CATEGORY_L3. Isso permite filtrar recomendações com base em subcategorias, mesmo que um item pertença a várias categorias de vários níveis. Por exemplo, um item pode ter os seguintes dados para cada nível de categoria:

• CATEGORY_L1: Eletrônicos|Produtividade

• CATEGORY_L2: Produtividade|Computadores

• CATEGORIA_L3: Mouse

Neste exemplo, o item está na hierarquia eletrônicos > produtividade > mouse e na hierarquia produtividade > computadores > mouse. Recomendamos usar apenas até L3, mas você pode usar mais níveis, se necessário. Para mais informações sobre como criar e usar filtros, consulte Como filtrar recomendações e segmentos de usuários.

Esquema de itens padrão (domínio ECOMMERCE)

Veja a seguir o esquema padrão para conjuntos de dados de itens para o domínio ECOMMERCE com apenas os campos obrigatórios.

{
  "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"
}