Os eventos no seu GTM/GA4
Espelhar a atividade da pesquisa para o analytics da própria loja, com a tabela dos eventos e o container pronto a importar.
A partir do plano Pro, o painel de pesquisa pode espelhar a atividade da pesquisa para o analytics da própria loja. Liga-se em dois sítios, e são precisos os dois: o plano com a funcionalidade, e o interruptor "Enviar eventos para o analytics da loja (GTM / GA4)" na ficha da loja. Desligado qualquer um deles, o dataLayer da loja fica exatamente como estava.
Cada evento é entregue duas vezes à própria página, como CustomEvent do browser (buskara:search) e como push para o dataLayer (buskara_search), e nada sai da página por si: este caminho não escreve cookies nem carrega scripts. Quem decide o que segue para o GA4, e com que consentimento, é o seu Tag Manager.
Os eventos
| Evento | Quando dispara | Parâmetros |
|---|---|---|
buskara_open |
o painel de pesquisa abre | nenhum |
buskara_search |
uma pesquisa assenta (não a cada tecla) | search_term, results, search_id |
buskara_result_click |
clique num resultado | item_id, item_name, price, brand, index, search_term, search_id |
buskara_add_to_cart |
uma adição ao carrinho numa sessão que pesquisou: o botão da pesquisa, o assistente, ou o botão da própria loja depois de uma pesquisa | item_id, item_name, price, brand, quantity, search_term, search_id |
buskara_similar_open |
o painel de semelhantes abre | item_id, item_name, search_term, search_id |
buskara_quiz_* |
cada passo do assistente (start, answer, back, product_click, handoff, chat_message, checkout, …) |
type, slug, step + extras do passo |
Sobre o buskara_search: o painel de pesquisa espera que a escrita assente antes de emitir. Escrever "auscultadores" produz uma dúzia de pesquisas intermédias e só a última é a que a pessoa quis; o GA não tem forma de retratar um evento já enviado.
Ligar em três passos
- Descarregue o container GTM pronto no painel e importe-o no Tag Manager: traz as variáveis, os triggers e as tags GA4 já montados. Se preferir, segue o passo a passo aqui: A pesquisa da loja no Google Analytics.
- Abra a variável "Buskara - GA4 Measurement ID" e troque o placeholder pelo seu Measurement ID (GA4: Admin → Data Streams).
- Em Preview, pesquisa na loja e confirma os eventos a chegar; depois Submit.
Sem Tag Manager, os CustomEvent servem o mesmo propósito com poucas linhas:
document.addEventListener('buskara:search', function (e) {
gtag('event', 'buskara_search', e.detail);
});
Três notas importantes
- O zero é um valor. Um relatório de
buskara_searchcomresults = 0é a lista do que os visitantes procuram e não encontram. Alimenta decisões de compra, sinónimos e regras. search_idcruza os dois mundos. É o mesmo identificador que o painel usa, o que permite confrontar os números do GA com os do painel.- O consentimento é seu. As tags importadas vêm sem estado de consentimento definido; o gating faz-se nas regras do seu próprio container, como com qualquer outra tag.
E o Microsoft Clarity
Se a loja já usa o Microsoft Clarity, há um segundo interruptor na ficha da loja, "Enviar eventos para o Microsoft Clarity", com funcionalidade de plano própria (também a partir do Pro).
Com ele ligado, o painel de pesquisa entrega os mesmos eventos buskara_* ao Clarity que encontrar na página, e marca cada sessão com duas tags, buskara_search_term e buskara_item_name, que é o que lá dentro serve para filtrar gravações e mapas de calor pelo que as pessoas pesquisaram. Ver meia dúzia de gravações de sessões que pesquisaram um termo e saíram sem clicar vale por muitos relatórios.
Duas notas: o Clarity não recebe parâmetros nos eventos (é da ferramenta, não nosso), daí as tags; e o painel de pesquisa nunca carrega o script do Clarity, portanto sem ele na página o interruptor não faz nada.
Os dois interruptores são independentes: pode espelhar só para o GTM, só para o Clarity, ou para os dois.