Como o rastreamento de pesquisa no site do GA4 registra o que os visitantes digitam

O que é a pesquisa no site do GA4?

O Google Analytics trata a pesquisa no site do GA4 pela opção Site search da medição aprimorada, que envia um evento view_search_results com um parâmetro search_term sempre que um visitante chega a uma página de resultados cuja URL traz um parâmetro de consulta de busca. A página do Google sobre a medição aprimorada diz que o evento dispara "each time a user is presented with a search results page, as indicated by the presence of a URL query parameter." Ative a opção, confirme que as suas URLs de busca usam um parâmetro que o GA4 reconhece e leia os termos na dimensão Search term.

A pesquisa no site é uma das sete opções da medição aprimorada, ao lado de rolagens, cliques de saída e downloads de arquivos, e não exige código quando a sua busca já coloca o termo na URL. Quando não coloca, você envia o evento por conta própria, como explicado mais abaixo.

Como o GA4 detecta uma pesquisa no site?

O GA4 detecta uma pesquisa no site procurando um parâmetro de consulta conhecido na URL da página e copiando o valor desse parâmetro para search_term. O Google lista os cinco parâmetros que verifica por padrão:

• q
• s
• search
• query
• keyword

Um visitante que busca "running shoes" e chega a /search?q=running+shoes envia view_search_results com search_term igual ao texto digitado. A busca do WordPress usa ?s=, que está na lista. Um site cuja página de resultados usa ?term= ou ?k= não envia nada até você adicionar esse parâmetro.

A página de ajuda do Google também cita um parâmetro extra: o evento "only sends the unique_search_term parameter when it has a value of 1 (i.e. when the string is unique to that session)." Essa marcação permite separar as primeiras buscas das repetições do mesmo termo em uma sessão.

Como ativar o rastreamento de pesquisa no site do GA4?

Você ativa o rastreamento de pesquisa no site do GA4 nas configurações de medição aprimorada do seu fluxo de dados da web, com a função de Editor ou superior. Os passos do Google:

1. Em Admin, em Data collection and modification, clique em Data streams.
2. Clique no nome do seu fluxo de dados da web.
3. Em Enhanced measurement, deslize a chave para ativar todas as opções.
4. Abra a opção Site search para editá-la e acessar as configurações avançadas.

Se você usa a tag do Google, o Google acrescenta que "you also need to make sure that each event is enabled for automatic event detection for your Google tag. By default, all event types are enabled." Confira os dois lugares quando a opção estiver ativada e nenhum evento view_search_results chegar. Depois de salvar, faça uma busca no seu site e acompanhe o evento no relatório Realtime.

Como adicionar seus próprios parâmetros de consulta de busca?

Você adiciona seus próprios parâmetros de consulta de busca nas configurações avançadas da opção Site search, e o GA4 oferece dois tipos. A página do Google diz "You can optionally configure this event to look for other URL query parameters", o que cobre o parâmetro que guarda o próprio termo. Ela também lista parâmetros opcionais chamados "q_", em que a chave "matches an additional query parameter you specify to be collected under advanced settings."

O segundo tipo é útil para filtros. Uma loja cuja URL de resultados é /search?term=jacket&category=women pode manter o termo em search_term e o filtro em q_category. A página do Google sobre a medição aprimorada não informa quantos parâmetros adicionais o campo aceita, então informe só os que você pretende usar em relatórios.

Preciso registrar search_term como dimensão personalizada?

Não, você não registra search_term como dimensão personalizada, porque o GA4 já o associa a uma dimensão predefinida. A página do Google sobre a medição aprimorada afirma "The search_term parameter populates the Search term dimension", e a referência de dimensões descreve Search term como "The term used to search your website or application." A página do Google sobre dimensões personalizadas avisa que registrar um parâmetro "that is already a predefined dimension" é "not a best practice", já que "it will use one of your custom dimension quota."

Os parâmetros q_ são diferentes. Eles são parâmetros de evento seus, então precisam de uma dimensão personalizada com escopo de evento antes que relatórios e explorações possam mostrá-los. Crie uma por parâmetro em Admin, em Data display, Custom definitions, usando o nome exato, como q_category. Escolha só os filtros sobre os quais você vai agir, e use o guia sobre como escolher dimensões a partir das decisões que elas embasam para decidir quais merecem uma vaga.

Onde ver os termos de pesquisa no GA4?

Você vê os termos de pesquisa do GA4 na dimensão Search term, e o jeito mais rápido de lê-la é uma exploração de forma livre. Monte assim:

1. Abra Explore e comece uma exploração de forma livre em branco.
2. Adicione as dimensões Search term e Event name, e as métricas Event count e Total users.
3. Arraste Search term para Rows e as duas métricas para Values.
4. Adicione um filtro em que Event name corresponda exatamente a view_search_results.

Ordene pela contagem de eventos para ver o que os visitantes mais procuram. Depois procure termos para os quais o seu site não tem página. Um termo que volta sempre é um conteúdo que você deveria escrever ou um produto que deveria ter em estoque. Os termos de pesquisa também combinam bem com o rastreamento de eventos na página de resultados, como um clique em um resultado, para você distinguir as buscas que encontraram algo das que terminaram em uma saída.

Como rastrear buscas quando o termo não está na URL?

Você rastreia buscas sem parâmetro na URL enviando o evento por conta própria, com o termo em search_term. Caixas de busca que enviam um formulário, carregam resultados com JavaScript ou usam um caminho como /search/shoes não dão nada para a medição aprimorada ler. A referência de eventos recomendados do Google define um evento search com um parâmetro obrigatório, search_term, e dá este exemplo:

gtag("event", "search", { search_term: "t-shirts" });

