O Smart Finder é a solução de busca da Linx Commerce responsável por definir como os produtos são encontrados, apresentados e ordenados na loja virtual.

A solução utiliza o Elasticsearch como motor de busca, enquanto as configurações disponíveis para a operação são realizadas diretamente no painel administrativo da Linx Commerce.

Este guia complementa as documentações funcionais do Smart Finder e apresenta cenários práticos para ajudar lojistas e equipes de atendimento, implantação e suporte a identificar:

• qual configuração utilizar;
• o que verificar antes de realizar uma alteração;
• qual ajuste avaliar primeiro;
• qual resultado esperar;
• como validar a mudança;
• quais riscos devem ser considerados;
• como desfazer uma alteração.

As configurações do Smart Finder estão organizadas em quatro áreas:

• Configurações Básicas;
• Configurações Avançadas;
• Configurações por Grupo;
• Sinônimos.

Cada área possui uma finalidade diferente e pode atuar em conjunto com as demais.

ℹ️ Importante: os exemplos e valores apresentados neste guia são pontos de partida para testes. Eles não representam configurações padrão, pois os resultados podem variar conforme o catálogo, os campos indexados, a qualidade dos dados e a estratégia de cada loja.

🧭 Como escolher a configuração correta

Antes de alterar o Smart Finder, identifique exatamente qual comportamento precisa ser modificado.

💡 Comece pelas Configurações Básicas. Utilize as Configurações Avançadas quando o ajuste não estiver disponível na configuração básica ou quando houver conhecimento sobre os campos e parâmetros envolvidos.

↕️ Como as ordenações são configuradas

A configuração das ordenações pode envolver três áreas diferentes do Smart Finder. Cada uma possui uma responsabilidade específica.

1. Configurações Avançadas — Global

Essa área é utilizada para criar tecnicamente uma opção de ordenação.

Nela, podem ser definidos:

• identificador técnico;
• texto apresentado ao consumidor;
• campos utilizados na ordenação;
• direção crescente ou decrescente;
• critérios de desempate.

Essa etapa é necessária quando a opção de ordenação ainda não existe.

Exemplo

A operação deseja criar uma ordenação chamada Mais recentes, baseada na data de cadastro dos produtos.

A estrutura técnica dessa ordenação deve ser cadastrada em:

• Busca → Configurações Avançadas → Global

⚠️ Criar a ordenação na aba Global não significa que ela será automaticamente apresentada ao consumidor ou utilizada como padrão.

2. Configurações Básicas

As Configurações Básicas são utilizadas para definir quais opções de ordenação ficarão disponíveis em cada contexto.

Uma ordenação pode, por exemplo:

• aparecer na Pesquisa;
• aparecer em Categoria;
• não aparecer em Marca;
• não aparecer em determinada listagem.

Exemplo

A loja possui as ordenações:

• Relevância;
• Mais vendidos;
• Menor preço;
• Maior preço;
• Mais recentes.

Na página de Categoria, a operação deseja mostrar somente:

• Mais vendidos;
• Menor preço;
• Maior preço.

Essa seleção é realizada nas Configurações Básicas, no contexto correspondente.

⚠️ As Configurações Básicas definem quais ordenações podem ser escolhidas, mas não definem qual será utilizada inicialmente.

3. Configurações por Grupo

As Configurações por Grupo são utilizadas para definir a Ordenação default, ou seja, a opção aplicada inicialmente quando o consumidor acessa a busca ou a listagem.

Essa definição pode variar conforme:

• grupo de configuração;
• site;
• canal;
• operação.

Exemplo

A loja disponibiliza ao consumidor:

• Relevância;
• Mais vendidos;
• Menor preço.

Porém, deseja que a listagem seja aberta inicialmente em Mais vendidos.

Para isso, a opção Mais vendidos precisa:

1. existir na configuração Global;
2. estar habilitada nas Configurações Básicas para o contexto;
3. estar selecionada como Ordenação default nas Configurações por Grupo.

Fluxo completo de uma ordenação

A opção de ordenação existe?
           ↓
Configurações Avançadas — Global

A opção deve aparecer neste contexto?
           ↓
Configurações Básicas

Qual opção deve aparecer selecionada inicialmente?
           ↓
Configurações por Grupo

💡 Ao investigar uma ordenação incorreta, verifique as três etapas. O problema pode estar na criação técnica, na disponibilidade por contexto ou na definição da ordenação padrão.

