Histórico da Página

Nesse cenário, um produto encontrado no nome exato tende a receber maior prioridade que outro encontrado apenas na descrição.

O valor 80 não representa:

• 80% de correspondência;
• 80 pontos fixos;
• 80 posições acima;
• garantia de primeira posição.

O Boost é um peso relativo, combinado com as demais regras e critérios da consulta.

💡 Como configurar: aumente o Boost quando uma correspondência importante estiver aparecendo abaixo de resultados menos relevantes. Reduza quando uma regra estiver levando produtos pouco relacionados para as primeiras posições.

⚠️ Altere somente uma regra por vez. Aumentar todos os Boosts simultaneamente pode manter praticamente a mesma relação de prioridade entre eles.

🔤 Similarity

O campo Similarity está relacionado à tolerância utilizada para localizar termos parecidos.

Exemplo:

0.60

Essa configuração pode ajudar a considerar diferenças como:

• uma letra digitada incorretamente;
• uma letra ausente;
• uma letra adicional;
• duas letras invertidas;
• pequenas variações de escrita.

Exemplos:

O valor 0.60 não significa literalmente:

• 60% das letras precisam ser iguais;
• 60% das palavras precisam corresponder;
• o produto receberá 60% de relevância.

Esse valor é interpretado de acordo com a forma como o Smart Finder monta a consulta enviada ao Elasticsearch.

ℹ️ A interpretação exata do decimal depende da implementação da plataforma. Mantenha o valor existente quando erros de digitação estiverem sendo tratados corretamente.

⚠️ Uma tolerância excessiva pode trazer produtos pouco relacionados. Uma tolerância muito rígida pode aumentar as buscas sem resultados.

✍️ Term

A opção Term indica se o texto pesquisado pelo consumidor será utilizado na regra.

Considere a pesquisa:

camiseta azul

Quando Term estiver marcado, esse conteúdo será incluído na consulta correspondente.

Quando estiver desmarcado, a regra poderá depender de outro valor ou formato definido na configuração.

⚠️ Não desmarque a opção sem conhecer o impacto. A regra pode deixar de utilizar diretamente o texto pesquisado.

🛡️ Escape

O campo Escape define quais caracteres especiais deverão ser tratados antes que o texto seja enviado ao Elasticsearch.

Exemplo:

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

Essa sequência não representa uma senha, uma fórmula nem um termo de busca.

Ela é uma lista de caracteres que possuem funções especiais na linguagem de consulta.

Sem o tratamento adequado, esses símbolos podem ser interpretados como comandos em vez de parte do texto digitado.

Esse tratamento é importante para pesquisas como:

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

⚠️ Mantenha o valor padrão do Escape. Alterá-lo pode provocar erros ou comportamentos inesperados em pesquisas que contenham símbolos.

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

🧱 Format

O campo Format define como o termo pesquisado será inserido na expressão de consulta.

Pode ser utilizado um marcador como:

{0}

O {0} representa o texto informado pelo consumidor.

Exemplo de formato:

({0})

Para a pesquisa:

tênis azul

a expressão pode ser montada como:

(tênis azul)

Os parênteses mantêm o conteúdo agrupado durante o processamento.

⚠️ Não remova o marcador {0}. Ele indica o ponto em que o termo pesquisado será inserido.

🔗 Operator

O Operator define a relação lógica entre as palavras da pesquisa.

Considere:

camiseta azul masculina

Com AND, a consulta tende a exigir a presença de todos os termos.

Com OR, podem ser apresentados produtos que correspondam apenas a parte das palavras.

💡 Orientação: utilize uma configuração mais restritiva quando a precisão for mais importante. Utilize uma configuração mais flexível quando for necessário reduzir buscas sem resultados.

🧬 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;
• busca aproximada;
• busca parcial;
• outro tipo aceito pela implementação.

⚠️ Quando o campo estiver vazio, mantenha-o vazio, salvo quando houver uma orientação técnica específica. Um Type inválido pode fazer a regra ser ignorada ou gerar resultados inesperados.

➕ Adicionar ou remover Query Boosts

Utilize Adicionar Query Boost para incluir uma nova regra.

As regras existentes também podem ser removidas individualmente por meio da opção Remover.

💡

Antes de remover uma regra:

1. registre seu Name;
2. registre o Field;
3. registre o Boost;
4. registre os demais valores;
5. valide qual comportamento ela atende;
6. teste a remoção no preview.

O Smart Finder pode possuir regras diferentes

regras de boost para correspondências exatas, correspondências por termo, palavras-chave, nome do produto e outras informações do catálogo.

⚠️ A alteração dos pesos e das regras pode modificar significativamente a ordem dos resultados. Sempre valide o comportamento no preview antes de publicar.

3 - Extra Params (Search)

Permite configurar parâmetros adicionais aplicados somente para:

• correspondência exata do nome;
• nome do produto por termo;
• palavras-chave;
• similaridade fonética;
• variações das palavras;
• SKU;
• regra padrão.

⚠️ Não remova uma regra sem conhecer sua finalidade. Ela pode ser responsável por localizar produtos em cenários específicos.

🧪 Exemplo de uma regra de Query Boost

Considere a seguinte configuração:

Para uma pesquisa por:

Tênis Nike Air

a regra funcionará, de forma simplificada, assim:

1. utilizará o termo pesquisado porque Term está marcado;
2. tratará os caracteres especiais indicados no Escape;
3. inserirá o conteúdo no formato definido;
4. pesquisará no campo ProductNameExact;
5. aplicará o Boost 80;
6. considerará o valor de Similarity;
7. combinará a pontuação com as demais regras;
8. utilizará o comportamento padrão de Operator e Type.

