Skip to content

Testes AB

AldemirLucas edited this page Oct 29, 2026 · 2 revisions

Testes A/B

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.

O hook useABTestVariant

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:

  1. Lê o cookie testId com js-cookie.
  2. Se o cookie não existe ou o valor não está em variants, sorteia com Math.random() e grava o cookie por expires dias (path /, domínio do host atual).
  3. 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 devolve null. A página é gerada com getStaticProps (ISR), então quem chama deve renderizar nada enquanto a variante for null. Isso evita diferença de hidratação, mas o bloco aparece só depois da montagem (pode haver um pequeno salto de layout).

Testes em uso

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)

service-highlight-ab

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 alternateTitle menor (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.

dataset-banner-ab

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.

Medição

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).

Criar um teste novo

  1. Escolha um testId único (vira o nome do cookie) e as variantes.
  2. Na página ou componente:
    const variant = useABTestVariant('meu-teste-ab', ['A', 'B'])
  3. Renderize por variante, sem nada enquanto for null:
    {variant === 'A' && <BlocoA />}
    {variant === 'B' && <BlocoB />}
  4. Coloque os textos nos três public/locales/*/<namespace>.json.
  5. Dispare um evento com a variante no clique (triggerGAEvent('meu_evento', variant)). Considere também um evento de exposição num useEffect quando variant deixa de ser null.
  6. Peça a quem administra o GTM para criar a tag/gatilho do novo evento; sem isso o push não chega ao GA.

Forçar uma variante localmente

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).

Encerrar um teste

  1. Escolha a variante vencedora com os dados do GA.
  2. Remova a chamada useABTestVariant(...) e renderize só a vencedora, direto.
  3. 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 o triggerGAEvent específico de A/B.
  4. Se nenhum teste usar mais o hook, apague hooks/useABTestVariant.js.
  5. O cookie antigo fica no navegador dos usuários até expirar. É inofensivo, não precisa limpar.

Clone this wiki locally