Atributos e famílias
O que são atributos, para que servem as famílias e por que mexem no número de completude.
Este tutorial tem vídeo em outros idiomas: em espanhol · em inglês
O que é um atributo
Um dado estruturado do produto — cor, tamanho, material — que alimenta a descrição e os filtros da sua loja. Há sete tipos:
- Lista: um valor de um conjunto fechado (cor: vermelho).
- Lista múltipla: vários valores do mesmo conjunto.
- Sim/Não.
- Texto livre.
- Número.
- Data.
- Medida: número com uma unidade fixa (250 ml).
Famílias
Uma família agrupa os atributos que cabem a um tipo de produto. Uma camiseta e uma mochila podem compartilhar o atributo cor, e cada família decide se é obrigatório.
A família é o que permite ao Bruxel saber o que FALTA num produto: sem ela não há com o que comparar.
Uma categoria pode ter uma família padrão (no seu detalhe, «Família padrão»): os produtos sem família que entrarem nela —ou em qualquer uma de suas subcategorias, que a herdam enquanto não declararem a sua— recebem-na no mesmo ato. Uma família já definida nunca muda. Para os produtos que já estavam, a categoria oferece «Aplicar», que deixa de fora os que estão em categorias com famílias diferentes. Apagar uma família a remove de suas categorias; mover ou apagar uma categoria só muda o que for atribuído depois.
Grupos: a ficha em seções
Um grupo é uma seção da ficha de produto —Dados mestres, SAP, Merch, Ecomm— para dividir o trabalho por equipes. Cada atributo pertence a um grupo ou a nenhum; os sem grupo aparecem no final, em «Outros». A ficha e a grade ordenam primeiro por grupo e depois pela ordem do atributo.
Os grupos são criados e ordenados na página de atributos, ou com a coluna «group» do CSV de definições, que cria o grupo se não existir. O grupo de cada atributo é escolhido na ficha do atributo, e só um administrador pode movê-lo.
Listas de valores compartilhadas
Quando vários atributos usam os mesmos valores — a cor do estojo e a cor do produto, os tons de duas linhas de maquiagem —, uma lista os escreve uma única vez. Ela é criada na página de atributos e cada atributo de lista a escolhe na sua página, em «Lista compartilhada».
Ao vincular um atributo, as opções que ele já tinha com o mesmo texto são vinculadas (mesmo que só mudem maiúsculas e minúsculas), as que faltam são criadas e as próprias ficam como estavam. A partir daí, adicionar, renomear, traduzir ou remover um valor na lista muda em todos os atributos que a usam, e cada produto afetado ganha uma versão no seu histórico.
Como a completude é calculada
Cada produto soma até 100 pontos em quatro partes:
| Parte | Pontos | Como é preenchida |
|---|---|---|
| Marca e categoria | 25 | Metade para cada uma. |
| Atributos | 25 | Atributos obrigatórios da sua família que já têm valor. |
| Conteúdo | 35 | Idiomas com descrição publicada, sobre os que você configurou. |
| Imagem principal | 15 | Uma imagem pronta na ficha: a principal ou, se você não marcou nenhuma, a primeira da galeria. É a que a sua loja recebe como imagem base. |
Preencher com IA
Em vez de preencher atributo por atributo, você pode selecionar produtos e pedir que a IA os complete a partir do que já se sabe deles. Custa créditos e só cobra os que ela consegue preencher.
O código na sua loja
Cada atributo tem um code no Bruxel, derivado do nome. Se a sua loja (Adobe Commerce) o conhece por outro attribute_code, informe-o na ficha do atributo, em “Código na sua loja”: o CSV de download para Adobe Commerce e a API pública usam esse código como nome da coluna, e assim a importação da sua loja encontra o atributo sem que você renomeie colunas à mão.
Só admite letras, dígitos e sublinhado, e não pode se repetir entre dois atributos da sua organização (seriam duas colunas iguais). Deixe vazio para voltar ao code do Bruxel. As seleções de colunas em Downloads e os canais salvos não mudam: continuam usando o code.
Importar atributos de um CSV
Se seus atributos já estão definidos numa planilha, não precisa cadastrá-los um a um: em “Importar atributos (CSV)” você envia um arquivo com uma linha por atributo e o Bruxel mostra o que faria antes de tocar em qualquer coisa. O modelo para download traz uma linha de exemplo por tipo.
- Colunas: code (opcional; derivado do nome quando vazio), name, type (select, multiselect, boolean, text, number, date, metric), unit (só metric), filterable (sim/não), external_code (o código na sua loja), values (separados por |, só select e multiselect) e label_en, label_fr, label_pt para os rótulos por idioma. Os cabeçalhos aceitam maiúsculas, acentos e o nome em espanhol.
- Um atributo que já existe é reconhecido pelo code e atualizado: nome, filtrável, código na sua loja, rótulos e valores novos. Um que não existe é criado. Nada é apagado: nem atributos, nem valores que não vêm no arquivo, nem rótulos de outros idiomas.
- O que não pode ser aplicado é reportado por linha com o motivo (tipo inválido, unidade faltando, código externo repetido) e as demais linhas seguem. Uma mudança de tipo que deixaria valores inconsistentes é avisada e não aplicada.
Regras para os valores
Um atributo de seleção ou de texto pode ter regras que rodam, em ordem, sobre cada valor que entra: converter uma unidade (número + unidade → número × fator + outra unidade), substituir um texto por outro, proibir um padrão ou exigir um. O caso típico: um tamanho com onças e mililitros misturados — com “converter oz → ml, fator 29.5735” um “1.7 OZ” entra como “50 ml”, e com “proibir oz” o que não pôde ser convertido é rejeitado com a mensagem que você escrever.
O Bruxel não traz tabela de conversões: “oz” pode ser massa ou volume, então o fator é você quem confirma (há atalhos que preenchem o formulário). As regras se aplicam ao que entra pela tela de atributos, pela importação de atributos e pela API. Para o que já estava salvo, “Revisar os valores atuais” mostra no que cada valor viraria e “Aplicar” faz isso: se duas opções ficam iguais, são mescladas e seus produtos passam para a que fica.
Regras de captura: quando um dado é pedido e de onde vem
Além das regras dos valores, qualquer atributo —de qualquer tipo— pode ter regras de captura. Configuram-se na sua ficha, em «Regras», com seletores de atributo, estrutura e categoria, e quem as muda é um operador ou um administrador:
- Pedido quando…: se a condição se cumpre (por exemplo, «importado ou nacional» é Importado) e o campo está vazio, a ficha avisa junto ao campo e a importação o relata por linha. Só avisa: o produto é salvo e importado assim mesmo.
- Oculto quando…: serve para o formulário de cadastro do fornecedor, que não mostrará o campo enquanto a condição se cumprir. A ficha e a grade sempre o mostram.
- Derivado de…: o sistema põe o valor a partir de um valor fixo, de outro atributo (com um mapa: «quando vale loyalty, ponha ZMYP; se não, ZMOD»), de um código da categoria ou de um código da marca. Pode se aplicar sempre ou só quando uma condição se cumpre.
- Comparar com outro: num número ou numa medida, avisa quando não cumpre a comparação com outro atributo (o preço de venda abaixo do de compra, o peso líquido acima do bruto).
Ninguém escreve um atributo derivado enquanto a sua regra se aplica, nem o proprietário: a ficha e a grade o mostram com cadeado e a API responde que o sistema põe o valor. Ele é recalculado sozinho ao escrever a sua origem, ao importar, ao categorizar o produto e ao mudar a sua marca, na mesma versão do histórico que a mudança que o moveu. Uma regra nova, ou um código de categoria ou de marca que mudou, não reescreve o que já existia: em «Regras», «Aplicar ao que já existe» conta quantos produtos mudariam e os aplica em rodadas de mil.
Converter uma lista em medida
Se as opções de uma lista são medidas escritas como texto («50 ml», «1.7 OZ», «100 g»), «Converter em medida» as passa para atributos do tipo Medida. No detalhe da lista, «Revisar as opções» agrupa as opções pela unidade que trazem escrita e mostra quantos produtos usam cada grupo; depois você escolhe o destino de cada medida e confirma.
- Cada medida (volume, peso, comprimento) vai para um atributo de medida que você já tem ou para um novo, criado na hora. O número é salvo convertido para a unidade do destino, arredondado a 4 casas decimais.
- «oz» pode ser volume (um perfume) ou peso (um batom), e a lista não diz qual. Você decide: mandá-lo para uma das duas medidas ou deixá-lo como está; por padrão, ele fica. Se o seu catálogo tem uma coluna que distingue os produtos —a categoria, por exemplo—, você pode decidir por valor: as fragrâncias em volume, os batons em peso.
- As opções que não são uma medida —sem unidade reconhecível, ou em zero como «0.00 OZ»— não são movidas e aparecem listadas à parte.
Alterar o código de um atributo
O code é derivado do nome ao criar o atributo e desde então é a sua identidade: nomeia a coluna no CSV para Adobe Commerce (se não houver código na sua loja), é a fonte das colunas dos seus canais salvos e a rota da API pública. Por isso até agora não podia mudar. Na ficha do atributo, “Alterar código” mostra como ficará normalizado, se outro atributo já o usa e quais canais mudam de fonte, e só depois você confirma.