🔍 Antes de alterar a busca

Nem todo problema observado nos resultados é causado pelas configurações do Smart Finder.

Antes de modificar campos, pesos ou parâmetros, verifique o cadastro, a disponibilidade e a indexação do produto.

Cadastro do produto

Confirme se:

• o produto está ativo;
• o nome está cadastrado corretamente;
• as palavras-chave estão preenchidas;
• o SKU está correto;
• a descrição contém as informações necessárias;
• a marca está vinculada;
• a categoria está vinculada;
• o produto possui imagem, quando necessária;
• as informações utilizadas pela ordenação estão preenchidas.

Disponibilidade e indexação

Confirme se:

• o produto foi indexado;
• o produto está disponível para venda;
• existe estoque, quando aplicável;
• alguma regra está impedindo sua exibição;
• a variação pesquisada está disponível;
• o produto pertence ao canal ou grupo consultado.

⚠️ Aumentar o peso de um campo não fará um produto aparecer se ele não estiver disponível ou não estiver participando da consulta.

Contexto da consulta

Identifique onde o problema ocorre:

• Pesquisa;
• Sugestão ou autocomplete;
• Categoria;
• Marca;
• Lista de Produtos;
• vitrine específica.

ℹ️ Uma configuração realizada em Pesquisa não é aplicada automaticamente em Sugestão, Categoria, Marca ou Lista de Produtos.

🗺️ Diagnóstico rápido

🎯 Cenários práticos

1. Produto com nome exato não aparece primeiro

Situação

O consumidor pesquisa o nome completo de um produto, mas outros itens menos relacionados aparecem antes dele.

Exemplo

Vestido Midi Serena

O produto com esse nome existe, mas outros vestidos que apenas possuem os termos “midi” ou “Serena” em campos complementares aparecem primeiro.

Possíveis causas

• o nome do produto possui pouca influência;
• a descrição possui peso elevado;
• palavras-chave genéricas estão prevalecendo;
• correspondências aproximadas possuem influência excessiva;
• a listagem utiliza uma ordenação diferente da relevância;
• o nome cadastrado não corresponde ao termo pesquisado.

Onde configurar

Avalie primeiro:

• Busca → Configurações Básicas

Revise:

• campos pesquisáveis;
• peso do nome;
• relevância e ranking;
• correspondência por frase completa.

Utilize Configurações Avançadas → Pesquisa somente quando a necessidade não puder ser atendida pelas Configurações Básicas.

Ajuste sugerido

Organize os campos considerando a seguinte relação:

Resultado esperado

Produtos cujo nome corresponde exatamente ou de forma muito próxima ao termo pesquisado tendem a aparecer antes de itens encontrados apenas na descrição.

Como validar

Teste:

• nome completo;
• parte do nome;
• nome acompanhado da marca;
• nome sem acento;
• termo genérico;
• pequena diferença de escrita.

Cuidados

Um peso muito elevado no nome pode reduzir a influência de palavras-chave importantes e prejudicar produtos que utilizam nomenclaturas alternativas.

2. Pesquisa com várias palavras retorna poucos resultados

Situação

Pesquisas mais detalhadas retornam poucos produtos ou nenhum resultado.

Exemplo

Vestido feminino midi preto com manga

Possível causa

A busca pode estar exigindo que uma quantidade muito alta dos termos digitados esteja presente no mesmo produto.

Onde configurar

• Busca → Configurações Básicas → Relevância e ranking

Revise a configuração de Correspondência mínima.

Estratégias possíveis

Ajuste sugerido

Utilize uma estratégia intermediária como ponto de partida.

De forma geral:

• lojas de moda com catálogo amplo podem se beneficiar de maior flexibilidade;
• catálogos segmentados ou técnicos podem exigir maior precisão;
• operações com muitos tipos de produtos podem começar por uma configuração moderada.

Resultado esperado

A pesquisa passa a retornar produtos relacionados à maior parte da intenção, mesmo que nenhum item contenha todos os termos.

Como validar

Compare:

• quantidade total de resultados;
• qualidade dos cinco primeiros produtos;
• presença de itens pouco relacionados;
• quantidade de pesquisas sem resultado.

Cuidados

Uma configuração excessivamente flexível pode aumentar a quantidade de resultados, mas reduzir sua qualidade.

3. Pesquisa retorna muitos produtos pouco relacionados

Situação

