🗂️ 1. Aba Categoria

A aba Categoria reúne as configurações avançadas aplicadas às páginas de categoria da loja.

Essas configurações são utilizadas quando o consumidor navega por uma categoria, como:

• Calçados;
• Camisetas;
• Eletrônicos;
• Beleza;
• Ofertas;
• Lançamentos.

Diferentemente da aba Pesquisa, a navegação por categoria não depende, necessariamente, de um termo digitado pelo consumidor. A categoria selecionada já determina quais produtos podem participar da listagem.

As regras dessa aba ajudam a controlar a relevância e a prioridade dos produtos dentro da categoria, podendo influenciar quais itens aparecem primeiro quando a listagem utiliza uma ordenação baseada em relevância.

Na tela, as configurações estão organizadas em dois blocos:

• Query Boosts (Category);
• Extra Params (Category).

ℹ️ Importante: a aba Categoria apresentada não possui o bloco Query Fields. Nela, os ajustes são realizados diretamente pelas regras de Query Boosts e pelos parâmetros adicionais.

⚠️ Atenção: a ordenação selecionada pelo consumidor ou definida como padrão pode prevalecer sobre a relevância. Por exemplo, ao ordenar por “Menor preço”, os Boosts podem ter efeito reduzido ou não perceptível na posição dos produtos.

🎯 2. Query Boosts (Category)

Os Query Boosts permitem criar regras que aumentam ou reduzem a influência de determinadas informações dos produtos durante a navegação por categoria.

Essas regras podem ser utilizadas, por exemplo, para priorizar produtos de acordo com:

• correspondência com informações relevantes do catálogo;
• marca;
• características do produto;
• palavras-chave;
• popularidade;
• disponibilidade;
• outros campos existentes no índice.

A utilização depende dos campos disponibilizados na estrutura de busca da loja.

ℹ️ A configuração exata varia conforme o índice do Smart Finder. Não existe uma regra única que seja adequada para todas as lojas e categorias.

Cada Query Boost pode conter os seguintes campos:

🪪 Name

O campo Name identifica a regra dentro da configuração.

Exemplo ilustrativo:

CategoryFeaturedProducts

O Name:

• não é exibido ao consumidor;
• não corresponde ao nome da categoria;
• não altera diretamente o cadastro do produto;
• serve como identificação técnica da regra.

Ao cadastrar uma nova regra, utilize um nome que permita compreender sua finalidade.

Exemplos conceituais:

• regra para produtos em destaque;
• regra para produtos mais vendidos;
• regra para determinada característica;
• regra para disponibilidade;
• regra para uma informação específica do produto.

⚠️ Não renomeie regras existentes sem conhecer sua utilização. Mesmo que o Name pareça apenas descritivo, ele pode seguir um padrão utilizado internamente pela plataforma.

📦 Field

O campo Field define em qual informação indexada do produto a regra será aplicada.

O Field deve corresponder exatamente ao nome técnico de um campo existente no índice do Smart Finder.

Ele pode representar informações como:

• nome do produto;
• marca;
• palavras-chave;
• SKU;
• disponibilidade;
• atributo;
• indicador de popularidade;
• campo customizado;
• outra informação indexada.

ℹ️ O nome do campo não é necessariamente igual ao nome apresentado no cadastro de produtos. Um campo exibido como “Marca” no painel, por exemplo, pode possuir outro identificador técnico no índice.

⚠️ Não crie ou traduza livremente o nome do Field. Um campo inexistente pode fazer a regra ser ignorada, não produzir efeito ou gerar uma inconsistência na consulta.

Antes de preencher, confirme o nome técnico do campo com o time responsável pela implementação ou utilize um campo já existente em outra configuração validada.

⚖️ Boost

O Boost representa o peso da regra.

Quanto maior o valor em comparação com os demais Boosts, maior tende a ser a influência daquela regra na relevância dos produtos.

Exemplo conceitual:

Nesse exemplo, os produtos que atenderem à regra “Produtos em destaque” poderão receber uma influência maior no cálculo de relevância.

O valor do Boost não significa:

• percentual de relevância;
• quantidade de posições que o produto subirá;
• garantia de primeira posição;
• quantidade de produtos afetados.

