Busca de produtos no site

A busca de produtos é a caixa de busca do site com sugestões durante a digitação e uma página de resultados que o OneTrace.ru preenche com os produtos do seu catálogo. A busca entende erros de digitação, variações das palavras e consultas digitadas no layout de teclado errado, e ordena os primeiros resultados pelos interesses do visitante: o que ele viu e comprou.

Para funcionar, são necessários o rastreador instalado (Conexão do site) e o catálogo de produtos (Recomendações e catálogo de produtos). A busca não está incluída em todos os planos: se o seu não tiver, o bloco de código não aparece na aba de instalação, e as requisições de busca recebem o erro “recurso indisponível”.

Como os produtos são encontrados

• As palavras da consulta são buscadas no nome, na marca, nas categorias e nas características do produto; o SKU, por correspondência exata.
• As variações das palavras nos idiomas do projeto são consideradas: “куртки” encontra “Куртка зимняя”. Os idiomas são definidos nas configurações do projeto; veja Configurações do projeto, plano e auditoria.
• Erros de digitação são corrigidos: “крутка” encontra “куртку”, e “dres” encontra “dress”.
• Uma consulta no layout de teclado errado também funciona: “ghbdtn” é buscado como “привет”.
• Se nada for encontrado com todas as palavras, a busca mostra produtos com pelo menos uma delas.
• Produtos populares e em estoque ficam mais acima. A popularidade vem das recomendações e é atualizada uma vez por dia.
• Os primeiros resultados são reordenados pelos interesses do visitante: sobem os produtos das categorias e marcas que ele viu e comprou.
• Medidas e parâmetros na consulta, como “205/55 r16”, “5x112” ou “inverno”, viram filtros se existirem no setor da loja.

Produtos novos e alterados do catálogo entram na busca em até um minuto após o carregamento do feed ou uma requisição à API.

Caixa de busca

Adicione o atributo data-cdp-search ao campo de busca do seu site:

<form action="/search">
  <input name="q" data-cdp-search data-category-url="/catalog/{id}">
</form>

Durante a digitação, aparecem sugestões abaixo do campo: buscas populares do site, categorias correspondentes e produtos com imagem e preço. Dá para navegar por elas com as setas; Enter abre a linha selecionada e Esc fecha as sugestões. Enter sem linha selecionada envia o formulário do site normalmente.

As sugestões usam a fonte do site e não têm textos de interface, por isso servem para um site em qualquer idioma.

Página de resultados

Os plugins prontos para lojas virtuais inserem sozinhos os resultados na página de busca da loja. No seu próprio site, obtenha os produtos pelo rastreador:

window.addEventListener('load', async () => {
  const q = new URLSearchParams(location.search).get('q');
  const result = await cdp.search(q, { perPage: 24 });
  // result.items — produtos, result.total — quantos foram encontrados, result.facets — categorias, marcas, preços e características para os filtros
});

Parâmetros: category, brand, priceMin, priceMax, sort (relevance, popular, price_asc, price_desc), page, perPage, attributes. Ao clicar em um produto, chame cdp.searchResultClicked(produto).

Filtros de características. result.facets.attributes traz as características do setor da loja com rótulos no idioma do visitante e o número de produtos de cada valor, por exemplo “Aro, polegadas”: 16, 17, 18. Passe os valores escolhidos em attributes: cdp.search(q, { attributes: { rim_diameter: [17, 18], season: 'winter' } }). Vários valores da mesma característica são combinados com “ou”, e características diferentes, com “e”. result.filters traz as medidas e os parâmetros reconhecidos no texto da consulta: mostre-os ao visitante para que ele entenda por que os resultados foram filtrados. É necessário o rastreador 1.15.0.

Se a busca tiver uma regra de redirecionamento (veja Regras de busca), result.redirect traz o endereço da página: abra-a no lugar dos resultados.

Os servidores podem fazer as mesmas requisições com uma chave de gravação: https://cdp.onetrace.ru/api/v1/search e https://cdp.onetrace.ru/api/v1/search/suggest. A lista completa de parâmetros está na referência da API: https://cdp.onetrace.ru/api/v1/openapi.json.

Relatório de buscas

A aba Busca da seção “Site” mostra o que os visitantes procuram no seu site em 7, 30 ou 90 dias:

• Buscas e visitantes — quantas vezes buscaram e quantas pessoas diferentes.
• Sem resultados — a parcela de buscas que não encontraram nada.
• CTR — a parcela de visitantes que clicaram em um produto nos resultados da sua busca.
• Compras e receita — um produto clicado nos resultados e comprado pelo mesmo cliente em até 7 dias. A receita usa o preço do produto no catálogo. Aparecem se um evento de compra estiver definido nas configurações de recomendações, veja Recomendações e catálogo de produtos.

Tabelas abaixo do gráfico:

As buscas são comparadas sem diferenciar maiúsculas e espaços extras. Em uma linha da tabela você pode adicionar na hora um sinônimo ou uma regra para a busca.

Sinônimos

Sinônimos são palavras e frases buscadas juntas: uma busca com qualquer palavra do grupo também encontra produtos pelas outras. Por exemplo, com o grupo “tênis, sneakers, calçado esportivo”, a busca “sneakers brancos” também encontra tênis brancos.

• Grupo nos dois sentidos — cada palavra é buscada como as outras.
• Grupo em um sentido — só a primeira palavra é buscada como as outras: “celular → smartphone” encontra smartphones na busca por “celular”, mas “smartphone” não é buscado como “celular”.

Uma palavra ou frase do grupo só é substituída na busca quando aparece inteira. Os sinônimos valem logo após salvar, nos resultados e nas sugestões. Um projeto pode ter até 500 grupos, e um grupo até 20 palavras.

Regras de busca

Uma regra vale quando um visitante busca exatamente este termo (sem diferenciar maiúsculas, espaços extras e pontuação nas pontas) e executa uma ou as duas ações:

• Produtos fixados — até 24 produtos, na ordem definida, ficam no topo dos resultados mesmo que a busca não os encontre. Os demais resultados vêm depois, sem repetições. A fixação vale na ordenação por relevância e sem filtros; produtos fora de estoque não aparecem.
• Redirecionamento — no lugar dos resultados abre uma página do seu site, por exemplo “entrega” → a página de condições de entrega.

Os redirecionamentos são seguidos pela caixa de busca do rastreador (Enter em uma busca com regra), por cdp.search() na sua própria página de resultados (campo redirect) e pelos plugins do WooCommerce e do Magento 2. Um projeto pode ter até 1000 regras.

Estatísticas

O rastreador registra dois eventos:

As buscas populares das sugestões são formadas a partir dos eventos search dos últimos 30 dias. Os eventos aparecem no cartão do perfil do cliente e ficam disponíveis nos segmentos, por exemplo “buscou, mas não comprou”; veja Segmentos.