A busca apresenta muitos produtos, mas os primeiros resultados não correspondem à intenção do consumidor.

Exemplo

Ao pesquisar:

Calça jeans reta feminina

a loja apresenta shorts, jaquetas jeans ou produtos que mencionam “jeans” apenas na descrição antes das calças esperadas.

Possíveis causas

• correspondência muito flexível;
• descrição com influência elevada;
• palavras-chave genéricas;
• regras fonéticas amplas;
• sinônimos abrangentes;
• ordenação diferente de relevância;
• campos com informações pouco consistentes.

Onde configurar

Avalie nesta ordem:

1. Configurações Básicas;
2. ordenação utilizada;
3. Sinônimos;
4. Configurações Avançadas — Pesquisa.

Ajuste sugerido

• aumente a influência dos campos mais precisos;
• reduza a influência de descrições genéricas;
• revise palavras-chave amplas;
• torne a correspondência mais restritiva;
• revise os sinônimos;
• confirme se a ordenação por relevância está selecionada.

Resultado esperado

Os primeiros produtos passam a apresentar maior relação com a intenção da pesquisa.

Como validar

Avalie principalmente:

• os cinco primeiros produtos;
• os dez primeiros produtos;
• a posição do produto esperado;
• a quantidade de itens sem relação aparente.

💡 A quantidade total não deve ser analisada isoladamente. A qualidade das primeiras posições é um indicador mais importante para a experiência do consumidor.

4. Sugestões não apresentam as peças esperadas durante a digitação

Situação

Ao começar a digitar o nome de uma peça, o consumidor não recebe sugestões relevantes ou precisa escrever o termo completo para encontrar os produtos.

Exemplo

O consumidor deseja encontrar um vestido midi preto e começa a digitar:

ves
vest
vestido
vestido midi

Durante a digitação, o autocomplete pode:

• não apresentar nenhuma sugestão;
• mostrar produtos pouco relacionados;
• sugerir apenas depois que o termo estiver completo;
• apresentar peças que possuem o termo somente na descrição;
• não priorizar produtos cujo nome corresponde ao que foi digitado.

Possíveis causas

• a busca por termos incompletos não está habilitada;
• o nome do produto possui pouca relevância nas sugestões;
• descrição ou palavras-chave genéricas possuem influência excessiva;
• a quantidade de caracteres digitada ainda não é suficiente para gerar sugestões;
• produtos não estão sendo exibidos no autocomplete;
• pequenas diferenças de escrita não estão sendo consideradas;
• os produtos não possuem nomes e palavras-chave adequados.

Onde configurar

Avalie primeiro:

Busca → Configurações Básicas → Sugestão

Revise as opções relacionadas a:

• termos incompletos;
• tolerância a erros de digitação;
• produtos apresentados no autocomplete;
• campos considerados nas sugestões;
• relevância do nome do produto;
• termos ou pesquisas relacionadas.

Utilize Configurações Avançadas → Sugestão somente quando o comportamento não puder ser ajustado pelas Configurações Básicas.

Ajuste sugerido

Como ponto de partida:

1. permita que termos incompletos sejam considerados;
2. priorize o nome do produto nas sugestões;
3. mantenha descrição e palavras-chave como informações complementares;
4. habilite a tolerância a pequenos erros de escrita, quando necessário;
5. confirme se os produtos podem ser apresentados no autocomplete;
6. teste o comportamento durante toda a digitação.

💡 Em uma loja de moda, o nome do produto tende a ser especialmente importante porque costuma reunir informações como tipo da peça, gênero, modelagem, material ou cor.

Exemplo de cadastro

Considere um produto com o seguinte nome:

Vestido Midi Feminino Preto com Fenda

O autocomplete pode ser validado com pesquisas como:

vest
vestido
vestido midi
vestido preto
vestido com fenda

Caso essas características estejam apenas na descrição, a sugestão pode depender do peso atribuído a esse campo.

Resultado esperado

Durante a digitação, o consumidor passa a receber sugestões progressivamente mais relacionadas à sua intenção.

O comportamento exato depende dos campos indexados e da qualidade das informações cadastradas nos produtos.

Como validar

Teste progressivamente termos comuns da loja:

cam
camiseta
camiseta feminina

cal
calça
calça jeans
calça jeans reta

bla
blazer
blazer feminino

ves
vestido
vestido midi
vestido midi preto

Durante o teste, verifique:

