DocumentaçãoCommerceGerenciamento de catálogo

Configurar pesquisa no catálogo

Last update: Mon May 05 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • Iniciante
  • Intermediário
  • Administrador
  • Líder
  • Usuário

Há duas variações da configuração da Pesquisa no catálogo. O primeiro método descreve as configurações disponíveis quando o Live Search é instalado. O segundo método descreve as definições de configuração do Adobe Commerce nativo com OpenSearch.

NOTE
Para projetos de infraestrutura em nuvem, consulte instruções adicionais no Guia do Commerce on Cloud Infrastructure.

  1. Na barra lateral Admin, vá para Stores > Settings>Configuration.

  2. No painel esquerdo, expanda Catalog e escolha Catalog abaixo de.

  3. Expandir Seletor de expansão a seção Catalog Search.

    Pesquisa no catálogo do Live Search {width="600" modal="regular"}

    Para obter uma lista detalhada dessas opções, consulte Adobe Commerce com Live Search na Referência de Configuração.

  4. Para limitar o comprimento e a contagem de palavras do texto da consulta de pesquisa, defina um valor para Minimal Query Length e Maximum Query Length.

  5. Para limitar a quantidade de resultados de pesquisa populares a serem armazenados em cache para respostas mais rápidas, defina uma quantidade para Number of top search results to cache.

    O valor padrão é 100. Inserir um valor de 0 armazena em cache todos os termos e resultados da pesquisa quando inseridos uma segunda vez.

  6. Para alterar o número máximo de linhas disponíveis para os resultados retornados no pop-up da vitrine, digite um valor Autocomplete Limit diferente.

    A restrição do número de linhas melhora o desempenho das pesquisas e reduz o tamanho da lista retornada. O valor padrão é 8 linhas.

Método 2: Commerce com OpenSearch

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.
  • Nas versões 2.4.4 e 2.4.3-p2, todos os campos rotulados como Elasticsearch também se aplicam ao OpenSearch. Quando o suporte para o Elasticsearch 8.x foi introduzido na versão 2.4.6, novos rótulos foram criados para distinguir entre as configurações do Elasticsearch e do OpenSearch. No entanto, as opções de configuração de ambos são as mesmas.

Etapa 1: configurar opções gerais de pesquisa

NOTE
Com o OpenSearch e o Elasticsearch, não há suporte pronto para uso para pesquisa por 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.

  1. Na barra lateral Admin, vá para Stores > Settings>Configuration.

  2. No painel esquerdo, expanda Catalog e escolha Catalog abaixo de.

  3. Expandir Seletor de expansão a seção Catalog Search.

    Configurações do mecanismo de pesquisa {modal="regular"}

    Para obter mais informações sobre essas opções, consulte Adobe Commerce com pesquisa nativa na Referência de Configuração.

  4. Para limitar o comprimento e a contagem de palavras do texto da consulta de pesquisa, defina um valor para Minimal Query Length e Maximum Query Length.

    note important
    IMPORTANT
    O valor definido para essa faixa mínima e máxima deve ser compatível com a faixa correspondente definida na configuração do mecanismo de pesquisa. Por exemplo, se você definir esses valores como 2 e 300 no Commerce, atualize os valores correspondentes no mecanismo de pesquisa.

  5. Para limitar a quantidade de resultados de pesquisa populares a serem armazenados em cache para respostas mais rápidas, defina uma quantidade para Number of top search results to cache.

    O valor padrão é 100. Inserir um valor de 0 armazena em cache todos os termos e resultados da pesquisa quando inseridos uma segunda vez.

  6. Se quiser habilitar ou desabilitar o indexador EAV do Produto, defina o Enable EAV Indexer.

    Esse recurso melhora a velocidade de indexação e restringe o uso do indexador por extensões de terceiros.

  7. Para limitar o número máximo de resultados da pesquisa a serem exibidos para preenchimento automático, defina uma quantidade para Autocomplete Limit.

    A restrição dessa quantidade aumenta o desempenho das pesquisas e reduz o tamanho da lista exibida. O valor padrão é 8.

Etapa 2: configurar a conexão OpenSearch

IMPORTANT
Os campos Search Engine, OpenSearch Server Hostname, OpenSearch Server Port, OpenSearch Index Prefix, Enable OpenSearch HTTP Auth e OpenSearch Server Timeout foram configurados quando o Commerce foi instalado ou atualizado. Esses valores devem ser alterados somente ao atualizar ou modificar o OpenSearch.

  1. Para Search Engine, selecione OpenSearch.

  2. Para OpenSearch Server Hostname, aceite o valor padrão que foi configurado quando o Commerce foi instalado.

  3. Para OpenSearch Server Port, aceite o valor padrão que foi configurado quando o Commerce foi instalado.

    Neste exemplo, o valor padrão é 9200.

  4. Para OpenSearch Index Prefix, insira um prefixo para identificar o índice Elasticsearch.

    O valor padrão é magento2.

  5. Para usar a autenticação HTTP para solicitar um nome de usuário e senha para acessar o servidor OpenSearch, defina Enable OpenSearch HTTP Auth como Yes.

  6. Por OpenSearch Server Timeout, insira o número de segundos antes do tempo limite do sistema expirar.

    O valor padrão é 15.

  7. Para verificar a configuração, clique em Test Connection.

Etapa 3: configurar sugestões e recomendações

NOTE
As sugestões e recomendações de pesquisa podem afetar o desempenho do servidor.

  1. Para oferecer recomendações, defina Enable Search Recommendations como Yes e faça o seguinte:

    • Para Search Recommendation Count, insira o número de recomendações a serem oferecidas.

    • Para mostrar o número de resultados encontrados para cada recomendação, defina Show Results Count for Each Recommendation como Yes.

  2. Defina Enable Search Suggestions como Yes e faça o seguinte:

    • Para Search Suggestions Count, insira o número de sugestões de pesquisa a serem oferecidas.

    • Para mostrar o número de resultados encontrados para cada sugestão, defina Show Results for Each Suggestion como Yes.

Etapa 4: configurar termos mínimos para corresponder a

Para controlar o número mínimo de termos da sua consulta que os resultados da pesquisa devem corresponder para retorno, especifique um valor para Minimum Terms to Match. Especificar esse valor garante a relevância ideal dos resultados para os compradores. Para obter uma lista de valores aceitos, consulte o parâmetro minimum_should_match na documentação do OpenSearch.

Quando terminar, clique em Save Config.

recommendation-more-help
af062d56-f22c-4537-813d-bedf8b92a071