Skip to content

Eventos do GA

AldemirLucas edited this page Oct 29, 2026 · 2 revisions

Eventos do GA

Como o website envia eventos para o Google Analytics e quais eventos existem hoje. O código não fala com o GA direto: ele só empurra objetos para o window.dataLayer, e o Google Tag Manager decide o que vira evento no GA4. Os testes A/B usam os mesmos eventos e têm página própria em Testes A/B.

Como funciona

componente → triggerGAEvent / triggerGAEventWithData → window.dataLayer → GTM → GA4
  1. Um componente chama um helper de utils.js num clique, numa busca etc.
  2. O helper faz window.dataLayer.push({ event: '<nome>', ... }).
  3. O GTM escuta o dataLayer. Para cada evento existe (ou deveria existir) um acionador do tipo Evento personalizado e uma tag de evento do GA4 que repassa os parâmetros.
  4. No GA4, os parâmetros só aparecem nos relatórios depois de registrados como dimensões personalizadas.

Consequência: adicionar um push no código não basta. Sem a tag e o acionador no GTM, o evento fica no dataLayer e não chega ao GA. O inverso também vale: o container do GTM pode ter tags que não aparecem no código (page views, Hotjar, conversões). Esta página cobre o que o código envia; a configuração do container fica no GTM.

Onde o GTM é carregado

pages/_app.js decide pela variável de build NEXT_PUBLIC_BASE_URL_FRONTEND, não pelo domínio acessado:

Ambiente (NEXT_PUBLIC_BASE_URL_FRONTEND) GTM Meta Pixel
https://basedosdados.org (produção) Sim Sim
https://staging.basedosdados.org Sim Não
https://development.basedosdados.org Sim, no ambiente de preview do GTM Não
Local / qualquer outro valor Não Não

Produção é um build só para os três domínios (veja Internacionalização e domínios), então GTM e Meta Pixel rodam em basedosdados.org, data-basis.org e basedelosdatos.org. Para separar por idioma no GA, use o hostname da página.

Localmente o push acontece, mas nada consome o dataLayer.

Helpers

Todos em next/utils.js.

Helper O que envia
triggerGAEvent(event, value) { event, value }. value vira string (`${action}`).
triggerGAEventWithData(event, data) { event, ...data }. Use quando o evento tem mais de um parâmetro.
trackNavigateToChatbotLp({ value, placement, pagePath, isMobile }) navigating_to_chatbot_lp com o contexto do usuário (veja abaixo).
consumeChatbotTrialFollowup(router) chatbot_trial_followup quando a URL tem utm_campaign=chatbot_trial_followup; depois remove os utm_* da URL.

Contexto do usuário

Alguns eventos levam flags lidas do cookie userBD (getUserFromCookie()):

Parâmetro Significado
is_logged_in Há usuário logado
is_bd_pro / has_bd_pro Usuário tem assinatura BD Pro. É o mesmo dado com dois nomes: open_chatbot do menu usa is_bd_pro e o de PlansAndPayment.js usa has_bd_pro, então no GA viram duas dimensões
has_chatbot_subscription Usuário tem assinatura do chatbot
is_mobile Layout mobile
page_path Caminho da página onde o clique aconteceu

Nenhum evento envia nome, e-mail ou ID do usuário.

Eventos catalogados

value é o parâmetro enviado por triggerGAEvent. Nos eventos com triggerGAEventWithData, a coluna lista os parâmetros.

Navegação e menu

Evento Onde Parâmetros
navigating_to_data Hero da home (home/Hero.js, home/ContentPublicPurpose.js), menu, footer value: hero-home, menu, footer
navigating_to_services Hero da home, menu, footer value: hero-home, menu, footer
navigating_to_contact-consulting pages/services.js value: hero, menu, footer
navigating_to_chatbot_lp Menu, footer, banner da página de dataset value (menu, footer, dataset_banner), menu_placement, is_mobile, is_logged_in, is_bd_pro, page_path
open_chatbot Menu (usuário que já assina o chatbot) value: "menu", menu_placement, is_mobile, has_chatbot_subscription, is_logged_in, is_bd_pro, page_path

Valores de menu_placement em uso: top, desktop, desktop_header_right, desktop_solutions_dropdown, mobile_drawer, mobile_drawer_solutions, mobile_drawer_user, footer_products, dataset_page_banner.

Busca e temas

Evento Onde Parâmetros
search pages/search.js, a cada busca nova search_id (UUID), search_query, search_results_count, filters_applied, search_timestamp
browse_search_pages Paginação da busca search_id, search_query, filters_applied, page_number, page_view_timestamp
select_dataset Clique num resultado search_id, search_query, filters_applied, dataset_index, dataset_name, dataset_id, dataset_click_order, dataset_click_timestamp
theme_home Catálogo de temas da home (ThemeCatalog.js) value: slug do tema
theme_dataset Filtro de tema na busca value: slug do tema
theme Os dois acima (enviado junto) value: slug do tema

search_id liga busca, paginação e cliques. Ele fica em sessionStorage (search_analytics) junto com a ordem dos cliques (search_click_order).