• em qual momento as sugestões começam a aparecer;
• se o produto esperado aparece entre as primeiras opções;
• se os resultados ficam mais específicos conforme novas palavras são digitadas;
• se produtos pouco relacionados são apresentados;
• se o nome da peça possui prioridade;
• se erros simples continuam gerando sugestões.

Teste com erros de digitação

Utilize também erros comuns, como:

camizeta
vestdo
calsa jeans
blaser

O objetivo é verificar se pequenas diferenças de escrita ainda permitem localizar ou sugerir produtos relacionados.

Cuidados

Uma configuração muito abrangente pode fazer com que termos curtos, como ca ou ve, apresentem produtos pouco relacionados.

Uma tolerância muito alta a erros também pode aproximar palavras que possuem grafia semelhante, mas representam peças diferentes.

⚠️ O autocomplete deve ajudar o consumidor a avançar na pesquisa. Apresentar muitas opções não significa necessariamente oferecer sugestões melhores.

5. Consumidores pesquisam uma peça usando outro nome

Situação

A loja utiliza um termo no cadastro dos produtos, mas os consumidores pesquisam a mesma peça utilizando outra palavra, abreviação ou expressão comercial.

Esse cenário é comum em lojas de moda, nas quais termos em português, inglês e nomenclaturas comerciais podem ser utilizados para representar produtos semelhantes.

Exemplos

A loja pode possuir produtos cadastrados como:

Camiseta Feminina Básica

Mas os consumidores podem pesquisar por:

t-shirt feminina

Outro exemplo:

Bolsa Transversal Feminina

Também pode ser pesquisada como:

bolsa crossbody

Sem uma relação entre os termos, a busca pode apresentar poucos resultados ou depender de essas variações também estarem cadastradas nos produtos.

Onde configurar

• Busca → Sinônimos

Ajuste sugerido

Cadastre termos realmente equivalentes ou variações utilizadas pelos consumidores.

⚠️ Os termos devem ser avaliados conforme o catálogo e a linguagem utilizada pelos consumidores da loja. Uma expressão pode ser equivalente em uma operação e representar uma categoria diferente em outra.

Relação bidirecional

Utilize a relação bidirecional quando os termos puderem ser considerados equivalentes nos dois sentidos.

Exemplo

camiseta ↔ t-shirt

Com essa configuração:

• uma pesquisa por camiseta também pode considerar t-shirt;
• uma pesquisa por t-shirt também pode considerar camiseta.

Resultado esperado

Produtos cadastrados com qualquer um dos termos passam a participar das pesquisas relacionadas.

Outros exemplos que podem ser avaliados:

bolsa transversal ↔ crossbody

tênis ↔ sneaker

calça jeans ↔ jeans

Esses exemplos devem ser utilizados somente quando os termos representarem o mesmo conjunto de produtos para a loja.

Relação direcional

Utilize a relação direcional quando a expansão deve acontecer somente a partir de um dos termos.

Esse recurso pode ser útil quando o consumidor utiliza uma expressão mais ampla, mas a operação não deseja aplicar o comportamento inverso.

Exemplo

moda praia → biquíni, maiô, saída de praia

Nesse cenário, uma pesquisa por moda praia pode considerar produtos relacionados aos termos configurados.

Porém, uma pesquisa por biquíni não precisa necessariamente expandir para todos os produtos relacionados à expressão moda praia.

Outro exemplo possível:

roupa fitness → legging, top esportivo, shorts de academia

ℹ️ Nesse tipo de configuração, os termos não são necessariamente sinônimos exatos. A relação direcional é utilizada como uma estratégia controlada de expansão da pesquisa.

Cuidados com relações direcionais

Antes de criar uma expansão ampla, confirme se todos os produtos relacionados devem realmente participar da pesquisa.

Uma relação muito abrangente pode fazer com que o consumidor pesquise um termo específico e receba categorias diferentes daquilo que esperava.

O que não deve ser configurado como sinônimo

Não relacione peças que apenas fazem parte do mesmo look ou da mesma categoria comercial.

Exemplos que normalmente não devem ser considerados sinônimos:

vestido ↔ saia

blazer ↔ jaqueta

camiseta ↔ camisa

tênis ↔ sandália

Essas peças podem ser relacionadas comercialmente, mas não representam necessariamente o mesmo produto.

⚠️ Sinônimos incorretos podem ampliar a quantidade de resultados e, ao mesmo tempo, reduzir a precisão da busca.