Dispare o evento a partir do código que executa a busca, no momento em que os resultados aparecem, com o texto que o visitante digitou. No Google Tag Manager, envie o mesmo nome de evento e o mesmo parâmetro a partir de uma tag de evento do GA4 acionada pelo seu código de busca. A dimensão Search term aceita os dois caminhos: o Google diz para preenchê-la "by sending the search_term parameter with the search or view_search_results event." Mantenha os dois separados nos seus filtros se usar ambos, ou cada busca conta duas vezes.

Para contar buscas como métrica de sucesso, marque o evento como evento principal. A diferença entre eventos principais e o antigo rótulo de conversões está em eventos principais vs conversões no GA4.

Os termos de pesquisa do GA4 podem conter dados pessoais ou sofrer thresholding?

Os termos de pesquisa do GA4 registram tudo o que os visitantes digitam, então contêm dados pessoais sempre que alguém digita um endereço de e-mail, um número de telefone ou um número de pedido na sua caixa de busca. O Google coloca a responsabilidade em você: "You're required to ensure that no personally identifiable information is collected." Se a sua busca aceita esse tipo de entrada, remova esses dados no seu próprio código antes que a tag leia a URL, ou envie um termo limpo com um evento manual.

Os limites de dados são a segunda restrição. A página do Google sobre limites de dados diz "If a report or exploration includes search query information, the row containing that data may be withheld if there aren't enough total users." Os termos raros são os que desaparecem, e o guia sobre o thresholding de dados do GA4 explica como identificar o indicador de qualidade dos dados e quais mudanças o Google diz que reduzem a retenção.

Como a Flowsery conta as pesquisas no site?

A Flowsery conta uma pesquisa no site como uma meta personalizada que você nomeia e envia com uma única chamada, como window.flowsery("search"), a sintaxe da documentação de metas personalizadas da Flowsery. A página de rastreamento de metas e eventos descreve eventos personalizados para "any user action", metas com taxas de conclusão ao longo do tempo e um feed de eventos em tempo real para "debug and validate your tracking instantly." Os funis da Flowsery permitem "select the pages or events that make up your conversion path", então um evento de busca pode ser uma etapa entre uma landing page e um cadastro. As páginas de produto da Flowsery não listam um relatório de termos de busca, mas uma meta pode levar o termo digitado como parâmetro personalizado, como window.flowsery("search", { term: "running shoes" }). A documentação permite no máximo 10 parâmetros personalizados por evento e valores de texto de no máximo 255 caracteres, e o card Goals mostra o detalhamento de cada valor de parâmetro e quantos visitantes corresponderam a ele. A regra de dados pessoais acima também vale aqui, então remova endereços de e-mail e números de telefone do termo antes de enviá-lo.

Perguntas frequentes

A pesquisa no site do GA4 vem ativada por padrão?

A página de ajuda do Google não informa um padrão para a opção Site search. Ela diz que você desliza a chave Enhanced measurement para ativar todas as opções e clica para editar cada uma. Abra o seu fluxo de dados da web para ver o estado atual.

Quais parâmetros de URL a pesquisa no site do GA4 reconhece?

Por padrão, o GA4 procura q, s, search, query e keyword. Você pode configurar o evento para procurar outros parâmetros de consulta de URL nas configurações avançadas da opção Site search. Qualquer parâmetro fora da lista não envia evento nenhum.

O que é o evento view_search_results no GA4?

É o evento que a medição aprimorada envia quando um visitante vê uma página de resultados de busca, indicada por um parâmetro de consulta de busca na URL. Ele leva o texto digitado em search_term. Ele também envia unique_search_term com valor 1 quando o termo é único naquela sessão.

Por que a minha dimensão Search term do GA4 está vazia?

A opção Site search está desligada, o evento está desativado para a detecção automática de eventos na sua tag do Google, ou a sua URL de busca usa um parâmetro que o GA4 não verifica. Caixas de busca que deixam o termo fora da URL também não enviam nada. Adicione o parâmetro nas configurações avançadas ou envie um evento search com search_term.

O que são os parâmetros q_ na pesquisa no site do GA4?

São os parâmetros de consulta adicionais que você lista nas configurações avançadas da opção Site search. O GA4 envia cada um como q_ mais o nome do parâmetro, como q_category. Registre cada um como uma dimensão personalizada com escopo de evento para usá-lo em relatórios.

Devo usar o evento search ou o view_search_results?

Use view_search_results quando a medição aprimorada consegue ler o termo da sua URL. Envie o evento recomendado search com search_term quando não consegue. Os dois preenchem a dimensão Search term, então evite enviar os dois para a mesma busca.

Quem pode ativar a pesquisa no site do GA4?

É preciso ter a função de Editor ou superior. Abra Admin, clique em Data streams, escolha seu fluxo de dados da web e edite a opção Site search em Enhanced measurement.

Como encontro os termos mais pesquisados no GA4?

Crie uma exploração de forma livre com as dimensões Search term e Event name e a métrica Event count. Coloque Search term em Rows, filtre Event name para corresponder exatamente a view_search_results e ordene por contagem de eventos. Um termo que volta sempre e não tem página correspondente mostra o que escrever ou colocar em estoque.

Por que alguns termos de pesquisa do GA4 faltam no meu relatório?

O Google retém uma linha que inclui informações de consulta de pesquisa quando não há usuários suficientes no total. Os termos raros somem primeiro. O indicador de qualidade dos dados avisa quando isso acontece.

A Flowsery mostra quais palavras os visitantes pesquisam?

As páginas de produto da Flowsery não listam um relatório de termos de pesquisa. Você pode enviar cada busca como uma meta personalizada com o termo como parâmetro, como window.flowsery("search", { term: "running shoes" }), e o card Goals mostra o detalhamento de cada termo e quantos visitantes corresponderam a ele. Depois, um funil mostra se esses visitantes convertem.