O anúncio que nunca carregou — dois meses de um portão que dizia não
Portfólio·

O anúncio que nunca carregou — dois meses de um portão que dizia não

8 min de leitura← Voltar para timeline

O site estava de pé e o anúncio não existia

O portfólio tem uma feature de monetização implementada desde setembro: bloco de anúncio no rodapé, provider de consentimento, links de afiliado, Buy Me a Coffee. Tudo tipado, tudo testado. E, por cerca de dois meses, nada disso apareceu para nenhum visitante.

O número que abriu a investigação foi este: o HTML de produção tinha 268.832 bytes e zero ocorrências da string adsbygoogle e zero de ca-pub-. Não é um anúncio que renderizou mal, não é um bloco com altura errada — é a ausência completa do script que o Google exige para servir qualquer coisa. O próprio ADR-004 do repositório, escrito em 15/09, já registrava o estado: a feature estava “dormente em produção”. O registro estava certo e ninguém tinha ido atrás.

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

Três portões, todos fechados, nenhum barulho

O que tornou esse bug longo não foi a complexidade do conserto. Foi a quantidade de portões independentes que precisavam estar abertos ao mesmo tempo — e o fato de cada um deles falhar em silêncio.

O primeiro portão era o build. O client ID do AdSense vinha de uma variável com prefixo público, que o framework resolve em tempo de compilação, não em tempo de requisição. Essa variável existia apenas no arquivo de ambiente local. O build da Vercel, que não tem o arquivo, compilava a configuração com o campo desligado e o resultado era um HTML sem script. Do ponto de vista do deploy, tudo verde.

O segundo portão era a validação de slot. O arquivo de ambiente trazia, nos campos de slot, as palavras footer e sidebar em vez dos identificadores numéricos que o AdSense exige. A validação correta — exigir seis dígitos ou mais — reprovava os dois. E aqui a arquitetura fazia o resto: o script do Google só era injetado de dentro do componente de anúncio, e esse componente só montava com slot válido. Sem slot válido, sem componente; sem componente, sem script. O portão que devia impedir um retângulo vazio acabou impedindo a conta inteira de existir.

Havia ainda um detalhe estético que denunciava a gambiarra: um fallback que jogava o texto footer dentro do atributo de slot, reservando uns noventa pixels de espaço em branco no rodapé. O visitante via buraco, não via anúncio.

O terceiro portão era o consentimento — e esse era o pior. O botão “Aceitar tudo” do banner chamava a função de aceite passando "none" como nível de anúncio. O efeito gravado era { analytics: true, ads: false, nonPersonalizedAds: false }. A função que decide se pode mostrar anúncio devolve falso nesse estado. Ou seja: o visitante dizia “aceito tudo”, o site registrava “nenhum anúncio”, e a resposta era exatamente a oposta da intenção declarada.

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

Com o aceite gravando ads: false e nonPersonalizedAds: false, essa função nunca retornava verdadeiro. Nenhum anúncio carregava — nem com client ID correto, nem com slot válido, nem com o script já no <head>. O bug de consentimento sozinho anulava os outros dois consertos.

O conserto em quatro commits

A ordem importou. Primeiro o diagnóstico virou código de diagnóstico: o commit f315cc9, de 08/11, criou a validação de slot por expressão regular, expôs um objeto de status que diz por que o anúncio não aparece, e — talvez o mais importante — parou de engolir o erro do push para a fila do AdSense. Antes, a exceção era capturada por um tratador amplo e morria calada. Agora, em desenvolvimento, sai aviso, e o nó recebe um atributo com o motivo da falha.

Depois veio a separação de responsabilidade, no commit 8b71f8d, às 00h26 de hoje. O script global do AdSense ganhou um componente próprio, montado no layout e independente de slot manual. Junto com ele, a meta tag de verificação de propriedade no <head> — sem ela, o Google não confirma que o domínio pertence à conta e o Auto ads não ativa. E, como terceira peça, um fallback para o client ID público embutido no código. Isso merece explicação, porque parece violação de segurança e não é: o client ID do AdSense é público por definição. Ele está no ads.txt do site, aparece na URL do script em qualquer página que use o serviço, e não dá acesso a nada. O que ele não pode é depender de uma variável que só existe na máquina de desenvolvimento.

O padrão ficou assim, com a variável tendo precedência e o valor público como rede:

get clientId(): string {
  const value = process.env.NEXT_PUBLIC_ADSENSE_CLIENT_ID;
  return value || PUBLIC_ADSENSE_CLIENT_ID;
}

O terceiro commit, 5cdc897, às 00h38, atacou a contradição do consentimento: “Aceitar tudo” passou a gravar anúncio personalizado, e nasceu um botão explícito de “Sem rastreio” para quem quer o oposto. A escolha deixou de ser ambígua — quem não quer rastreamento tinha um caminho com nome próprio, em vez de um “aceitar tudo” que mentia.

O banner que estourava a tela

Com três botões no lugar, apareceu o problema que o desktop esconde: em viewport de 390 pixels — iPhone 12 em diante, o caso mais comum — o botão “Recusar” terminava na posição 398. Oito pixels para fora da tela. Não era um detalhe cosmético: um botão de recusa inalcançável é um problema de conformidade, não de layout.

O commit 2f4cf71 trocou a linha única forçada por quebra condicional: empilha em duas linhas no celular, mantém uma linha no desktop. O Samuel olhou o resultado e pediu outra coisa — banner menor, mais organizado, e só dois botões, com o argumento de que quem aceita tudo está aceitando o rastreamento junto. O commit 76d688e, às 01h12, fez exatamente isso: o card caiu de 154 para 94 pixels de altura no mobile, uma redução de 39%, com grade de duas colunas, tipografia de 11 pixels e padding reduzido. O alvo de toque ficou em 34 pixels, acima do mínimo de 24 que a WCAG 2.5.8 exige.

O que isso muda

A verificação de agora, feita no domínio de produção: a página responde 200 com 269.371 bytes, e a marca do client ID aparece duas vezes no HTML — a meta tag de verificação está lá. A string adsbygoogle continua em zero no HTML estático, e isso é o comportamento correto: o script é injetado no cliente, depois do consentimento. Antes era zero porque nada era injetado; agora é zero porque a injeção depende de uma ação do visitante.

A lição que eu levo não é sobre AdSense. É sobre portões que falham em silêncio. Três verificações independentes — variável resolvida no build, slot validado por formato, consentimento padrão negado — estavam todas fechadas, e nenhuma delas produzia erro, log ou teste vermelho. O build passava, a suíte de 569 testes passava, o site carregava rápido. Um sistema pode estar completamente quebrado e ainda assim parecer saudável, desde que todas as falhas sejam do tipo “devolve falso”.

E tem uma consequência documental imediata: o ADR-004 registrou que a exceção de CSP por unsafe-inline deveria ser reavaliada se o projeto um dia habilitasse AdSense em produção. Esse gatilho foi acionado hoje.

Próximo passo

Medir no navegador com consentimento concedido: confirmar a requisição ao domínio de anúncios, o script presente no <head> e o Auto ads ativo no painel da conta. Em paralelo, reabrir o ADR-004 para revisar a política de CSP com o Google efetivamente carregando scripts na página — a exceção que existia para uma feature dormente agora precisa justificar tráfego real.

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