Como configurar

1. acesse Busca → Sinônimos;
2. informe o termo principal;
3. informe os termos equivalentes;
4. defina se a relação será bidirecional ou direcional;
5. revise a expansão apresentada;
6. salve a configuração;
7. teste imediatamente os termos relacionados.

As alterações de Sinônimos são aplicadas após salvar, sem etapa adicional de Preview ou publicação.

Como validar

Para uma regra como:

camiseta ↔ t-shirt

Teste:

camiseta
camiseta feminina
t-shirt
t-shirt feminina

Compare:

• quantidade de resultados;
• produtos apresentados nas primeiras posições;
• presença de peças que não correspondem ao termo;
• comportamento da pesquisa nos dois sentidos.

Para uma regra direcional como:

moda praia → biquíni, maiô, saída de praia

Teste:

moda praia
biquíni
maiô
saída de praia

Confirme se:

• a expressão ampla apresenta os grupos esperados;
• os termos específicos não ampliam indevidamente a pesquisa;
• os primeiros produtos permanecem relacionados à intenção.

Resultado esperado

Os consumidores passam a localizar os produtos utilizando diferentes formas de nomear a mesma peça ou categoria, sem exigir alterações em todos os cadastros.

Cuidados

• não utilize termos genéricos demais;
• não relacione peças diferentes;
• revise termos em inglês que possam ter mais de um significado;
• prefira regras pequenas e objetivas;
• teste cada termo separadamente;
• registre a configuração anterior;
• valide o resultado logo após salvar.

💡 Os sinônimos complementam o cadastro dos produtos, mas não substituem nomes, descrições e palavras-chave bem preenchidos.

6. Como Sugestão e Sinônimos podem atuar juntos

Os dois recursos resolvem necessidades diferentes:

Exemplo combinado

A loja possui o produto:

Camiseta Feminina Oversized

O consumidor começa a digitar:

t-sh

A configuração de Sugestão pode reconhecer o termo incompleto e apresentar opções relacionadas.

A configuração de Sinônimos pode relacionar:

t-shirt ↔ camiseta

Com isso:

1. a Sugestão ajuda a interpretar o termo durante a digitação;
2. o Sinônimo relaciona t-shirt com camiseta;
3. produtos cadastrados como camiseta podem participar do resultado;
4. o consumidor encontra a peça mesmo utilizando outra nomenclatura.

ℹ️ O resultado depende da combinação entre os campos cadastrados, as configurações de Sugestão e as regras de Sinônimos.

7. Produtos sem imagem prejudicam a listagem

Situação

Produtos sem imagem aparecem entre os primeiros resultados e prejudicam a apresentação visual da loja.

Onde configurar

• Busca → Configurações Básicas → Produtos sem imagem

Estratégias possíveis

Ajuste sugerido

Quando os produtos ainda são comercialmente relevantes, considere:

• manter a exibição;
• enviar os produtos sem imagem para o final.

Resultado esperado

Produtos com imagem ganham prioridade visual sem retirar completamente os demais da loja.

Cuidados

Ocultar produtos sem imagem pode:

• reduzir a quantidade de resultados;
• ocultar produtos disponíveis;
• prejudicar catálogos em processo de enriquecimento;
• afetar pesquisas por SKU.

8. A ordenação inicial está incorreta

Situação

Ao abrir uma pesquisa ou listagem, a loja apresenta inicialmente uma ordenação diferente da esperada.

Exemplo

A operação espera:

Mais vendidos

Mas a loja abre em:

Relevância

Onde configurar

Para definir a ordenação aplicada inicialmente, acesse:

• Busca → Configurações por Grupo

Localize o campo Ordenação default no contexto correspondente.

⚠️ A ordenação inicial não é definida nas Configurações Básicas. As Configurações Básicas determinam quais opções ficam disponíveis. A opção pré-selecionada é definida nas Configurações por Grupo.

Antes de alterar

Confirme:

1. qual grupo é utilizado pela loja;
2. se a ordenação desejada existe;
3. se ela está habilitada nas Configurações Básicas;
4. se está disponível no contexto afetado;
5. se outro grupo está associado ao site ou canal.

Ajuste sugerido

1. selecione o grupo correto;
2. localize o contexto desejado;
3. encontre o campo Ordenação default;
4. selecione a opção;
5. revise os demais dados;
6. clique em Salvar.

Resultado esperado

