DocumentaçãoGerenciamento de catálogo

Resultados da pesquisa

Última atualização: 20 de junho de 2026

Criado para:

  • {"id":"b5a62a22-46f7-4f0d-b151-3fc640bef588"},{"id":"e8ccd51f-da0d-4e3b-939b-e30d5ebb1ea5"}
  • {"id":"b69b2659-1057-424e-8fc5-ed9e016dc554"},{"id":"c66ffd68-0f65-42bb-aa23-b4020f12e0bd"},{"id":"f8a45b24-4be7-4f1b-909b-60d06b483a20"}
NOTE
Esta página descreve a funcionalidade de pesquisa padrão que pode ser diferente do Live Search.

A lista Resultados da Pesquisa inclui todos os produtos que correspondem aos critérios de pesquisa inseridos na caixa Pesquisa Rápida ou no formulário Pesquisa Avançada. Cada lista de produtos no catálogo tem essencialmente os mesmos controles. A única diferença é que um é o resultado de uma consulta de pesquisa, e a outra diferença é o resultado da navegação.

Os resultados podem ser formatados como uma grade ou lista e classificados por uma seleção de atributos. Os controles de paginação serão exibidos se houver mais produtos do que cabem na página. Use esses controles para mover de uma página para a próxima. O número de registros por página é determinado pela configuração de front-end do catálogo. Para obter mais informações, consulte Listagens de Produtos.

Com Elasticsearch:

  • Não há suporte pronto para uso para pesquisa pelo sufixo. Por exemplo, a pesquisa por SKU pode não retornar o resultado esperado se a palavra-chave contiver somente a parte final do SKU.
  • Há suporte pronto para uso para pesquisa por prefixo (pesquisa parcial por palavra-chave) somente para atributos de produto name e sku. Todos os outros atributos de produto são pesquisados por toda a palavra-chave, com a correspondência exata.
  • Os resultados da pesquisa de atributos de produto name e sku são baseados na relevância, não na correspondência exata. As correspondências mais relevantes, como um Nome do Produto ou SKU com correspondência exata, são listadas primeiro. Para procurar uma correspondência exata, o cliente pode usar aspas duplas na consulta de pesquisa. Por exemplo, uma consulta de pesquisa WSH12-32-Red pode retornar vários produtos, classificados por relevância. Mas uma consulta de pesquisa "WSH12-32-Red" retorna somente um produto com exatamente correspondidos sku.

Pesquisar resultados com controles de paginação {width="700" modal="regular"}

IMPORTANT
Devido ao anúncio do fim do suporte do Elasticsearch 7 para agosto de 2023, é recomendável que todos os clientes do Adobe Commerce migrem para o mecanismo de pesquisa OpenSearch 2.x. Para obter informações sobre como migrar o mecanismo de pesquisa durante a atualização do produto, consulte Migrando para o OpenSearch no Guia de Atualização.

Mapeamento de palavras-chave para estender os resultados da pesquisa

Essa técnica usa um atributo para criar uma associação baseada em palavras-chave entre dois produtos, de modo que uma pesquisa por um dos produtos retorne resultados para os dois. Você pode usar o mapeamento de palavra-chave para promover um produto nos resultados da pesquisa onde, de outra forma, ele não seria exibido.

Resultados de pesquisa com mapeamento de palavra-chave {width="700" modal="regular"}

O exemplo a seguir usa o mapeamento de palavra-chave com base no SKU. Quando um dos SKUs é inserido na caixa de pesquisa, ambos os produtos aparecem nos resultados. Os SKUs dos seguintes produtos configuráveis são mapeados, em vez dos SKUs de variações de produtos:

  • Jaqueta corta-vento Montana (MJ03)
  • Chaz Kangaroo Hoodie (MH01)

Etapa 1: Criar um atributo

  1. Na lista Products, abra o Montana Wind Jacket (MJ03) no modo de edição.

  2. No canto superior direito, clique em Add Attribute.

  3. Na página Selecionar atributo, clique em Create New Attribute.

  4. Complete as propriedades do atributo da seguinte maneira:

    Attribute Properties

    • Attribute Label - Search Keywords
    • Catalog Input Type for Store Owner - Text Field

    Advanced Attribute Properties

    • Add to Column Options - Yes (padrão)
    • Use in Filter Options - Yes (padrão)

    Storefront Properties

    • Use in Search - Yes
    • Visible on Catalog Pages in the Storefront - No
    • Used in Product Listings - No

  5. Quando terminar, clique em Save Attribute.

    O atributo é adicionado ao conjunto de atributos do produto.

Etapa 2: Mapear o primeiro produto

  1. Na página de configurações do produto, role para baixo e expanda a seção Attributes.

  2. No campo Search Keywords, insira a SKU MH01 que deve ser mapeada para este produto.

    Você pode inserir vários SKUs separados por um espaço no campo Pesquisar palavras-chave. Neste exemplo, apenas um é inserido.

    Seção de atributos com palavra-chave de pesquisa {width="600" modal="regular"}

  3. Quando terminar, clique em Save.

  4. Vá para System > Tools>Cache Management​e atualize o Page Cache.

Etapa 3: Mapear o segundo produto

  1. Na lista Products, abra o Chaz Kangaroo Hoodie (MH01) no modo de edição.
  2. Role para baixo e expanda a seção Attributes.
  3. No campo Search Keywords, insira o SKU do outro produto, MJ03.
  4. Clique em Save.
  5. Vá para System > Tools>Cache Management​e atualize o Page Cache.

Etapa 4: teste-o na loja

  1. Vá para a loja e digite MJ03 na caixa Pesquisa rápida.
  2. Verifique se ambos os produtos são retornados na lista de resultados da pesquisa.

Pesquisa ponderada

Os atributos de produto ativados para pesquisa no catálogo podem receber um peso para atribuir a eles um valor mais alto nos resultados da pesquisa. Os atributos com um peso maior são retornados antes dos atributos com um peso menor. Por exemplo, se houver dois atributos no sistema, cor com um peso de pesquisa de 3 e descrição com um peso de pesquisa de 1. Uma pesquisa pela palavra vermelho retorna uma lista de produtos com um valor de atributo de cor de red na parte superior dos resultados da pesquisa e retorna produtos com descrições que contêm a palavra vermelho na parte inferior dos resultados da pesquisa. Neste exemplo, o atributo color tem um peso definido maior que o atributo description.

IMPORTANT
A classificação por relevância é afetada por vários critérios e relações entre eles ao mesmo tempo. Search Weight é apenas um desses critérios. Isso significa que, às vezes, os atributos com menor peso de pesquisa ainda podem ter mais relevância do que os atributos com maior peso de pesquisa. Outros critérios podem incluir o número de correspondências em um determinado atributo, a posição do termo de pesquisa encontrado e a estrutura geral do texto antes e depois de um termo de pesquisa.

Para definir as propriedades de peso da pesquisa de um atributo:

  1. Na barra lateral Admin, vá para Stores > Attributes>Product.

  2. Localize o atributo na lista e abra-o no modo de edição.

  3. No painel esquerdo, escolha Storefront Properties e faça o seguinte:

    • Para incluir o atributo em consultas de pesquisa, defina Use in Search como Yes.

    • Para estabelecer o valor de pesquisa do atributo, defina Search Weight como um número de 1 a 10, onde 10 tem a prioridade mais alta. Se nenhum valor for inserido, todos os atributos assumirão como padrão um peso de pesquisa de 1.

    Peso de Pesquisa {width="600" modal="regular"}

  4. Quando terminar, clique em Save Attribute.

recommendation-more-help
commerce-admin-help-catalog