{"section":"tutorials","requestedLocale":"pt","requestedSlug":"intelligent-search-como-funciona-a-relevancia-dos-resultados-de-busca","locale":"pt","slug":"intelligent-search-como-funciona-a-relevancia-dos-resultados-de-busca","path":"docs/pt/tutorials/intelligent-search/relevância/intelligent-search-como-funciona-a-relevancia-dos-resultados-de-busca.md","branch":"main","content":"A relevância é o mecanismo central do [Intelligent Search](https://help.vtex.com/pt/docs/tutorials/intelligent-search-visao-geral) responsável por definir quais produtos aparecem nos resultados de uma busca e em qual ordem. O objetivo é garantir que os produtos mais pertinentes para cada consulta sejam exibidos primeiro, considerando uma série de fatores automáticos e configuráveis.\n\nO processo acontece em duas etapas principais:\n\n1. Encontrar os produtos que correspondem à busca.\n2. Ordenar os produtos por relevância.\n\n## Etapa 1: como o Intelligent Search encontra os resultados\n\nO Intelligent Search tenta localizar produtos que correspondam à busca em grupos sequenciais. Assim que um grupo retorna resultados, os grupos seguintes não são avaliados.\n\n| Grupo | Lógica | Descrição | Prioridade |\n| :---- | :---- | :---- | :---- |\n| 1 | [AND sem fuzzy](#operadores-e-fuzzy) | Busca produtos que contenham todas as palavras pesquisadas exatamente como digitadas, sem tolerância a variações ou erros de digitação. | Maior prioridade |\n| 2 | [AND com fuzzy](#operadores-e-fuzzy) | Busca produtos com todas as palavras, mas aceita pequenas variações (ex: erros de digitação, diferença de acentuação). | |\n| 3 | [OR sem fuzzy](#operadores-e-fuzzy) | Aceita produtos que contenham qualquer uma das palavras pesquisadas, mas exige correspondência exata. | |\n| 4 | [OR com fuzzy](#operadores-e-fuzzy) | Último recurso: aceita produtos com qualquer uma das palavras, com tolerância a variações. | Menor prioridade |\n\n### Operadores e fuzzy\n\n* **Operadores AND / OR:** o operador define se o produto precisa conter todas as palavras da busca ou apenas uma delas. Com AND, uma busca por \"tênis nike\" só retorna produtos que tenham os dois termos. Com OR, retorna qualquer produto que contenha \"tênis\" ou \"nike\", o que pode ampliar significativamente os resultados.\n\n* **Fuzzy:** define a tolerância a erros de digitação. O Intelligent Search tenta corrigir o que o usuário digitou de acordo com os itens registrados no catálogo. Por padrão, termos de três a cinco caracteres aceitam um erro e termos de seis ou mais aceitam dois erros.\n\n  Os erros considerados com fuzzy = 1 são: inserir um caractere a mais, remover um caractere, trocar um caractere ou trocar dois caracteres lado a lado. Espaços em branco não são considerados no fuzzy. Para esses casos, recomenda-se o uso de [sinônimos](https://help.vtex.com/pt/docs/tutorials/sinonimos).\n\n> ℹ️ O Intelligent Search escolhe o operador e o nível de fuzzy automaticamente. O lojista não controla esse comportamento. O sistema começa pelo grupo mais restrito (AND sem fuzzy) e avança para grupos mais permissivos apenas se o anterior não retornar resultados. Para mais detalhes, consulte [Comportamento da busca](https://help.vtex.com/pt/docs/tutorials/comportamento-da-busca#autocorrecao).\n\n### Fluxo de decisão\n\n- Se o Grupo 1 retorna resultados → exibe e para.\n- Se o Grupo 1 não retorna → tenta o Grupo 2.\n- Se o Grupo 2 não retorna → tenta o Grupo 3.\n- Se o Grupo 3 não retorna → tenta o Grupo 4.\n- Se nenhum grupo retorna resultados → busca sem resultado.\n\n**Exemplo prático:** Uma busca por \"dipirona 1g\" primeiro tenta encontrar produtos com exatamente essas palavras (Grupo 1). Não encontrando nada, tenta com fuzzy (Grupo 2) e pode retornar \"dipirona 1g sódica\" ou variações com grafia próxima. Se ainda não houver resultado, passa para OR e pode retornar produtos com apenas \"dipirona\" ou apenas \"1g\".\n\n## Etapa 2: como o Intelligent Search ordena os resultados\n\nApós identificar os produtos correspondentes, o Intelligent Search aplica um algoritmo de pontuação para definir a ordem de exibição. A tabela abaixo lista os fatores em ordem decrescente de prioridade:\n\n| # | Fator | Descrição | Exemplo |\n| :---- | :---- | :---- | :---- |\n| 1 | Produto promovido por regra de merchandising | Produto explicitamente priorizado pelo lojista via regra de merchandising. | Regra promovendo \"Sempre Free noturno\" → aparece no topo mesmo que outro absorvente corresponda melhor à busca. |\n| 2 | Produto adicionado por regra de merchandising | Produto forçado a aparecer nos resultados mesmo sem correspondência direta com o termo buscado. | Busca por \"vitamina C\" → \"kit imunidade com vitamina C e zinco\" aparece por regra, ainda que não bata diretamente com a query. |\n| 3 | Correspondência de ID completo | O consumidor pesquisou exatamente o ID do produto. | Busca por \"123456\" → produto com esse ID é exibido com alta prioridade. |\n| 4 | Correspondência de ID parcial | O consumidor digitou parte do ID do produto. | Busca por \"123\" → produtos como \"123456\" ou \"123789\" aparecem. |\n| 5 | Todas as palavras + keyword (palavra-chave) | Produto contém todas as palavras pesquisadas e há correspondência com a keyword do produto. | Busca por \"protetor solar facial FPS 50\" → produto com keyword \"protetor\" corresponde totalmente. |\n| 6 | Todas as palavras (sem keyword) | Produto contém todas as palavras, mas sem correspondência com a keyword. | Busca por \"solar protetor FPS 50\" → \"protetor solar corporal FPS 50\" corresponde às palavras, mas sem match de keyword. |\n| 7 | Produto despromovido por regra de merchandising | Produto com visibilidade reduzida pelo lojista via regra de merchandising. Ainda aparece, mas com menos destaque. | Regra despromovendo produtos de gripe fora da temporada → aparecem abaixo dos demais nas buscas por \"antigripal\". |\n| 8 | Produto indisponível (fora de estoque) | Produto sem estoque, configurado para aparecer mesmo assim. Exibido ao final dos resultados. | Busca por \"dipirona 1g\" → modelo fora de estoque aparece por último, com aviso de indisponibilidade. |\n\n> ℹ️ As pontuações exatas atribuídas a cada fator não são divulgadas publicamente, pois fazem parte da propriedade intelectual do algoritmo de relevância do Intelligent Search.\n\n## Conceitos importantes\n\n### Palavra-chave (keyword)\n\nA keyword é a palavra principal que define o produto. O Intelligent Search a identifica automaticamente com base no idioma da loja:\n\n- **Português e espanhol:** primeira palavra do nome do produto.\n- **Inglês:** última palavra do nome do produto.\n- A marca é sempre tratada como keyword, independentemente da sua posição no nome e do idioma.\n\n**Exemplos:**\n\n| Idioma | Nome do produto | Keyword | Regra |\n| :---- | :---- | :---- | :---- |\n| Português | Protetor solar facial FPS 50 | protetor | 1ª palavra |\n| Espanhol | Protector solar facial FPS 50 | protector | 1ª palavra |\n| Inglês | Facial SPF 50 sunscreen | sunscreen | última palavra |\n|  |  |  |  |\n| Português | Shampoo anticaspa Head and Shoulders | shampoo | 1ª palavra |\n| Espanhol | Champú anticaspa Head and Shoulders | champú | 1ª palavra |\n| Inglês | Head and Shoulders anti-dandruff shampoo | shampoo | última palavra |\n|  |  |  |  |\n| Português | Dipirona sódica 1g genérica | dipirona | 1ª palavra |\n| Espanhol | Dipirona sódica 1g genérica | dipirona | 1ª palavra |\n| Inglês | Generic 1g sodium dipyrone | dipyrone | última palavra |\n|  |  |  |  |\n| Português | Vitamina C 1000mg efervescente | vitamina | 1ª palavra |\n| Espanhol | Vitamina C 1000mg efervescente | vitamina | 1ª palavra |\n| Inglês | Effervescent 1000mg vitamin C | vitamin C | última palavra |\n\nO match de keyword do nome do produto e o match de marca são cumulativos: um produto que bate com os dois ao mesmo tempo recebe a maior pontuação possível. Ter apenas um dos dois já garante vantagem sobre produtos sem nenhum match de keyword.\n\n### Regras de merchandising\n\nAs [regras de merchandising](https://help.vtex.com/pt/docs/tutorials/regras-de-merchandising) são configurações manuais feitas pelo lojista para ajustar os resultados de busca. Elas têm a maior prioridade no algoritmo e permitem três ações:\n\n- **Promover:** empurrar um produto para o topo dos resultados.\n- **Adicionar:** incluir um produto nos resultados mesmo que ele não corresponda à busca.\n- **Despromover:** reduzir a visibilidade de um produto, mantendo-o no final da listagem.\n\n### Sinônimos\n\nO Intelligent Search permite configurar [sinônimos](https://help.vtex.com/pt/docs/tutorials/sinonimos) para expandir o alcance da busca. Por exemplo, mapear \"rimmel\" para \"máscara de cílios\".\n\n#### Sinônimos de baixa relevância\n\n> ⚠️ Esta funcionalidade está disponível apenas para um número restrito de contas. Entre em contato com o [Suporte VTEX](https://supporticket.vtex.com/support) para verificar a disponibilidade para sua loja.\n\nA funcionalidade de sinônimos de baixa relevância penaliza produtos que chegaram aos resultados via sinônimo em relação a produtos com correspondência direta ao termo buscado.\n\nA penalização não é absoluta. Com a funcionalidade ativada, o peso da keyword é maior do que o peso do sinônimo, o que define a seguinte hierarquia de relevância:\n\n1. Match natural + keyword: maior pontuação.\n2. Match via sinônimo + keyword: supera match natural sem keyword.\n3. Match natural sem keyword.\n4. Match via sinônimo sem keyword: menor pontuação.\n\nUm produto que veio de sinônimo mas tem match de keyword será mais relevante do que um produto com match natural que não tem keyword.\n\n## Critérios de desempate\n\nQuando dois ou mais produtos têm pontuação de relevância similar, o Intelligent Search utiliza os critérios das [regras de relevância](https://help.vtex.com/pt/docs/tutorials/regras-de-relevancia) configurados pelo lojista para desempatar. Os critérios disponíveis são:\n\n| Critério | Descrição |\n| :---- | :---- |\n| Desconto | Produtos com maior percentual de desconto ganham prioridade. |\n| Data de lançamento | Produtos mais recentes são priorizados. |\n| Mais vendidos | Ordenação por volume de pedidos. |\n| Mais vendidos por receita | Ordenação pelo valor total gerado em vendas. |\n| Popularidade | Baseado em interações e visualizações dos produtos. |\n| Promoção | Produtos com promoção ativa recebem maior pontuação. |\n| Pontuação do catálogo | Score definido diretamente no catálogo da loja. |\n| Variedade de matriz disponível | Produtos com mais variações em estoque são priorizados. |\n\nO impacto de cada critério é determinado pelo peso configurado pelo lojista. Se um critério prioritário estiver definido (ex: \"Mais vendidos\"), ele domina o desempate. Caso contrário, o sistema usa a soma ponderada normalizada de todos os critérios ativos.\n\n## Exemplos práticos\n\n### Busca: \"dorflex\"\n\n| Produto (marca) | Relevância | Justificativa |\n| :---- | :---- | :---- |\n| Dorflex 10 comprimidos (Dorflex) | Alta | Keyword do nome \"Dorflex\" + marca \"Dorflex\": duplo match cumulativo, maior pontuação. |\n| Analgésico Dorflex 36 comprimidos (Dorflex) | Empate* | Só match de marca \"Dorflex\": um match de keyword. |\n| Dorflex 36 comprimidos (Sanofi) | Empate* | Só match de keyword do nome \"Dorflex\": um match de keyword. Desempate pelos critérios de relevância configurados. |\n\n\\* Empate na pontuação de relevância. Ambos têm exatamente um match de keyword. A ordem final entre eles é determinada pelos critérios de relevância configurados (ex: mais vendidos, desconto, data de lançamento).\n\n### Busca: \"minoxidil\"\n\n| Produto (marca) | Relevância | Justificativa |\n| :---- | :---- | :---- |\n| Minoxidil Turbinado 120ml (Minoxidil) | Alta | Keyword do nome \"Minoxidil\" + marca \"Minoxidil\": duplo match cumulativo. |\n| Pant Minoxidil 50mg/ml 50ml 3 Frascos (Minoxidil) | Empate* | Só match de marca \"Minoxidil\": um match de keyword. |\n| Minoxidil 50mg/ml Biosintética 50ml Spray (Biosintética) | Empate* | Só match de keyword do nome \"Minoxidil\": um match de keyword. Desempate pelos critérios de relevância configurados. |\n| Pant Minoxidil 50mg/ml 50ml 3 Frascos (Ache) | Baixa | Keyword do nome é \"Pant\" e a marca é \"Ache\": nenhum match de keyword ou marca. |\n\n\\* Empate na pontuação de relevância. Ambos têm exatamente um match de keyword. A ordem final entre eles é determinada pelos critérios de relevância configurados (ex: mais vendidos, desconto, data de lançamento)."}