Ao acessar novamente a busca ou a listagem, a ordenação definida para o grupo aparece selecionada inicialmente.

Como validar

• abra uma nova sessão;
• realize uma pesquisa;
• acesse o contexto afetado;
• confirme qual ordenação aparece selecionada;
• compare a sequência dos produtos;
• valide outros grupos ou canais.

Cuidados

As Configurações por Grupo são aplicadas imediatamente após salvar.

Por isso:

• registre o valor anterior;
• confirme o grupo;
• revise antes de salvar;
• valide logo após a alteração.

9. Uma opção de ordenação não aparece para o consumidor

Situação

A ordenação existe, mas não aparece na lista de opções da Pesquisa, Categoria ou Marca.

Possíveis causas

• a opção está oculta no contexto;
• foi habilitada em Pesquisa, mas não em Categoria;
• a configuração ainda não foi publicada;
• o template não apresenta a opção disponibilizada.

Onde configurar

Busca → Configurações Básicas → Filtros de Ordenação

Ajuste sugerido

1. selecione o contexto afetado;
2. localize a ordenação;
3. habilite sua exibição;
4. salve;
5. acesse o Preview;
6. valide;
7. publique.

Resultado esperado

A opção passa a ser apresentada ao consumidor no contexto configurado.

ℹ️ Habilitar uma ordenação não faz com que ela se torne automaticamente a opção inicial. Para isso, utilize Configurações por Grupo → Ordenação default.

10. A ordenação desejada não existe

Situação

A operação precisa disponibilizar uma nova forma de organizar os produtos, mas ela não aparece nas Configurações Básicas.

Onde configurar

• Busca → Configurações Avançadas → Global → Opções de Ordenação

Ajuste sugerido

Cadastre:

• Nome técnico;
• Label;
• campo principal;
• direção;
• critérios de desempate.

Depois:

1. salve;
2. acesse o Preview;
3. publique;
4. acesse as Configurações Básicas;
5. habilite a ordenação nos contextos desejados;
6. acesse as Configurações por Grupo caso ela deva ser a ordenação padrão.

Resultado esperado

A nova opção fica disponível para ser habilitada nos contextos e utilizada como Ordenação default.

Cuidados

Utilize somente campos existentes no índice.

Campos inexistentes ou sem informações podem gerar:

• ordenação incorreta;
• muitos empates;
• sequência inesperada;
• ausência de efeito.

11. Categoria ou Marca precisa de comportamento específico

Situação

A busca principal funciona corretamente, mas a ordem dos produtos em Categoria ou Marca não atende à estratégia da operação.

Exemplo

Na busca principal, os resultados por vestido estão adequados. Porém, na categoria Vestidos, produtos indisponíveis ou menos relevantes aparecem antes de itens disponíveis e com maior aderência à estratégia da loja.

Onde configurar

• Configurações Avançadas → Categoria
• Configurações Avançadas → Marca

Ajuste sugerido

Crie uma regra específica somente quando a configuração global ou básica não atender ao cenário.

A regra pode considerar:

• disponibilidade;
• relevância;
• campos do produto;
• indicadores comerciais;
• valores indexados.

Resultado esperado

Categoria ou Marca passa a utilizar uma configuração própria, sem modificar necessariamente a Pesquisa.

Como validar

• teste duas categorias;
• teste duas marcas;
• compare produtos disponíveis e indisponíveis;
• valide a ordenação por relevância;
• valide uma ordenação explícita;
• confirme que a Pesquisa não foi afetada.

12. Uma lista ou vitrine precisa priorizar determinados produtos

Situação

Uma vitrine precisa priorizar produtos disponíveis, com imagem, destacados ou pertencentes a um conjunto específico.

Exemplo

Uma vitrine de Novidades de Inverno deve priorizar peças:

• disponíveis;
• com imagem;
• pertencentes à coleção atual;
• vinculadas ao DataSource correto.

Onde configurar

• Busca → Configurações Avançadas → Lista de Produtos

Configuração geral

Utilize quando a regra deve ser compartilhada entre todas as Listas de Produtos.

Configuração individual

Utilize quando a regra deve ser aplicada somente a um ou mais DataSources identificados por:

• ID;
• Alias.

Ajuste sugerido

1. confirme qual lista está sendo utilizada;
2. identifique seu ID ou Alias;
3. defina se a regra será geral ou individual;
4. utilize campos indexados;
5. salve;
6. teste no Preview;
7. valide outras vitrines;
8. publique.

