Repository navigation
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.
componente → triggerGAEvent / triggerGAEventWithData → window.dataLayer → GTM → GA4
- Um componente chama um helper de
utils.jsnum clique, numa busca etc. - O helper faz
window.dataLayer.push({ event: '<nome>', ... }). - 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. - 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.
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.
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. |
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.
value é o parâmetro enviado por triggerGAEvent. Nos eventos com triggerGAEventWithData, a coluna lista os parâmetros.
| 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.
| 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).
| 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
|
| 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
|
| 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) |
| 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) |
-
Meta Pixel: carregado em
pages/_app.jssó no build de produção. Envia apenasPageView; 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_fbpsão criados pelos scripts dessas ferramentas, não pelo nosso código.
- 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ó ovalue. - No código:
Chame dentro de handlers ou
import { triggerGAEvent, triggerGAEventWithData } from "../../utils" triggerGAEvent("meu_evento", "click") // ou, com mais parâmetros: triggerGAEventWithData("meu_evento", { source: "menu", is_mobile: isMobile })
useEffect, nunca no render. Fora do navegadorwindownão existe, então guarde comtypeof window === "undefined"se o código puder rodar no servidor. - 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. - 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.
- 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.
- Atualize esta página.
-
No navegador, em qualquer ambiente: depois do clique, rode
window.dataLayerno 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.orgpara ver quais tags dispararam. - No GA4: Admin → DebugView (com o Tag Assistant ativo) ou o relatório Tempo real.
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.