Dataset e tabela

Evento Onde Parâmetros
category_click Abas de acesso da tabela (DataInformationQuery.js) value: SQL, Python, R ou o texto traduzido das abas "BigQuery e pacotes" / "Download"
generate_query_click Botão de gerar consulta value: SQL, Python ou R
download_table Download da tabela (DataInformationQuery.js) ou por colunas (TableColumns.js) gcp_path, file_size, dataset_id, dataset_name, table_id, table_name, column_download
table_notification_toggle Sino de notificação da tabela (TablePage.js) dataset_id, dataset_name, table_id, table_name, notification_status (enabled/disabled)
table_notification_redirect_bdpro CTA BD Pro na notificação value: "click"
table_coverage_redirect_bdpro CTA BD Pro na cobertura temporal (TemporalCoverageDisplay.js) value: "click"
button_banner_bdpro_lp Banner BD Pro na página de dataset value: "click"
button_service_highlight_ab Bloco de serviços (teste A/B) value: A ou B
tour_dataset Tour guiado (Tour.js) value: skip in step N ou tour conclusion

Preços e assinatura

Evento Onde Parâmetros
explore_features_card_price Card gratuito em /prices value: "click"
bd_pro_card_price Card BD Pro em /prices plan_interval (month/year), is_free_trial
bd_chatbot_card_price Card do chatbot em /prices e botão de assinar em /chatbot-lp plan_interval, is_free_trial, source: "chatbot_lp" (só na LP)
bd_empresas_card_price Card BD Empresas em /prices plan_interval
exchange_email_gcp Troca do e-mail do BigQuery value: section_bigquery (página do usuário) ou checkout_de_pagamento
open_chatbot Modal de pagamento concluído / seção de planos (PlansAndPayment.js) value (payment_success_modal ou user_plans_section), plan_interval, product_slug, has_chatbot_subscription, has_bd_pro, is_logged_in, chatbot_subscription_canceled, page_path
chatbot_trial_survey Pesquisa ao iniciar o trial do chatbot value: resposta escolhida ou skipped
chatbot_trial_followup Chegada pelo e-mail de follow-up do trial (ChatbotAccessGate.js) value: "email", utm_*, is_logged_in

Conta e contato

Evento Onde Parâmetros
user_register pages/user/register.js value: register_try, register_err, register_success
survey_login Pesquisa pós-cadastro (pages/user/survey.js) value: Respondeu ou Skipou
contact_consulting_form_submit Formulário de consultoria value: locale (pt, en, es)

Chatbot

Evento Onde Parâmetros
chatbot_ideas_open Abertura da central de ideias (OnboardingQuestions.js, ThreadHeader.js) ideas_source (thread_header, badge), ideas_badge (id do badge ou none)
chatbot_ideas_question_click Clique numa pergunta sugerida ideas_source, ideas_tab (themes/analyses), ideas_theme (ou none)

Outras ferramentas de rastreamento

  • Meta Pixel: carregado em pages/_app.js só no build de produção. Envia apenas PageView; nenhum evento customizado.
  • Hotjar: não é carregado pelo código. As páginas só têm âncoras de survey (#hotjarSurveyBlog, #hotjarSurveyGuiaDeUso); se o Hotjar roda, vem pelo GTM.
  • Cookies do GA/Meta: _ga, _ga_<id> e _fbp são criados pelos scripts dessas ferramentas, não pelo nosso código.

Adicionar um evento

  1. Escolha um nome em snake_case, no formato <objeto>_<ação> (ex.: table_notification_toggle). Confira se um evento existente não serve, mudando só o value.
  2. No código:
    import { triggerGAEvent, triggerGAEventWithData } from "../../utils"
    
    triggerGAEvent("meu_evento", "click")
    // ou, com mais parâmetros:
    triggerGAEventWithData("meu_evento", { source: "menu", is_mobile: isMobile })
    Chame dentro de handlers ou useEffect, nunca no render. Fora do navegador window não existe, então guarde com typeof window === "undefined" se o código puder rodar no servidor.
  3. Use valores estáveis e em inglês nos parâmetros, não textos traduzidos (t(...)), para o mesmo clique não virar três valores diferentes no GA.
  4. Não envie dados pessoais: nome, e-mail, telefone, ID de usuário, token. O GA proíbe PII e a política de privacidade só cobre dados de uso.
  5. Peça a quem administra o GTM para criar o acionador e a tag GA4 do evento, e registrar os parâmetros novos como dimensões personalizadas no GA4.
  6. Atualize esta página.

Testar

  • No navegador, em qualquer ambiente: depois do clique, rode window.dataLayer no console e confira o último objeto.
  • Em development: o GTM carrega no ambiente de preview. Abra o Tag Assistant do GTM apontando para development.basedosdados.org para ver quais tags dispararam.
  • No GA4: Admin → DebugView (com o Tag Assistant ativo) ou o relatório Tempo real.

Remover um evento

Apague a chamada no código e avise quem administra o GTM para pausar a tag, para o container não acumular tags mortas. Atualize esta página.

Clone this wiki locally