O Boost é um peso relativo, combinado com as demais regras aplicadas à listagem.

Um produto também pode atender a mais de uma regra ao mesmo tempo. Nesse caso, as pontuações podem ser combinadas pelo motor de busca.

💡 Como configurar: aumente o Boost quando uma característica importante não estiver influenciando suficientemente a listagem. Reduza quando produtos pouco relevantes estiverem recebendo prioridade excessiva.

⚠️ Altere apenas uma regra por vez. Mudanças simultâneas em diferentes Boosts dificultam a identificação do ajuste responsável pelo novo comportamento.

🔤 Similarity

O campo Similarity determina o nível de similaridade aceito quando a regra realiza uma correspondência textual aproximada.

Esse tipo de configuração pode considerar diferenças como:

• uma letra incorreta;
• uma letra ausente;
• uma letra adicional;
• pequenas variações na escrita;
• termos semelhantes.

Exemplo:

Na aba Categoria, esse campo somente terá efeito quando a regra utilizar uma comparação textual compatível com Similarity.

Se a regra estiver baseada em:

• valor exato;
• indicador numérico;
• booleano;
• filtro de categoria;
• outro campo não textual;

o Similarity pode não ser necessário.

ℹ️ A Similarity não precisa ser preenchida em todas as regras. Sua utilização depende do Field, do Type e da forma como a consulta é montada.

⚠️ Não informe um valor somente porque ele aparece em outras abas. Uma configuração válida para Pesquisa ou Sugestão pode não fazer sentido na navegação por Categoria.

✍️ Term

A opção Term indica se a regra deve utilizar um termo durante a montagem da consulta.

Na aba Pesquisa, esse termo normalmente corresponde ao conteúdo digitado pelo consumidor. Na aba Categoria, porém, o consumidor pode simplesmente navegar pela categoria sem informar nenhum texto.

Por isso, a utilização de Term depende de como a regra foi implementada.

Quando marcado, o Smart Finder poderá utilizar um termo disponível no contexto da consulta.

Quando desmarcado, a regra pode funcionar com:

• um valor fixo;
• um formato próprio;
• um campo;
• uma função;
• outro parâmetro técnico.

⚠️ Não marque Term automaticamente. Como a navegação por categoria pode ocorrer sem texto pesquisado, essa opção deve ser utilizada somente quando a regra tiver sido preparada para receber um termo.

💡 Orientação: quando a regra não depende de texto livre, mantenha Term desmarcado, salvo quando houver uma definição técnica diferente.

🛡️ Escape

O campo Escape define os caracteres especiais que deverão ser tratados antes de um conteúdo textual ser enviado ao Elasticsearch.

Exemplo utilizado em outras configurações:

\+-&|!(){}[]^"~*?:/

Esses caracteres podem ter funções especiais na linguagem de consulta, como:

• obrigar ou excluir termos;
• agrupar condições;
• indicar intervalos;
• criar buscas por frase;
• aplicar relevância;
• utilizar caracteres coringa;
• informar campo e valor;
• criar expressões regulares.

Na aba Categoria, o Escape será relevante principalmente quando a regra utilizar algum termo ou valor textual.

Exemplos de conteúdos que podem exigir tratamento:

• C++;
• AC/DC;
• UV-50;
• TV 55";
• kit (2+1).

ℹ️ Quando a regra não utilizar texto, o campo pode permanecer vazio, conforme o comportamento esperado da implementação.

⚠️ Não copie valores de Escape de outra aba sem validar a regra. Quando o campo já estiver preenchido, preserve o valor existente, salvo quando houver orientação técnica.

Para compreender detalhadamente cada caractere, consulte o Guia de apoio das Configurações Avançadas do Smart Finder.

🧱 Format

O campo Format define como o conteúdo utilizado pela regra será inserido na expressão de consulta.

Um formato pode utilizar o marcador:

{0}

O {0} representa o valor que será inserido durante o processamento.

Exemplo:

({0})

Se o valor recebido for:

destaque

a expressão poderá ser montada como:

(destaque)

Na aba Categoria, o Format poderá ser utilizado quando a regra depender de:

