Guia de Implementação

A API da Busca Personalizada é composta por rotas, independentes uma das outras, que se completam para entregar todas as funcionalidades da solução. Dessa forma é possível priorizar a implementação delas na ordem em que faça mais sentido ao seu negócio.

1. Página de Resultados de Busca por Termos

/search

É por meio desta rota que entregaremos os produtos mais relevantes com base nos termos pesquisados.

Dentro do JSON retornado, poderão estar presentes os seguintes componentes e funcionalidades:

  • Listagem de Produto
  • Filtros relevantes
  • Status da Query
    • Correção de Termos
    • Aproximação de Termos
    • Busca sem Resultados
  • Quantidade de Produtos
  • Paginação
  • Ordenação
  • Redirecionamento
  • Sugestões de Termos
  • QuickFilters
  • Banners
Dica para Desenvolvedor: É necessário seguir à risca as regras de Coleta de Dados, pois sem eles a busca não terá aumento de performance orgânica, e não terão acesso aos dados de métrica de desempenho no Dashboard.

2. Autocomplete de Termos

/autocompletes

Esta rota vai fornecer em tempo real, os termos e os produtos mais relevantes conforme o usuário está ainda digitando no campo de Busca.

3. Top Buscas (Buscas Populares)

/autocompletes/popular

Assim que o usuário fizer o primeiro clique no campo de texto para pesquisar por algum produto, você poderá mostrar para ele quais são os termos mais buscados da semana. Esta rota irá retornar os 10 termos mais pesquisados da sua loja.

4. Autocomplete de Produtos

/autocompletes/products

Fornecerá os produtos mais relevantes para um conjunto de termos. Funciona como um preview de busca, para colocar dentro do elemento de autocomplete por exemplo.

5. Hotsites/Landing Pages de Busca

/hotsites

Tenha autonomia para criar e gerenciar a sua própria página de resultados. Muito utilizada como landing pages em períodos promocionais em que você precisa cadastrar uma listagem de produtos que deverão aparecer nela.

O retorno da API é igual ao retorno da rota /search, portanto o esforço de implementação é muito baixo, e o valor que agrega pode ser alto para o seu negócio. Interessante priorizar.

6. Navegação por Categorias e Filtros

/navigates

Obtenha uma lista de produtos já filtrados por categorias ou atributos de catálogo. Com isto você poderá substituir as páginas de categoria e subcategorias da sua plataforma e desfrutar de toda a inteligência de ordenação da Busca Personalizada.

O retorno da API é o mesmo do que o retorno da rota /search, ou seja, se você já concuiu a Busca por termos, o esforço de implementação da Navigates será muito baixo.

7. Páginas Populares

/pages

Conquiste mais tráfego orgânico para a sua loja. Por meio do Pages, você conseguirá gerar automaticamente uma núvem de palavras para o seu site, com termos que poderão ser indexadas nos buscadores, como o Google.

Consulte-nos para obter mais informações!