Sinônimos e relevância da busca no Magento 2: guia de ajuste

Quem usa a busca do site geralmente sabe o que quer, o que faz dos resultados de busca uma das páginas mais valiosas da loja. A busca padrão do Magento é razoável, mas não conhece o vocabulário da loja: as marcas que os clientes escrevem errado, as palavras regionais para o mesmo produto, os códigos que os compradores usam. Este artigo mostra as ferramentas que o Magento Open Source e o Adobe Commerce 2.4.8 oferecem para melhorar a relevância, e como testar as mudanças em vez de chutar.

Comece pelos dados reais de busca

Antes de mudar qualquer coisa, olhe o que as pessoas buscam. Marketing, SEO & Search, Search Terms lista cada consulta com o número de usos e o número de resultados. Dois relatórios valem ser conferidos todo mês:

• Consultas com zero resultados. São as lacunas mais claras: erros de digitação, palavras que o catálogo não usa, produtos que você não vende.
• Consultas frequentes. Busque você mesmo as cinquenta mais frequentes e avalie a primeira linha de resultados. Se os primeiros produtos não são os que você esperaria, aquela consulta precisa de ajuste.

Se você acompanha a busca no GA4, o relatório de busca no site acrescenta quais buscas levaram a compras. A configuração está em tracking de ecommerce com GA4 e GTM.

Grupos de sinônimos

Os sinônimos são gerenciados em Marketing, SEO & Search, Search Synonyms. Cada grupo é uma lista, separada por vírgulas, de palavras e frases que o Magento trata como iguais na busca. Uma busca por qualquer palavra do grupo também busca as outras.

sofa,couch,settee
tshirt,t-shirt,tee
phone case,phone cover,mobile case

Algumas coisas para saber sobre como os grupos se comportam:

• Os grupos são de mão dupla. Cada termo se expande para todos os outros. Não existe configuração no core para sinônimos de mão única, em que a busca por uma palavra deve incluir outra mas não o contrário. Se precisar disso, mantenha o grupo pequeno e pense no que a busca inversa vai retornar.
• Escopo. Um grupo pode valer para todas as store views, um website ou uma store view. Sinônimos dependem do idioma, então em lojas multilíngues crie por store view.
• Merge. Quando você salva um grupo que compartilha um termo com um grupo existente, o Magento pergunta se quer juntá-los. Juntar cadeias de palavras pouco relacionadas num grupo enorme piora os resultados, porque cada palavra da cadeia passa a casar com todo o resto.
• Sem reindex. Sinônimos são aplicados quando a query é montada, não quando os produtos são indexados. As mudanças valem depois de limpar o cache das páginas de busca.

Os grupos ficam na tabela search_synonyms com as colunas de escopo, o que facilita exportar, revisar e fazer deploy entre ambientes com um data patch.

Sinônimo não é corretor ortográfico

É tentador adicionar todo erro de digitação como sinônimo. Para um punhado de erros muito comuns no nome de uma marca, tudo bem. Para typos em geral, o fuzzy matching do mecanismo de busca já resolve bastante, e centenas de grupos de typos ficam difíceis de manter. Olhe o relatório de zero resultados e corrija os dez principais em vez de tentar cobrir tudo.

Search terms: redirects e sugestões

Em Search Terms você pode editar uma consulta e definir uma Redirect URL. Clientes que buscam exatamente aquela consulta são enviados para a URL em vez da página de resultados. Isso é útil para consultas que na verdade são navegação, como o nome de uma marca que tem landing page própria, ou "devolução" apontando para a política de devolução.

A mesma tela tem o Display in Suggested Terms, que controla se a consulta é oferecida como sugestão. Tire das sugestões as consultas com typo ou sem resultado, para que o autocomplete não sugira buscas que falham.

Peso de busca dos atributos

Cada atributo de produto tem Use in Search e Search Weight em Storefront Properties. O Search Weight é um valor de 1 a 10 que dá mais força aos resultados naquele atributo. Por padrão, nome e SKU já têm peso maior que a descrição, por isso uma palavra no nome do produto costuma vencer a mesma palavra numa descrição longa.

Regras práticas que eu sigo:

• Só atributos que os clientes realmente digitam devem ser pesquisáveis. Códigos internos, cores já cobertas pelo nome e campos técnicos adicionam ruído e deixam o índice maior. Veja boas práticas de atributos de produto.
• Dê peso alto aos atributos de marca e linha de produto se os clientes buscam por marca.
• Mantenha o peso da descrição baixo. Descrições longas mencionam muitas palavras, e um peso alto traz produtos que só citam o termo de passagem.
• Mude um peso por vez e teste o mesmo conjunto de consultas antes e depois.

Mudar Use in Search ou Search Weight exige reindex do catalogsearch_fulltext, já que muda o que entra em cada documento de produto e como os campos recebem boost.

Stopwords

Stopwords são palavras removidas das consultas e do texto indexado, como "o" ou "e". O Magento traz listas de stopwords por locale como arquivos CSV no módulo Magento_Elasticsearch, associadas aos locales na configuração dele. O adapter do OpenSearch reaproveita a mesma estrutura.

Para alterá-las, adicione seu próprio arquivo e mapeamento num módulo customizado em vez de editar os arquivos do core. Depois rode um reindex completo, porque as stopwords fazem parte das configurações de análise do índice. Cuidado ao remover palavras que carregam sentido no seu catálogo. Uma loja cujas marcas ou nomes de produto são formados por palavras curtas comuns precisa checar como essas buscas se comportam com a lista padrão.

Tamanho mínimo da consulta e outras configurações

Em Stores, Configuration, Catalog, Catalog, Catalog Search, o Minimal Query Length evita buscas de uma e duas letras, que casam com a maior parte do catálogo. O Maximum Query Length protege contra textos muito longos colados na busca. O Autocomplete Limit define quantas sugestões aparecem. O Enable Search Suggestions mostra sugestões de "você quis dizer" quando uma busca retorna poucos resultados.

Teste a relevância no OpenSearch

Quando os resultados parecem errados, olhe como o texto é analisado. A API _analyze mostra os tokens que o OpenSearch produz para um campo, o que explica muitas surpresas, como palavras separadas em hífens ou com stemming diferente do esperado:

curl -s -X POST 'http://opensearch:9200/magento2_product_1/_analyze?pretty' \
  -H 'Content-Type: application/json' \
  -d '{"field": "name", "text": "T-Shirts for runners"}'

Use o store ID da store view que está testando e o seu prefixo de índice. Se os tokens da consulta e os tokens do nome do produto não se sobrepõem, nenhum peso ou sinônimo fará o produto casar. A configuração do próprio cluster está em configuração e ajuste do OpenSearch.

Mantenha uma lista curta de consultas importantes com os produtos que você espera no topo. Depois de toda mudança em sinônimos, pesos ou stopwords, passe pela lista no staging. Leva dez minutos e evita consertar uma consulta quebrando outras três.

Quando o core não basta

As ferramentas do core bastam para a maioria dos catálogos pequenos e médios. Lojas com catálogos grandes, muitos idiomas ou muita necessidade de merchandising costumam migrar para um serviço de busca dedicado. O Adobe Commerce tem o Live Search, um serviço de busca SaaS com ranking baseado em IA e regras de merchandising, disponível só para o Adobe Commerce. Em qualquer uma das edições existem serviços de busca de terceiros com módulos Magento próprios. Eles substituem a página de resultados, então avalie com as suas próprias consultas antes de trocar.

FAQ

Preciso de reindex depois de adicionar sinônimos de busca no Magento 2?

Não. Os sinônimos são aplicados quando a query é montada. Limpe o cache das páginas de resultado de busca e teste. Mudanças em search weight, atributos pesquisáveis ou stopwords exigem reindex.

Sinônimos do Magento podem ser de mão única?

Não com o recurso do core. Cada termo de um grupo casa com todos os outros. Para um comportamento de mão única você precisa de lógica de query customizada ou de um serviço de busca de terceiros.

Por que um produto não aparece quando busco pelo SKU?

Confira se o SKU é pesquisável, se o produto está visível na busca e atribuído ao website, e se o índice está atualizado. Depois use a API _analyze para ver como o SKU e a consulta são tokenizados.

O que o Search Weight faz num atributo?

Dá mais força aos resultados naquele atributo em relação aos outros, numa escala de 1 a 10. Um peso maior em nome ou marca coloca produtos que casam ali acima de produtos que casam só na descrição.

Atendo como freelancer em Magento e Adobe Commerce, incluindo relevância de busca e ajustes de catálogo. Se precisa de ajuda com isso, fale comigo.