O botão que dizia sim e gravava não — o consentimento que bloqueava o próprio anúncio
Portfólio·

O botão que dizia sim e gravava não — o consentimento que bloqueava o próprio anúncio

5 min de leitura← Voltar para timeline

O consentimento que negava o que o usuário acabou de consentir

Um banner de cookies tem uma responsabilidade pequena e bem definida: perguntar uma coisa e registrar a resposta. O do Portfólio fazia as duas coisas — só que a resposta gravada era o oposto da pergunta.

Quem clicava em “Aceitar tudo” autorizava analytics e anúncios. O handler chamava acceptWithAds("none"). O objeto persistido saía com ads: false e nonPersonalizedAds: false. A partir daí, canShowAds() devolvia false para aquele visitante, e o componente de monetização simplesmente não montava o slot. Nenhum anúncio, nunca, para ninguém que tivesse dito sim.

As ferramentas que uso neste projeto ficam na loja de skills — a primeira é grátis.

O sintoma que apareceu primeiro não foi esse. Foi “o site não tem anúncio”. O AdSense estava configurado, o script era injetado, o slot existia no JSX. O HTML de produção tinha o bloco do anúncio. E nada era servido, porque o portão de consentimento estava fechado — por dentro.

O caminho que o consentimento percorria

O fluxo tem duas camadas. A primeira é o banner, que guarda accepted ou declined e o nível de anúncio escolhido. A segunda é a monetização, que lê um objeto separado do localStorage e decide se pode renderizar.

A ponte entre as duas é este trecho:

export function canShowAds(consent: MonetizationConsent | null): boolean {
  if (!consent) return false;
  return consent.nonPersonalizedAds || (consent.analytics && consent.ads);
}

Lendo a função, a regra é clara: sem consentimento, nada. Com consentimento não personalizado, pode. Com analítico mais anúncio, pode. O bug não estava na regra — estava em quem a alimentava.

O handler montava o objeto assim:

const mcConsent = {
  analytics: true,
  ads: adsLevel === "personalized",
  nonPersonalizedAds: adsLevel === "non-personalized" || adsLevel === "personalized",
};

Com adsLevel = "none", os dois campos de anúncio caem para false. A regra funcionou exatamente como devia; o defeito era o argumento.

Três commits, e o terceiro é o mais interessante

O primeiro, 5cdc897, corrigiu a chamada do botão principal para acceptWithAds("personalized") e acrescentou um terceiro botão, “Sem rastreio”, apontando para acceptWithAds("non-personalized"). A ideia era oferecer a escolha intermediária em vez de só dois extremos. Provas do commit: tsc sem erro, 569 de 569 testes passando, build limpo.

O segundo, 2f4cf71, foi consequência direta do primeiro: três botões não cabiam na largura de um telefone. O card estourava o viewport, e o banner — que é a primeira coisa que qualquer visitante vê — quebrava justamente no aparelho onde a maioria entra.

O terceiro, 76d688e, no mesmo dia, desfez parte do primeiro. O botão “Sem rastreio” saiu, o banner voltou a dois botões, e o card no mobile foi de 154 para 94 pixels de altura, queda de 39%. A tipografia caiu de 12 para 11 pixels no mobile e a altura de toque ficou em 34 pixels — acima do mínimo de 24 que a WCAG 2.5.8 exige para alvo de ponteiro. Ou seja: encolheu o visual e manteve a área clicável.

Dois dias depois veio cab278d, que não tocou em lógica nenhuma. Só trocou o rótulo. “Aceitar tudo” virou “Aceitar”, em português e em inglês, porque “tudo” prometia um escopo que o banner não tinha: ele nunca pediu consentimento para anúncio personalizado de terceiros, apenas para analytics e para o nível de anúncio escolhido. O rótulo era a última mentira que sobrou depois que o bug foi embora.

O que isso ensina sobre consentimento

O erro não foi de digitação. Foi de modelagem: existiam duas representações do mesmo consentimento, escritas em momentos diferentes, com vocabulários diferentes. Uma usava "accepted" mais um nível; a outra usava três booleanos. Enquanto houver duas fontes de verdade para a mesma decisão, uma delas vai divergir — e a divergência aparece como sintoma longe do defeito, no caso, “o anúncio não carrega”.

O segundo aprendizado é sobre o que os testes cobriam. Eram 569 verificações, todas verdes, no commit que introduziu o bug. Nenhuma delas afirmava o que o objeto de monetização deveria conter depois de um clique em “Aceitar tudo”. Testavam que o banner sumia, que o localStorage recebia accepted, que o componente desmontava — comportamento de tela, não conteúdo de decisão. Um teste de três linhas sobre o objeto persistido teria pegado o problema antes do deploy.

O terceiro é de produto: reduzir escopo é uma forma de consertar. O botão do meio parecia mais honesto e custava 60 pixels de altura no mobile. Foi removido, e a honestidade migrou para o texto do botão principal. Menos opção, promessa mais precisa.

Próximo passo

O consentimento agora tem um único caminho de escrita e um teste que olha o conteúdo persistido, não só a tela. O que falta é a revisão do texto do banner no idioma inglês — o rótulo mudou, mas a frase de apoio ainda descreve “analytics” sem dizer o que acontece com o nível de anúncio escolhido. É a última aresta entre o que o banner diz e o que o código grava.

Leia também

Mesmo projeto, mesma trilha — as histórias se conectam.

Próximo passo

Se isto te serviu, tem mais: escrevo sobre o mesmo assunto nos outros projetos, e a loja tem as ferramentas que eu uso aqui.

Sem spam, descadastro de um clique. Também estou aqui: Loja de skills · Portfólio