Repository navigation
Testes AB
Como o website divide visitantes entre variantes e mede o resultado. O mecanismo é simples: um hook que sorteia a variante no navegador e grava em cookie, e eventos enviados ao dataLayer do Google Tag Manager. Não há ferramenta de experimentos (Optimizely, GrowthBook etc.) nem análise no código: a comparação entre variantes é feita no GTM/GA.
hooks/useABTestVariant.js (veja Estrutura do front-end):
const variant = useABTestVariant(testId, variants, expires)| Parâmetro | Padrão | O que é |
|---|---|---|
testId |
'default-abtest' |
Nome do cookie que guarda a variante |
variants |
['A', 'B'] |
Lista de variantes possíveis |
expires |
365 |
Validade do cookie, em dias |
Funcionamento:
- Lê o cookie
testIdcomjs-cookie. - Se o cookie não existe ou o valor não está em
variants, sorteia comMath.random()e grava o cookie porexpiresdias (path/, domínio do host atual). - Devolve a variante.
-
Pesos: o sorteio é uniforme entre os itens de
variants. Não há parâmetro de peso. Para um 2:1, repita o item (['A', 'A', 'B']). -
Persistência: só cookie. Não usa
localStorage. O usuário vê sempre a mesma variante até o cookie expirar ou ser apagado. -
SSR/hidratação: o sorteio roda num
useEffect, então no servidor e no primeiro render do cliente o hook devolvenull. A página é gerada comgetStaticProps(ISR), então quem chama deve renderizar nada enquanto a variante fornull. Isso evita diferença de hidratação, mas o bloco aparece só depois da montagem (pode haver um pequeno salto de layout).
Os dois estão em pages/dataset/[dataset].js. É o único lugar que usa o hook.
| Cookie | Variantes | Validade | O que muda |
|---|---|---|---|
service-highlight-ab |
A, B
|
365 dias | Texto do bloco de serviços de consultoria (ServiceHighlightABTest) |
dataset-banner-ab |
bdpro, chatbot
|
1 dia | Banner de assinatura: BD Pro ou chatbot (Banner) |
components/molecules/ServiceHighlightABTest.js recebe as props de abTestContent[abVariant], definido na própria página:
-
A: título, descrição e botão (
abTest.aTitle,abTest.aDescription,abTest.aButton). -
B: só um
alternateTitlemenor (abTest.bTitle) e o botão (abTest.bButton).
Os textos ficam em public/locales/{pt,en,es}/dataset.json, chave abTest. As duas variantes levam para /services.
O bloco só aparece quando isBasedosdadosDomain() é verdadeiro, não há banner de assinatura e a variante já foi sorteada. Veja Internacionalização e domínios.
Só vale quando o dataset tem tabelas pagas (cobertura closed) e o usuário não é assinante BD Pro (showSubscriptionBanner). A variante passa por effectiveBannerVariant: se saiu chatbot mas o usuário já assina o chatbot, mostra bdpro.
Os dois testes são mutuamente exclusivos na página: com banner de assinatura, o bloco de serviços não aparece.
Os eventos vão para window.dataLayer (helpers em utils.js). O GTM é carregado em pages/_app.js nos builds de produção (os três domínios), staging. e development. (este com o ambiente de preview do GTM). Localmente o push acontece, mas nada consome. O fluxo completo e o catálogo de todos os eventos estão em Eventos do GA. Não há gtag() direto nem Hotjar ligado a A/B no código; o Hotjar aparece só como âncoras de survey (hotjarSurveyGuiaDeUso, hotjarSurveyBlog).
| Teste | Gatilho | Evento (event) |
Dados |
|---|---|---|---|
service-highlight-ab |
Clique no botão | button_service_highlight_ab |
value: "A" ou "B"
|
dataset-banner-ab (bdpro) |
Clique no botão | button_banner_bdpro_lp |
value: "click"
|
dataset-banner-ab (chatbot) |
Clique no botão | navigating_to_chatbot_lp |
value: "dataset_banner", menu_placement: "dataset_page_banner", is_mobile, is_logged_in, is_bd_pro, page_path
|
Não há evento de exposição (impressão). Só o clique é registrado, então a taxa de conversão por variante depende de cruzar com page views no GA, e a divisão real é desconhecida (ex.: o bloco de serviços não aparece fora de basedosdados.org, mas o cookie é sorteado mesmo assim).
- Escolha um
testIdúnico (vira o nome do cookie) e as variantes. - Na página ou componente:
const variant = useABTestVariant('meu-teste-ab', ['A', 'B'])
- Renderize por variante, sem nada enquanto for
null:{variant === 'A' && <BlocoA />} {variant === 'B' && <BlocoB />}
- Coloque os textos nos três
public/locales/*/<namespace>.json. - Dispare um evento com a variante no clique (
triggerGAEvent('meu_evento', variant)). Considere também um evento de exposição numuseEffectquandovariantdeixa de sernull. - Peça a quem administra o GTM para criar a tag/gatilho do novo evento; sem isso o push não chega ao GA.
Não há query string, flag ou variável de ambiente para forçar variante. Edite o cookie no navegador (DevTools → Application → Cookies) ou pelo console e recarregue:
document.cookie = 'service-highlight-ab=B; path=/'
document.cookie = 'dataset-banner-ab=chatbot; path=/'Para sortear de novo, apague o cookie. Um valor fora de variants também força novo sorteio. Para ver o bloco de serviços em npm run dev, rode em localhost com NEXT_PUBLIC_DOMAIN=basedosdados.org (ou sem essa variável, o domínio vira localhost e o bloco some).
- Escolha a variante vencedora com os dados do GA.
- Remova a chamada
useABTestVariant(...)e renderize só a vencedora, direto. - Remova o conteúdo e as chaves de i18n da perdedora. Se o componente era só do teste (como
ServiceHighlightABTest), considere renomeá-lo e tirar otriggerGAEventespecífico de A/B. - Se nenhum teste usar mais o hook, apague
hooks/useABTestVariant.js. - O cookie antigo fica no navegador dos usuários até expirar. É inofensivo, não precisa limpar.