ℹ️ A regra não atua isoladamente. A posição final do produto considera todas as correspondências, pesos, parâmetros e ordenações aplicados à consulta.

⚙️ 1.3 — Extra Params (Search)

Os Extra Params são parâmetros adicionais aplicados exclusivamente à busca principal.

Cada parâmetro é composto por:

• Nome;
• Valor.

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

Os parâmetros configurados nessa área complementam o comportamento da pesquisa e podem influenciar aspectos como quantidade, abrangência ou tratamento dos resultadosEsses parâmetros podem influenciar:

• a quantidade mínima de termos que precisam corresponder;
• os campos utilizados na consulta;
• a proximidade entre as palavras;
• a abrangência dos resultados;
• a pontuação de frases;
• outros comportamentos técnicos.

Na configuração podem aparecer parâmetros como:

• mm;
• qf;
• qs;
• ps.

⚠️ Não altere os ou remova parâmetros existentes sem conhecer sua finalidade. Valores incorretos podem impactar o funcionamento da busca.

Dica

. Um valor incorreto pode aumentar buscas sem resultados ou tornar a consulta excessivamente abrangente.

📏 mm — Minimum Should Match

Define a quantidade mínima de termos que precisa corresponder para que um produto seja considerado.

Exemplo:

mm = 75%

Considere uma pesquisa com quatro termos:

camiseta masculina azul algodão

Uma configuração de 75% representa, de maneira simplificada, a necessidade de correspondência de pelo menos três dos quatro termos.

Efeito da configuração

💡 Antes de alterar, teste pesquisas longas e verifique se a loja está retornando poucos resultados ou resultados excessivamente amplos.

🗂️ qf — Query Fields

Define os campos que participarão da consulta e o peso relativo de cada um.

Exemplo:

ProductNameExact^80 ProductNameExactTerm^25 SearchKeywordsExact^30

Separando:

• ProductNameExact^80: nome exato com peso 80;
• ProductNameExactTerm^25: termos do nome com peso 25;
• SearchKeywordsExact^30: palavras-chave exatas com peso 30.

O caractere ^ separa o nome do campo de seu peso.

⚠️ Mantenha os nomes técnicos existentes. Um campo inexistente ou escrito incorretamente pode não participar da consulta.

↔️ qs — Query Phrase Slop

Controla a tolerância de distância entre palavras quando o consumidor pesquisa uma frase.

Exemplo:

qs = 5

Quanto menor o valor, mais próximas as palavras precisam estar.

Quanto maior o valor, maior poderá ser a distância aceita entre elas.

Considere:

"tênis corrida"

Dependendo da configuração, também poderá haver correspondência com:

tênis masculino de corrida

📐 ps — Phrase Slop

Também controla a proximidade entre os termos, mas normalmente é utilizado em consultas de frase voltadas ao aumento de relevância.

Para a pesquisa:

tênis corrida

um produto chamado:

tênis de corrida

pode receber uma pontuação maior porque os termos aparecem próximos.

Já um produto que possui “tênis” no nome e “corrida” muito distante na descrição pode receber menor influência dessa regra.

ℹ️ O ps normalmente influencia a pontuação, e não necessariamente a inclusão ou exclusão do produto.

🧠 Diferença entre Pesquisa e Sugestão

A aba Pesquisa deve equilibrar:

• precisão;
• abrangência;
• qualidade dos resultados;
• tratamento de erros de digitação;
• priorização do nome e das palavras-chave;
• redução de buscas sem resultados.

Uma configuração muito rígida pode retornar poucos produtos.

Uma configuração muito flexível pode apresentar itens pouco relacionados ao termo pesquisado.

🧪 Como testar a aba Pesquisa

Depois de realizar uma alteração:

1. Clique em Salvar.
2. Selecione Visualizar Preview.
3. Execute diferentes pesquisas na loja.
4. Verifique a quantidade de produtos retornados.
5. Analise a ordem dos primeiros resultados.
6. Compare produtos com correspondência exata e parcial.
7. Teste erros de digitação.
8. Teste buscas com várias palavras.
9. Teste SKU, palavras-chave e caracteres especiais.
10. Publique somente depois da validação.

Sugestões de pesquisas para teste

💡 Boa prática: execute as mesmas pesquisas antes e depois da alteração para comparar quantidade, qualidade e ordenação dos produtos.

Dica

✅ Checklist antes de publicar O contexto Pesquisa está selecionado. Os campos informados existem no índice. Os nomes técnicos não foram traduzidos. Os Boosts possuem prioridades coerentes. A Similarity não está retornando termos excessivamente diferentes. As opções Term foram revisadas. O Escape foi preservado. O Format mantém o marcador {0}. Os operadores foram validados. Os Extra Params foram revisados. Nomes exatos de produtos foram testados. Pesquisas com várias palavras foram testadas. Erros de digitação foram testados. SKUs e palavras-chave foram testados. A quantidade e a ordem dos resultados estão adequadas. O preview apresentou o comportamento esperado.

Informações

🚀 Como aplicar as alterações Depois de concluir os ajustes na aba Pesquisa: Clique em Salvar. Selecione Visualizar Preview. Realize diferentes pesquisas na loja. Verifique a quantidade e a ordem dos produtos apresentados. Retorne à configuração. 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, Similarity e Extra Params podem dificultar a identificação do parâmetro responsável pelo novo comportamento. A versão também fica coerente com a orientação geral de que Query Fields, Query Boosts e Extra Params são estruturas técnicas específicas de cada contexto das Configurações Avançadas.