{"section":"tutorials","requestedLocale":"pt","requestedSlug":"como-funciona-a-busca-da-vtex","locale":"pt","slug":"como-funciona-a-busca-da-vtex","path":"docs/pt/tutorials/catálogo/busca/como-funciona-a-busca-da-vtex.md","branch":"main","content":"Este artigo tem o objetivo de descrever o funcionamento do sistema de busca da VTEX.\n\n> ⚠️ A VTEX apresenta duas opções da busca - a busca VTEX e o VTEX Intelligent Search. Esse artigo se refere à busca VTEX. Para saber mais sobre o aplicativo VTEX Intelligent Search acesse [nossa track](/pt/tracks/vtex-intelligent-search--19wrbB7nEQcmwzDPl1l4Cb).\n\n## Como o buscador da VTEX prioriza a exibição de produtos\n\nO buscador da VTEX conta com um algoritmo inteligente que, a partir do termo buscado, identifica qual é o melhor resultado para apresentar ao usuário.\n\nOu seja, sempre é apresentado o resultado que mais gerará conversão de venda. É claro que o sucesso desse resultado depende, exclusivamente, do cadastro do catálogo (marca, departamento, categoria, produto, especificação etc).\n\nDe acordo com o termo buscado, o sistema pode renderizar os resultados abaixo, nesta ordem de prioridade:\n1. Landing Page\n2. Marca\n3. Departamento\n4. Busca por termo (palavra-chave)\n\n### 1. Landing Page\n\nSe o termo buscado corresponder exatamente ao nome de uma pasta configurada no CMS (ou seja, a uma landing page), essa pasta será renderizada.\n\n> ⚠️ Para uma pasta ser buscável ela deve possuir um layout. Mesmo que a pesquisa seja por uma pasta filha, a pai também requer um layout.\n\n### 2. Marca\n\nSe o termo buscado corresponder exatamente ao nome ou palavra substituta de alguma marca cadastrada, o sistema renderiza apenas os produtos dessa marca. Se o sistema identificar duas ou mais marcas com a mesma **palavra substituta** (o que é considerado uma inconsistência de cadastro), o sistema renderiza apenas a primeira encontrada (e seus produtos).\n\nO resultado desta página será uma página de marca. Olhando pelo código fonte da página: ``\n\n### 3. Departamento\n\nSe o termo buscado corresponder exatamente ao nome ou palavra substituta de algum departamento cadastrado, o sistema renderiza apenas os produtos desse departamento. Se o sistema identificar dois ou mais departamentos com a mesma **palavra substituta** (o que é considerado uma inconsistência de cadastro), o sistema renderiza apenas a primeiro departamento encontrado (e seus produtos).\n\nO resultado dessa página será uma página de Departamento. Você pode conferir qual página veio como resultado consultando o código-fonte. Neste caso, o seguinte comentário deve estar no código da página: ``\n\n### 4. Busca por termo (palavra-chave)\n\nSe o sistema não identifica uma Landing Page, uma Marca ou um Departamento correspondente ao termo buscado, ele aplica uma busca por termo (palavra-chave).\n\nO resultado desta página será uma página de busca. Você pode conferir qual página veio como resultado consultando o código-fonte. Neste caso, o seguinte comentário deve estar no código da página: ``\n\nQuando a busca é por termo, o buscador aplica a consulta no __indexador__, que é o responsável pelo algoritmo de busca por termo. \n\n#### Pontuação\n\nEsse algoritmo usa o conceito de pontuação (_Score_) para priorizar e ordenar os produtos.\nA cada consulta realizada, o indexador pontua os produtos de acordo com o termo consultado. Alguns campos da base (com pesos diferentes) são considerados para o cálculo dessa pontuação.\n\nA vitrine é montada com base nessa pontuação, em ordem decrescente, ou seja, o produto mais pontuado será o primeiro a ser exibido; e o menos pontuado, o último.\n\n> ℹ️ Para mais informações sobre pontuação, confira o artigo [Como funciona o campo Score?](/pt/docs/tutorials/como-funciona-o-campo-score).\n\n## Como funciona a busca\n\nPara entender a busca da VTEX, inicialmente é preciso saber como funciona o indexador e o seu processo de atualização.\n\n### Indexador do catálogo\n\nO indexador do catálogo é uma base de dados escalável de acesso rápido, com algorítimos configuráveis de priorização de resultado. Ele está posicionado entre o banco de dados convencional e o usuário. Veja o esquema abaixo:\n\n![](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/catálogo/busca/como-funciona-a-busca-da-vtex_1.png)\n\nNo indexador encontramos todas as informações referentes ao catálogo de produtos (produtos, SKUs, marcas, departamentos, categorias). O buscador utiliza essas informações para localizar os produtos e exibi-los nas vitrines e resultados de busca. Portanto, somente os produtos indexados podem ser encontrados pela busca.\n\n### Processo de atualização (Indexação)\n\nAlterações nas características de qualquer produto (dados principais, preço, estoque, coleção etc.) geram atualizações do indexador. Ou seja, sempre que um produto é alterado ele é enviado para o final da fila de indexação.\n\nQuando essa fila de indexação for consumida, as alterações aplicadas ficarão disponíveis para exibição no site. O processo de indexação é seguro e conta com regras de repescagem. \n\nOu seja, sempre que, por alguma razão, um item não é indexado na primeira tentativa, o sistema realiza outras tentativas.\n\n### Campos e pesos\n\nEstes são os campos usados pelo algoritmo de busca e seus pesos para pontuação de produtos:\n- __Nome do Produto__: 2.8\n- __Primeiro nome do produto__: 2.5\n- __Primeiro e segundo nome do produto__: 1.2\n- __Nome complemento do produto__: 1.0\n- __Palavras substitutas (produto e marca)__: 0.7\n- __Especificações de produto (apenas para campos dos tipos `texto indexado` e `texto longo indexado`)__: 0.5\n\nPor exemplo, considerando o seguinte indexador:\n\n| Nome do produto     | Nome complemento do produto\t    | Palavras substitutas     | Especificações de produto     |\n| ---------- | ---------- | ---------- | ---------- |\n| Bola de futebol       | Society       | bola de futibol, bola de football       | Branca       |\n| Bola       | Society       | soçaite, sossaite       | Bola de futebol       |\n| Chuteira de futebol       | Campo       | Xuteira de futebol, Chuteira de football       | Branca       |\n\n#### Termo buscado 1: Bola de futebol\n\nResultado:\n1. **Bola de futebol** (Melhor pontuado pois o termo corresponde exatamente ao nome do produto)\n2. **Bola** (Segundo melhor pontuado pois o termo corresponde ao valor de uma especificação)\n3. **Chuteira de futebol** (Terceiro melhor pontuado pois parte do termo corresponde a parte do nome do produto)\n\n#### Termo buscado 2: Bola branca\n\nResultado:\n1. **Bola** (Melhor pontuado pois parte do termo corresponde exatamente ao nome do produto)\n2. **Bola de futebol** (Segundo melhor pontuado pois parte do termo buscado corresponde a parte do nome do produto)\n3. **Chuteira de futebol** (Terceiro melhor pontuado pois parte do termo corresponde a uma especificação)\n\nA utilização de __palavras substitutas__, apesar de ter um peso baixo para a pontuação do indexador, é um recurso extremamente importante. Com esse recurso é possível atingir usuários que realizam buscas por termos gramaticalmente errados mas com a mesma semântica.\n\n## Saiba mais\n - [Como funciona o campo Score](/pt/docs/tutorials/como-funciona-o-campo-score)"}