• um termo;
• um valor específico;
• uma expressão;
• um agrupamento;
• outro conteúdo processado pela consulta.

⚠️ Não preencha o Format sem conhecer o formato esperado pela regra. Uma expressão incorreta pode fazer o Query Boost ser ignorado ou alterar o comportamento da listagem.

⚠️ Quando houver {0}, não remova o marcador. Ele indica o local em que o conteúdo será inserido.

🔗 Operator

O Operator define a relação lógica entre os termos ou condições utilizados na regra.

Os operadores mais comuns são:

Exemplo conceitual:

Uma regra que utilize as condições:

produto em estoque e produto em destaque

Com AND, o produto precisaria atender às duas condições.

Com OR, poderia atender a apenas uma delas.

ℹ️ O comportamento real depende do Field, do Format e do Type utilizados.

⚠️ Quando o campo estiver vazio, mantenha-o vazio, salvo quando houver uma necessidade técnica clara de definir AND ou OR.

🧬 Type

O campo Type define o tipo técnico da consulta utilizada pela regra.

Ele pode estar relacionado a comportamentos como:

• correspondência por termo;
• correspondência por frase;
• correspondência exata;
• consulta aproximada;
• consulta parcial;
• outro tipo aceito pela implementação.

O Type deve ser compatível com:

• o Field;
• o conteúdo da regra;
• o Format;
• o Operator;
• o comportamento esperado.

⚠️ Não informe um Type criado livremente. Um valor inválido pode fazer a regra ser ignorada, não produzir efeito ou gerar resultados inesperados.

Quando o campo estiver vazio, mantenha-o vazio, salvo quando houver orientação técnica específica.

➕ Adicionar ou remover Query Boosts

Para criar uma nova regra:

1. Clique em Adicionar Query Boost.
2. Informe o Name.
3. Informe um Field válido.
4. Defina o Boost.
5. Preencha os demais campos somente quando necessários.
6. Clique em Salvar.
7. Valide a categoria no preview.
8. Publique somente após confirmar o comportamento.

As regras podem ser excluídas individualmente por meio da opção Remover.

Antes de remover uma regra:

1. registre todos os valores atuais;
2. identifique sua finalidade;
3. verifique quais categorias podem ser afetadas;
4. teste a remoção no preview;
5. compare a ordem dos produtos.

⚠️ A remoção de um Query Boost pode alterar a posição dos produtos em todas as categorias que utilizam aquela configuração.

🧪 Exemplo conceitual de Query Boost

Considere que a operação deseja priorizar produtos que possuam uma determinada característica nas páginas de categoria.

A regra poderia utilizar, de forma ilustrativa:

De forma simplificada:

1. o consumidor acessa uma categoria;
2. o Smart Finder identifica os produtos pertencentes a ela;
3. o Query Boost verifica quais produtos atendem à regra;
4. os produtos correspondentes recebem uma influência adicional na relevância;
5. a pontuação é combinada com as demais regras;
6. a listagem é apresentada conforme a ordenação aplicada.

ℹ️ Este é um exemplo conceitual. Os nomes de Fields e os valores dependem da estrutura real do índice da loja.

⚙️ 3. Extra Params (Category)

Os Extra Params permitem configurar parâmetros técnicos adicionais aplicados exclusivamente à navegação por categoria.

Cada parâmetro é composto por:

• Nome;
• Valor.

Utilize a opção Adicionar para incluir um parâmetro ou o ícone de exclusão para remover uma configuração existente.

Os parâmetros podem complementar comportamentos relacionados a:

• montagem da consulta;
• relevância;
• pontuação;
• filtragem;
• agrupamento;
• tratamento de valores;
• outras regras técnicas.

⚠️ Utilize apenas parâmetros previstos para o contexto Categoria. Um parâmetro utilizado nas abas Pesquisa ou Sugestão pode não produzir o mesmo efeito na navegação por categoria.

🏷️ Nome

O campo Nome identifica o parâmetro que será utilizado.

O valor precisa corresponder a um parâmetro reconhecido pela implementação do Smart Finder.

Exemplos de nomenclaturas técnicas podem variar de acordo com o comportamento configurado.

