Pular para o conteúdo principal
Zenovaydocs
5 min de leitura

Busca no site

Veja exatamente o que seus visitantes buscam no seu próprio site, para encontrar lacunas de conteúdo e as consultas que não retornam nada.

Visão geral

A Busca no site mostra as buscas internas que os visitantes fazem no seu site — não o que eles digitaram no Google. Os dados são exibidos no seu painel em app → abra seu site → Analytics → painel "Busca no site".

O painel é uma tabela ordenável das suas principais consultas com:

  • Buscas — quantas vezes a consulta foi feita
  • % das buscas — a parcela da consulta em relação a todas as buscas do período
  • Sem resultados — quantas dessas buscas não retornaram nada

Você também tem um filtro "Apenas sem resultados" para isolar as consultas que não encontraram nada, e um filtro por URL de página para restringir a tabela às buscas feitas a partir de uma página específica.

A Busca no site é gratuita em todos os planos.

Opção A — Detecção automática por URL (sem código)

Se a sua página de resultados de busca coloca a consulta em um parâmetro de URL, o Zenovay a captura automaticamente. Nenhuma alteração de código é necessária — assim que o script de rastreamento do Zenovay estiver instalado, ele simplesmente funciona.

O Zenovay lê a consulta da query string da URL da página, verificando estes parâmetros nesta ordem de prioridade exata:

  1. ?q=
  2. ?query=
  3. ?search=
  4. ?s= (este é o parâmetro de busca padrão do WordPress)

O primeiro parâmetro não vazio vence, e o valor capturado é limitado a 256 caracteres.

Exemplos de URLs de resultados de busca capturadas automaticamenteTEXT
https://example.com/search?q=blue+widgets
https://example.com/results?query=annual+report
https://example.com/?s=contact+form         (WordPress)
https://shop.example.com/search?search=running+shoes

Assim que um visitante chega a qualquer uma dessas URLs com o tracker do Zenovay instalado, o termo de busca é registrado e aparece no painel "Busca no site" — sem configuração adicional.

Sites WordPress funcionam imediatamente: o núcleo do WordPress usa ?s= para sua busca, que o Zenovay detecta automaticamente, sem plugin ou alteração de código.

Opção B — Rastreamento manual (SPA / busca JS sem mudança de URL)

Caixas de busca instantânea ou AJAX frequentemente exibem resultados sem mudar a URL da página. Nesse caso, a detecção automática não tem nada para ler, então chame você mesmo a API pública do tracker quando uma busca for confirmada:

Acompanhar uma busca no siteJavaScript
zenovay.track('search', { query: 'user query', results_count: 12 });

Chame isso quando o visitante enviar ou confirmar uma busca — por exemplo, no manipulador de envio do seu formulário de busca, ou logo após os resultados serem exibidos:

  • query — o texto bruto que o visitante buscou.
  • results_count — o número de resultados exibidos para essa consulta.

Fornecer results_count alimenta o insight de buscas sem resultados — defina como 0 quando nada corresponder. A lista de consultas que não retornam nada é o sinal de SEO e de lacuna de conteúdo mais valioso que a Busca no site oferece, então inclua results_count sempre que puder.

Exemplo em React

Manipulador onSubmit do ReactJavaScript
function SearchBox() {
const [term, setTerm] = useState('');

const handleSubmit = async (e) => {
  e.preventDefault();
  const results = await searchApi(term);

  // Use the global zenovay object from the tracking script
  zenovay.track('search', {
    query: term,
    results_count: results.length, // 0 when nothing matched
  });

  renderResults(results);
};

return (
  <form onSubmit={handleSubmit}>
    <input value={term} onChange={(e) => setTerm(e.target.value)} />
    <button type="submit">Search</button>
  </form>
);
}

Visualizar os dados

Para ver os dados da sua busca no site, abra o site no aplicativo e vá até a aba Analytics e depois o painel Busca no site.

A tabela mostra suas 200 principais consultas por volume no período selecionado, com estas colunas:

ColunaSignificado
BuscasNúmero de vezes que a consulta foi feita no período
% das buscasA parcela da consulta em relação a todas as buscas do período
Sem resultadosQuantas dessas buscas não retornaram nada

A caixa "Localizar consulta" pesquisa em todo o seu histórico de buscas do período selecionado (no servidor) — não apenas nas linhas exibidas — de modo que uma consulta raramente usada que não esteja entre as 200 principais por volume também é encontrada quando você a digita.

Outros controles do painel:

  • Colunas ordenáveis — clique no cabeçalho de uma coluna para ordenar a tabela por essa coluna.
  • Alternância "Apenas sem resultados" — mostra apenas as consultas que não retornaram nada, para agir rápido sobre as lacunas de conteúdo.
  • Filtro por URL de página — restringe a tabela às buscas feitas a partir de uma página específica.

Privacidade

Visitantes que enviam um sinal de Global Privacy Control ou Do Not Track não são rastreados, portanto suas buscas não aparecerão no painel "Busca no site" — isso é intencional.

Esta página foi útil?