Resultado esperado

Os produtos que atendem às condições recebem maior influência na lista correspondente.

Cuidados

Uma configuração individual pode prevalecer sobre a configuração geral.

Verifique:

• configuração geral;
• configuração individual;
• ID;
• Alias;
• campos;
• pesos;
• ordenação.

13. A alteração não produziu efeito

Situação

Uma configuração foi modificada, mas o comportamento da loja parece não ter mudado.

Aba e contexto

Verifique:

• a aba correta foi alterada?
• o problema ocorre em Pesquisa, Sugestão, Categoria, Marca ou Lista de Produtos?
• a configuração foi realizada no contexto correto?

Salvamento e publicação

Verifique:

• a alteração foi salva?
• o Preview foi aberto depois do salvamento?
• a configuração foi publicada?
• existem alterações pendentes?

Ordenação

Verifique:

• a listagem está utilizando relevância?
• existe ordenação por preço, nome ou data?
• a ordenação selecionada impede que o Boost altere a posição?

Campo

Verifique:

• o campo existe no índice?
• o nome técnico está correto?
• os produtos possuem valor nesse campo?
• letras e caracteres foram preservados?

Produto

Verifique:

• está ativo?
• está disponível?
• foi indexado?
• pertence ao canal?
• possui o campo pesquisado?

ℹ️ Um Boost pode estar funcionando, mas não produzir mudança visível quando a listagem utiliza preço, nome, data ou outro campo explícito como ordenação principal.

⚖️ Como trabalhar com pesos

Os pesos definem a influência relativa de campos e regras no cálculo de relevância.

Um peso maior não representa:

• percentual;
• número fixo de posições;
• garantia de primeiro lugar;
• pontuação absoluta;
• melhoria automática da busca.

Relação sugerida como ponto de partida

Exemplo para uma loja de moda

Considere o produto:

Vestido Midi Feminino Preto com Fenda

Uma relação inicial pode considerar:

• o nome do produto como principal campo;
• palavras-chave como apoio para termos comerciais ou alternativos;
• marca e categoria como campos complementares;
• descrição com influência menor;
• correspondência fonética com peso controlado.

Boas práticas

• altere um peso por vez;
• registre o valor anterior;
• compare os mesmos termos;
• avalie os primeiros resultados;
• não aumente todos os pesos simultaneamente;
• não presuma que valores maiores são sempre melhores.

⚠️ Quando todos os pesos são aumentados na mesma proporção, a relação entre eles pode permanecer praticamente igual.

🧪 Roteiro de validação

Nas Configurações Básicas e Avançadas, as alterações seguem o fluxo:

Editar → Salvar → Preview → Publicar

Salvar registra uma cópia de trabalho. O Preview permite testar sem afetar os consumidores. Publicar disponibiliza o novo comportamento na loja.

Monte uma amostra fixa

Para uma loja de moda, selecione:

• cinco nomes exatos de produtos;
• cinco termos genéricos, como vestido, calça e camiseta;
• cinco pesquisas com várias palavras;
• três erros comuns de digitação;
• três SKUs;
• três termos sem resultado;
• duas categorias;
• duas marcas;
• duas listas ou vitrines;
• duas opções de ordenação;
• três termos em inglês utilizados pelos consumidores.

Exemplo de amostra

Vestido Midi Serena
vestido preto
calça jeans feminina reta
camizeta branca
t-shirt feminina
bolsa crossbody
SKU-12345

Registre antes e depois

💡 Não considere uma configuração melhor apenas porque retornou mais produtos. Avalie principalmente a qualidade das primeiras posições.

💾 Aplicação das alterações

Configurações Básicas e Avançadas

Utilizam o fluxo:

• Editar → Salvar → Preview → Publicar

A alteração somente afeta os consumidores depois da publicação.

Configurações por Grupo e Sinônimos

São aplicadas imediatamente após clicar em Salvar, sem etapa adicional de Preview e publicação.

Antes de salvar:

• confirme o grupo;
• registre os valores;
• revise o impacto;
• defina como desfazer;
• valide logo após a alteração.

↩️ Como desfazer uma alteração

Antes de modificar uma configuração:

1. registre os valores atuais;
2. tire uma captura da tela;
3. anote o contexto;
4. anote o grupo;
5. registre data e horário;
6. altere somente uma configuração;
7. valide o resultado.