⚠️ Não crie nomes livremente. Um parâmetro desconhecido pode ser ignorado ou provocar um comportamento inesperado.

📝 Valor

O campo Valor define a configuração associada ao parâmetro.

Dependendo do parâmetro, o valor pode ser:

• número;
• percentual;
• texto;
• nome de campo;
• expressão;
• lista de campos;
• configuração booleana;
• outro formato previsto.

⚠️ O formato do Valor depende do Nome informado. Um parâmetro numérico não deve receber texto, e um parâmetro que espera uma lista de campos deve seguir exatamente a sintaxe prevista.

➕ Como adicionar um Extra Param

1. Clique em Adicionar.
2. Informe o Nome técnico do parâmetro.
3. Informe o Valor no formato esperado.
4. Clique em Salvar.
5. Acesse o preview.
6. Navegue pelas categorias afetadas.
7. Compare quantidade e posição dos produtos.
8. Publique somente após validar o resultado.

Para excluir um parâmetro, utilize o ícone de remoção localizado ao lado da configuração.

⚠️ Antes de excluir, registre o Nome e o Valor. A ausência do parâmetro pode modificar a consulta de todas as categorias.

🧠 4. Diferença entre Categoria e Pesquisa

Na aba Pesquisa, o principal ponto de partida é o termo informado pelo consumidor.

Na aba Categoria, o principal ponto de partida é a própria categoria acessada. Por isso:

• Term pode não ser necessário;
• Similarity pode não ser aplicável;
• Escape pode permanecer vazio;
• Format pode ser utilizado somente em regras específicas;
• Query Boosts podem priorizar produtos dentro da categoria;
• a ordenação escolhida pode prevalecer sobre a relevância.

↕️ 5. Relação com as ordenações

Os Query Boosts influenciam principalmente listagens ordenadas por relevância.

Quando o consumidor seleciona uma ordenação explícita, como:

• Menor preço;
• Maior preço;
• Nome do produto;
• Mais recentes;
• outra ordenação configurada;

o campo utilizado na ordenação pode determinar diretamente a sequência dos produtos.

Nesse cenário, o efeito dos Boosts pode:

• deixar de ser visível;
• atuar somente como critério secundário;
• depender da implementação da ordenação;
• não alterar a posição final.

💡 Boa prática: valide primeiro a ordenação padrão da categoria e depois teste as demais opções disponíveis.

⚠️ Não conclua que o Boost não funciona apenas porque não houve mudança em uma ordenação por preço ou nome. Repita o teste utilizando a ordenação baseada em relevância.

🧪 6. Como testar a aba Categoria

Depois de realizar uma alteração:

1. Clique em Salvar.
2. Selecione Preview.
3. Acesse uma categoria com quantidade relevante de produtos.
4. Observe os primeiros produtos apresentados.
5. Registre a ordem atual.
6. Teste a ordenação padrão.
7. Teste a ordenação por relevância, quando disponível.
8. Teste outras ordenações separadamente.
9. Acesse subcategorias, quando aplicável.
10. Compare categorias com produtos e características diferentes.
11. Publique somente depois de validar o comportamento.

Cenários recomendados

💡 Boa prática: teste a mesma categoria antes e depois da alteração e registre os primeiros produtos para facilitar a comparação.

🚀 8. Como aplicar as alterações

Depois de concluir os ajustes na aba Categoria:

1. Clique em Salvar.
2. Selecione Preview.
3. Navegue pelas categorias da loja.
4. Verifique a quantidade e a ordem dos produtos.
5. Teste a ordenação por relevância.
6. Teste as demais ordenações disponíveis.
7. Retorne à configuração.
8. Clique em Publicar quando o comportamento estiver validado.

As alterações somente serão disponibilizadas aos consumidores após a publicação.

⚠️ Faça pequenas alterações e teste uma regra por vez. Mudanças simultâneas em Boost, Term, Format e Extra Params podem dificultar a identificação do campo responsável pelo resultado.

Esta documentação mantém o mesmo padrão utilizado nas abas Pesquisa e Sugestão, adaptando as orientações ao comportamento específico da navegação por categoria. A estrutura de campos segue o padrão técnico das Configurações Avançadas já documentado.