Você está aqui:
Category ETL Feed de dados
Use o feed de dados ETL da categoria para adicionar categorias ao seu catálogo ao criar suas hierarquias de categorias. Você pode atualizar categorias carregando arquivos subsequentes que incluam IDs de categoria existentes. As categorias são configuradas por padrão, mas você pode adicionar atributos a elas.
Sobre a ingestão de dados de categoria
As categorias oferecem suporte a uma estrutura de hierarquia que permite que as categorias individuais tenham as categorias pai e filho. Uma categoria pode ter apenas uma categoria pai, mas pode ter várias categorias filhas. Algumas categorias de exemplo são roupas, camisas, jaquetas, camisetas, camisetas de vestir, jaquetas de chuva e jaquetas de inverno.
Alguns exemplos das hierarquias completas são: roupas> camisas>t-shirts, roupas> camisas de vestir, roupas>camisetas>camisetas de chuva, roupas>camisetas>camisetas de inverno. O feed de dados ETL da categoria cria esses relacionamentos usando o valor correspondente do campo attribute:parentCategoryId.
- Cada categoria deve aparecer apenas em um único registro em um arquivo. Vários registros com o mesmo ID causam erros, especialmente se tiverem IDs de categoria pai diferentes.
- A personalização atualiza todas as colunas (campos) que você inclui no arquivo, substituindo os dados existentes pelo conteúdo nas linhas da coluna. Se uma linha de coluna estiver em branco, a Personalização removerá os dados existentes que serão mapeados para a linha em branco. Se você não quiser atualizar nem editar um valor existente, não inclua a coluna para esse valor em seu arquivo ETL.
- Os IDs de categoria em produtos ou em qualquer outro item do catálogo em Personalização devem corresponder aos IDs de categoria fornecidos no arquivo ETL da categoria.
- O feed de dados ETL da categoria não aceita arquivos delta. Você deve enviar toda a estrutura de categorias no arquivo, independentemente de cada registro no arquivo ter sido alterado. A personalização remove valores existentes do catálogo quando uma coluna contém valores em branco.
Requisitos
- Os arquivos ETL devem estar em um formato de arquivo CSV que cumpra o esquema do feed de dados. Arquivos que não seguem as convenções de nomenclatura de arquivo ou o esquema adequado resultam em erros e não são processados.
- Os nomes de campo que começam com
attribute:devem corresponder aos nomes de atributo personalizados na seção Atributos da página Objetos de catálogo e perfil > Categoria.
Formato do nome do arquivo
category-YYYY-MM-DD_HH-MM-SS.csv
Esquema
| Nome do campo | Descrição | Valores de exemplo | Comprimento máximo | Tipo de dados |
|---|---|---|---|---|
id
|
Obrigatório. Representa o identificador da categoria. Os IDs de categoria não devem conter nenhuma indicação de hierarquia. O arquivo ETL cria a hierarquia para o catálogo. |
roupas camisas calças cat0001 |
255 |
String |
attribute:
|
Os atributos personalizados da categoria. Os cabeçalhos de coluna começam com |
attribute:commonName Todas as roupas attribute:size grande |
1023 |
Qualquer |
attribute:parentCategoryId
|
Recomendado. O pai singular de um ID de categoria. As categorias raiz não devem ter parentCategoryId e, em vez disso, devem ter um valor verdadeiro na coluna attribute:department. Cada ID deve ter um único parentCategoryId. A personalização usa IDs de categoria pai para criar uma hierarquia interna. Por exemplo, uma categoria de "slacks" com um parentCategoryId de "dress pants" que tem um parentCategoryId de "pants" resulta em uma hierarquia de calças|dress pants|slacks. A profundidade máxima da hierarquia é de 10 níveis. |
roupas calças sapatos |
255 |
String |
attribute:department
|
Representa se uma categoria é de nível superior. Esse valor é false por padrão. |
Verdadeiro Falso |
1023 |
Booleano |
attribute:name
|
Representa o nome da categoria e deve conter pelo menos um caractere alfanumérico. |
Sapatos |
1023 |
String |
attribute:url
|
Um URL em conformidade com RFC-3986 que representa a página de exibição canônica para a categoria. |
https://example.com/products/cat1.html |
1023 |
String |
attribute:imageUrl
|
URL totalmente qualificado para uma imagem da categoria. |
https://example.com/img/img1.png |
1023 |
String |
attribute:description
|
Representa a descrição da categoria e deve conter pelo menos um caractere alfanumérico. |
Sapatos masculinos |
250 |
String |
attribute:promotable
|
Esse campo usa como padrão true. Quando definido como falso, a Personalização não devolve o produto no sistema de recomendação de receitas do Einstein. Se nenhum valor for definido, esse campo usará true como padrão. |
TRUE |
1023 |
Booleano |
attribute:published
|
Uma string de data e hora da ISO 8601 para a data de publicação da categoria. Não há suporte para deslocamentos de fuso horário. |
2022-04-12T10:23:37Z |
1023 |
Data |
attribute:expiration
|
Uma string de data e hora da ISO 8601 para a data de expiração da categoria. Não há suporte para deslocamentos de fuso horário. |
2022-04-12T10:23:37Z |
1023 |
Data |
attribute:rating
|
O valor de classificação associado à categoria. Nenhuma escala específica é necessária, porém, forneça apenas o valor. 9 é válido, 9/10 é inválido. |
4.5 |
1023 |
Decimal/flutuante |
attribute:numRatings
|
O número de classificações associadas à categoria. |
57 |
1023 |
Inteiro |
attribute:archived
|
Indica se a categoria está visível no catálogo. Quando verdadeiro, a categoria não fica visível. O padrão é false. Se essa coluna for omitida do arquivo, nenhuma alteração será feita no atributo. Se nenhum valor for definido, esse campo usará false como padrão. |
FALSE falso TRUE verdadeiro |
1023 |
Booleano |
Arquivo de amostra
| id | attribute:parentCategoryId | attribute:department | attribute:name | attribute:archived | attribute:url | attribute:imageUrl | attribute:description | attribute:promotable | attribute:published | attribute:expiration | attribute:rating | attribute:numRatings | attribute:commonName |
cat0001 |
TRUE |
Início |
FALSE |
test.com/c/home |
test.com/c/home.jpeg |
Todos os bens de residência |
TRUE |
2020-06-15 |
2100-01-01 |
5,0 |
5 |
Bens de residência |
|
cat002 |
TRUE |
Sapatos |
FALSE |
test.com/c/shoes |
test.com/c/shoes.jpeg |
Todos os sapatos |
TRUE |
2020-06-15 |
2100-01-01 |
4.25 |
10 |
Nossos sapatos |
|
cat003 |
TRUE |
Camisas |
FALSE |
test.com/c/shirts |
test.com/c/shirts.jpeg |
Todas as camisas |
TRUE |
2020-06-15 |
2100-01-01 |
4.75 |
35 |
Nossas camisas |
|
cat004 |
TRUE |
Calças |
FALSE |
test.com/c/pants |
test.com/c/pants.jpeg |
Todas as calças |
TRUE |
2020-06-15 |
2100-01-01 |
3,0 |
31 |
Nossas calças |
|
cat005 |
TRUE |
Chapéus |
FALSE |
test.com/c/hats |
test.com/c/hats.jpeg |
Todos os chapéus |
TRUE |
2020-06-15 |
2100-01-01 |
3,0 |
11 |
Nossos chapéus |
|
cat006 |
TRUE |
Acessórios |
FALSE |
test.com/c/accessories |
test.com/c/accessories.jpeg |
Todos os acessórios |
FALSE |
2020-06-15 |
2100-01-01 |
18 |
Nossos acessórios |
||
cat0021 |
cat002 |
Sneakers |
FALSE |
test.com/c/home/shoes/sneakers |
test.com/c/home/shoes/sneakers.jpeg |
Sneakers para atletismo, caminhada, corrida e muito mais |
TRUE |
2020-06-15 |
Nossos tênis |
||||
cat0041 |
cat004 |
Slacks |
FALSE |
test.com/c/pants/slacks |
test.com/c/pants/slacks.jpeg |
Slacks para trabalho e data e noite |
TRUE |
2020-06-15 |
1,0 |
1 |
Nossos slacks de negócios |
||
cat0061 |
cat006 |
Relógios |
FALSE |
test.com/c/accessories/watches |
test.com/c/accessories/watches.jpeg |
Nossos relógios clássicos |
TRUE |
2020-06-15 |
4.5 |
8 |
Nossos relógios |
||
cat00211 |
cat0021 |
Sneakers de execução |
FALSE |
test.com/c/shoes/sneakers/running-sneakers |
test.com/c/shoes/sneakers/running-sneakers.jpeg |
Sneakers para corridas de estrada, corridas de trilha, corridas de pista e muito mais |
TRUE |
2020-06-15 |
4,0 |
6 |
Nossos treinadores e corredores |
||
cat002111 |
cat00211 |
Picos de corrida |
FALSE |
test.com/c/shoes/sneakers/running-sneakers/racing-spikes |
test.com/c/shoes/sneakers/running-sneakers/racing-spikes.jpeg |
Sapatos especificamente para corridas em trilhas |
TRUE |
2020-06-15 |
2.33 |
23 |
Nossos picos de rastreamento e campo |