Caso o comportamento piore:

• restaure o valor anterior;
• salve novamente;
• abra um novo Preview, quando disponível;
• publique a configuração restaurada;
• valide a loja.

Nas alterações de Sinônimos e Configurações por Grupo, restaure o valor anterior e salve novamente, pois essas áreas possuem aplicação imediata.

🧾 Monitoramento de logs

As ações relacionadas às configurações do Smart Finder ficam registradas no monitoramento de logs.

Os registros podem apresentar:

• usuário responsável;
• data e horário;
• salvamento;
• acesso ao Preview;
• publicação.

Para consultar:

• Integrações → Monitoramento de logs

Os logs ajudam a identificar:

• quem realizou a alteração;
• quando ela ocorreu;
• se houve publicação;
• se outra pessoa alterou a configuração posteriormente.

❓ Perguntas frequentes

Qual é a diferença entre disponibilizar e definir uma ordenação padrão?

• Disponibilizar significa permitir que o consumidor escolha aquela opção. Essa definição é realizada nas Configurações Básicas.
• Definir como padrão significa escolher qual opção será utilizada inicialmente. Essa definição é realizada nas Configurações por Grupo.

Onde uma nova ordenação é criada?

Em:

• Configurações Avançadas → Global

Depois, ela deve ser:

1. habilitada nas Configurações Básicas;
2. selecionada nas Configurações por Grupo, caso deva ser a opção inicial.

Quanto maior o peso, melhor será o resultado?

Não. Um peso maior aumenta a influência relativa da regra, mas pode prejudicar outras correspondências importantes.

Posso copiar a configuração de outra loja?

Não é recomendado.

As lojas podem possuir:

• catálogos diferentes;
• campos diferentes;
• cadastros diferentes;
• estratégias diferentes;
• distribuição diferente de valores.

Uma configuração adequada para uma loja pode produzir resultados diferentes em outra.

Posso preencher todos os campos vazios?

Não. Alguns campos são opcionais e devem permanecer vazios quando não forem necessários.

Por que o produto não aparece mesmo com um peso alto?

O produto pode:

• não estar ativo;
• não estar disponível;
• não estar indexado;
• não participar do canal;
• não possuir o campo;
• estar sendo excluído por outra regra.

O peso influencia produtos que já participam da consulta.

Por que alterei a relevância e a ordem não mudou?

A listagem pode estar utilizando uma ordenação explícita, como:

• preço;
• nome;
• data;
• mais vendidos;
• outra regra técnica.

Nesses casos, a relevância pode deixar de ser o critério principal.

Quando utilizar as Configurações Avançadas?

Quando:

• o ajuste não estiver disponível nas Configurações Básicas;
• existir uma necessidade técnica específica;
• houver conhecimento sobre os campos;
• houver orientação técnica.

É necessário acessar diretamente o Elasticsearch?

Não. As configurações disponibilizadas pelo Smart Finder são realizadas diretamente no painel administrativo da Linx Commerce.

Uma configuração de Pesquisa também vale para Categoria?

Não necessariamente. Pesquisa, Sugestão, Categoria, Marca e Lista de Produtos são contextos diferentes.

Qual é a diferença entre Sugestão e Sinônimos?

A Sugestão atua durante a digitação e ajuda a apresentar termos ou produtos relacionados ao texto informado.

Os Sinônimos relacionam palavras diferentes para ampliar os produtos considerados na pesquisa.

Por exemplo:

• Sugestão pode reconhecer que t-sh é um termo ainda incompleto;
• Sinônimos podem relacionar t-shirt com camiseta.

Posso cadastrar categorias inteiras como sinônimos?

É possível utilizar uma relação direcional para expandir uma expressão mais ampla, mas a regra deve ser cuidadosamente validada.

Por exemplo:

moda praia → biquíni, maiô, saída de praia

Essa relação não significa que todos os termos são sinônimos exatos. Ela funciona como uma expansão controlada da busca.

Posso relacionar camiseta e camisa como sinônimos?

Não é recomendado quando representam tipos de produtos diferentes no catálogo. Mesmo pertencendo ao mesmo segmento, os termos não são necessariamente equivalentes.

Alterações em Sinônimos precisam ser publicadas?

Não. Elas são aplicadas após salvar.

Alterações em Configurações por Grupo precisam ser publicadas?

Não. Elas são aplicadas após salvar para o grupo selecionado.