{"section":"tutorials","requestedLocale":"pt","requestedSlug":"comportamento-da-busca","locale":"pt","slug":"comportamento-da-busca","path":"docs/pt/tutorials/intelligent-search/comportamento-do-intelligent-search/comportamento-da-busca.md","branch":"main","content":"O Motor de Busca é o centro da inteligência do VTEX Intelligent Search. Ele interpreta o termo buscado e apresenta a listagem filtrada e ordenada de produtos. Essa ferramenta possibilita uma pesquisa mais objetiva, por meio de indexação e tratamento dos dados do catálogo.\n\nEssa funcionalidade é padrão do VTEX Intelligent Search e atende a maioria dos cenários. Contudo, o Motor de Busca também apresenta alguns ajustes para que o resultado da busca seja aperfeiçoado. Neste guia, apresentamos:\n\n* [Comportamento padrão da busca](#comportamento-padrão-da-busca)\n* [Configurações para o comportamento da busca](#configuracoes-para-o-comportamento-da-busca)\n* [Formas alternativas de busca](#formas-alternativas-de-busca)\n\n## Comportamento padrão da busca\n\nA seguir, apresentamos características do comportamento padrão do Intelligent Search.\n\n### Autocorreção\n\nO usuário pode cometer erros ortográficos ao realizar uma busca. É função da ferramenta interpretar esses erros e apresentar como resultados produtos que se aproximem da pesquisa realizada.\n\nPara isso, o Motor de Busca tenta corrigir o que o usuário digitou de acordo com os itens registrados no Catálogo. Para cada termo pesquisado, uma quantidade específica de caracteres errados é permitida. Essa quantidade de erros aceitos é chamada de _fuzzy_.\n\nO _fuzzy_ varia de acordo com o tamanho do termo pesquisado. Por padrão, caso o termo tenha de 3 a 5 caracteres, o _fuzzy_ aplicado será 1, ou seja, é permitido errar 1 caractere. Para termos de 6 caracteres ou mais, o _fuzzy_ aplicado será 2.\n\nOs erros previstos considerando *fuzzy* = 1 são:\n\n* Inserir 1 caractere a mais.\n* Remover 1 caractere.\n* Trocar 1 caractere.\n* Trocar 2 caracteres que estiverem lado a lado.\n\nExemplo: suponha que um cliente queira pesquisar pelo termo `bola`. Seguindo a configuração padrão (*fuzzy* = 1 para termos de 3 a 5 caracteres), o Motor de Busca vai apresentar o resultado `bola` para qualquer busca que contenha os erros aceitos, como:\n\n* `bolha` (inserir 1 caractere a mais)\n* `boa` (remover 1 caractere)\n* `bora` (trocar 1 caractere)\n* `obla` (trocar 2 caracteres que ficam um do lado do outro entre eles)\n\n> ℹ️ Espaços em branco não são considerados no *fuzzy*, então `base ball` não será corrigido para `baseball`, por exemplo. Recomendamos o uso de [sinônimos](/pt/docs/tutorials/sinonimos) para esses casos.\n\n### Resultado mínimo\n\nA quantidade mínima de resultados exibidos a partir de qualquer busca realizada é 1. Em qualquer busca, se o número mínimo de resultados não for atingido, a [autocorreção](#autocorrecao) é aplicada.\n\nEm uma busca com múltiplos termos, ocorre a lógica a seguir:\n\n1. Se o resultado mínimo não for atingido mesmo com a autocorreção inicial, a busca passa a incluir resultados mais abrangentes, que apresentam qualquer um dos termos pesquisados. Por exemplo, quando um usuário pesquisa por \"tenis nike\", mas o catálogo não possui nenhum produto com esse nome, a busca pode apresentar como resultado um produto com apenas o termo \"tenis\" no nome.\n2. Se a busca abrangente não apresentar o resultado mínimo, ela será repetida aplicando a autocorreção novamente a cada um dos termos.\n\n> ⚠️ Buscas com múltiplos termos são mais eficientes quando o cliente ordena os resultados por relevância, já que elas podem ter um número maior de resultados além do contexto que foi buscado. Na ordenação por relevância, ainda priorizam-se os itens relacionados aos múltiplos termos. Porém, ao aplicar outras ordenações, como preço ou mais vendidos, a ordem dos resultados depende desses valores numéricos e não necessariamente prioriza itens que contêm mais palavras dos termos de busca.\n\n### Limite de paginação\n\nO VTEX Intelligent Search limita o resultado de busca a 50 páginas. Esse limite incentiva o uso de filtros, permitindo uma navegação mais relevante e focada para o usuário.\n\n## Configurações para o comportamento da busca\n\nHá um conjunto de configurações que alteram a listagem e a ordenação de produtos exibidos no resultado de busca. Nas seções a seguir, você verá as principais definições que afetam o comportamento da busca.\n\n### Definição de campos pesquisáveis\n\nDetermina quais informações de produto são pesquisáveis. A partir da configuração, toda pesquisa realizada na barra de busca verifica o conteúdo desses campos para gerar resultados de busca. Confira a tabela a seguir para entender quais são as informações pesquisáveis por padrão e as demais opções de configuração:\n\n| Informações | Configuração |\n| - | - |\n| | Informações pesquisáveis por **padrão** no VTEX Intelligent Search. Para remover alguma delas, entre em contato com o nosso [Suporte](https://supporticket.vtex.com/support). |\n| | Para incluir as especificações desejadas como campos pesquisáveis, é necessário configurar a opção **Especificações pesquisáveis** no Admin VTEX, em **Intelligent Search** > **Configurações da busca**.

Por exemplo: se uma camisa não tiver a cor no nome do produto ou do SKU, por padrão, o Intelligent Search não identifica esse atributo em uma pesquisa por \"camisa azul\", trazendo como resultado camisas de diversas cores. Contudo, se a especificação de cor estiver configurada como pesquisável, a busca consegue trazer camisas azuis nas primeiras posições.

Para mais detalhes sobre a definição de especificações pesquisáveis, acesse o guia [Configurações da busca](/pt/docs/tutorials/configuracao-da-busca#configuracoes-gerais). Saiba mais sobre especificações em [Especificações de produto e de SKU](/pt/docs/tracks/especificacoes-definicao-de-conceito). |\n| >Código do fabricante (`ManufactureID`) | Entre em contato com o nosso [Suporte](https://supporticket.vtex.com/support) para definir esses campos como pesquisáveis. | \n\n_Exemplo_: foi configurado que a especificação \"cor\" é pesquisável e o produto está cadastrado com o nome \"Tênis Nike Total 90\" e com a cor \"preta\". Se um cliente pesquisar por \"Tenis Preto\", a ferramenta retornará produtos que possuem o termo \"tenis\" e cor \"preta\" no topo do resultado de busca.\n\nÉ possível buscar por caracteres especiais (`-` e `/`) para encontrar um produto.\n\n> ⚠️ A escolha dos campos de busca afeta as possibilidades das [Regras de merchandising](/pt/docs/tutorials/regras-de-merchandising), pois apenas campos pesquisáveis podem ser utilizados para configurar as regras. Por exemplo, ao definir somente o campo **`SKUID` **como pesquisável, não será possível promover um **`ProductID` **ou um **`ProductRefID` **utilizando Regras de merchandising.\n\n### Definição e ordenação de campos de filtro\n\nEm todos os resultados de busca são apresentados filtros que podem ser selecionados pelo usuário. Por padrão, alguns filtros são pré-definidos, mas é possível criar outros de acordo com a necessidade da loja. Outro ponto customizável é a ordem de visualização. Exemplo: em uma lista de resultados de busca, podem existir os filtros de Preço, Categorias e Marca.\n\n### Configuração de relevância\n\nA relevância é a funcionalidade que define a ordem dos produtos no resultado de busca. Essa configuração permite atribuir pesos e priorizar determinados critérios utilizados pelo Motor de Busca, como popularidade, data de lançamento do produto e participação em promoções, por exemplo. A relevância de um produto é composta pela combinação dos pesos e prioridades definidos por cada lojista.\n\n_Exemplo_: um lojista configurou que o critério Promoção possui uma relevância maior que outros critérios. Dessa forma, quando o cliente pesquisa pelo termo “camiseta” na busca interna da loja, as camisetas incluídas em promoções tendem a aparecer primeiro nos resultados, dependendo dos pesos atribuídos aos outros critérios.\n\nPara mais informações sobre como personalizar a ordenação dos resultados de acordo com as necessidades da sua loja, leia o artigo [Configuração de relevância](/pt/docs/tutorials/regras-de-relevancia).\n\n> ℹ️ Ao utilizar o Intelligent Search, existem duas opções que definirão a ordem de suas coleções. Usando o comando `map=productClusterIds`, estará definindo que a ordem de suas coleções será a que foi pré definida pelo lojista, com seu próprio critério de relevância. Se você optar por usar `productClusterNames`, definirá que deseja que suas coleções sigam os padrões de relevância do próprio Intelligent Search.\n\n## Formas alternativas de busca\n\nÉ possível buscar pelo ID de um ou mais itens na barra de busca ou adicionando parâmetros de busca (*query*) na URL da loja.\n\n### Match parcial\n\nAo digitar somente os primeiros dígitos exatos do ID do produto (`ProductID`), código de referência do produto (`ProductRefID`), ID do SKU (`SKUID`), código de referência do SKU (`SKURefID`) ou EAN na barra de busca, o Intelligent Search fará o match parcial com produtos e SKUs ativos na loja, incluindo-os nos resultados da busca.\n\nPor exemplo, se o ID do produto for `123456789` e a busca for `123`, esse produto aparecerá entre os resultados. Porém, se a busca for `234`, sem algum dos primeiros dígitos do ID, esse produto não aparecerá.\n\n### URL\n\nPara buscar a partir da URL da sua loja, adicione parâmetros de busca (*query*) no final da URL da loja, respeitando uma das estruturas a seguir:\n\n- Exemplo para pesquisa de um item: `[endereço da conta]/[tipo do id]:[id_1]?q=[tipo do id]&map=ft`\n- Exemplo para pesquisa de lista de itens: `[endereço da conta]/[tipo do id]:[id_1];[id_2];[id_3]?q=[tipo do id]:[id_1];[id_2];[id_3]&map=ft`\n\nOs possíveis tipos de valores para o campo tipo do ID são `product.id`, `sku.id`,`sku.ean`, `sku.reference` ou `id` (ProductID, ProductRefID, SKUID, SKURefID e EAN). Importante destacar que todos os IDs buscados devem pertencer ao mesmo tipo. \n\n - **Busca por SKU ID:** `?q=sku.id:` ou `?q=sku:`\n - **Busca por EAN:** `?q=sku.ean: `\n - **Busca por reference ID:** `?q=sku.reference:` \n - **Busca por slug:** `?q=product.link:` \n - **Busca por product ID:** `?q=product:` ou `?q=product.id:`"}