Colocar anúncios em um site parece simples, até a hora de descobrir que o Google reprova a maioria das aplicações por detalhes que ninguém te avisou. Foi com essa dor real que nasceu o Analisador Joinads, uma ferramenta web gratuita que audita qualquer site em tempo real e mostra, de forma objetiva, se ele está pronto para ser monetizado com o Google AdSense e o Google Ad Manager.
O que parece um simples verificador de URL esconde, por baixo, uma série de decisões de engenharia para lidar com o ambiente hostil e imprevisível da web aberta.
O Problema e a Visão do Produto
Quem trabalha com publishers sabe que a reprovação raramente vem com um motivo claro. Falta um arquivo ads.txt bem configurado, o site não tem política de privacidade, o conteúdo ainda é raso, ou algum requisito das políticas do Google não foi cumprido. O resultado é sempre o mesmo: a conta fica em análise eterna ou é recusada, e o dono do site perde tempo e receita tentando adivinhar o que está errado.
A visão do produto era acabar com essa adivinhação. Em vez de revisar dezenas de páginas de documentação, o usuário cola a URL e recebe um diagnóstico direto do que já está certo e do que ainda precisa de ajuste.
O que é o Analisador Joinads
O Analisador Joinads é uma ferramenta de auditoria focada em elegibilidade para monetização. Ele analisa um site e verifica, em tempo real, quais requisitos ele cumpre (ou reprova) para ficar apto a exibir anúncios do Google, seja via AdSense, seja via Google Ad Manager e redes de Ad Networks.
A proposta é reunir em um só lugar a checagem que normalmente exigiria abrir o código-fonte, procurar arquivos específicos e cruzar tudo com as exigências do Google. Tudo de forma visual, rápida e sem instalar nada.
Como Funciona
A ferramenta se divide em dois módulos que trabalham juntos.
1. Verificador de Status do Site
O usuário insere a URL e clica em Verificar. A aplicação consulta o site em tempo real e retorna o status dos principais pontos técnicos, identificando rapidamente o que está acessível e o que pode estar bloqueando a aprovação.
2. Checklist de Requisitos
O segundo módulo é um checklist interativo dos requisitos de monetização. Ele cobre critérios essenciais como a presença e a validade do ads.txt, segurança via HTTPS, páginas institucionais obrigatórias (política de privacidade, termos de uso, sobre e contato) e a maturidade do conteúdo. Ao final, é possível resetar a checagem ou copiar o resultado com um clique, facilitando compartilhar o diagnóstico com o time ou diretamente com o dono do site.
Arquitetura e Decisões Técnicas (A Stack)
Em vez de recorrer a um framework pesado, o projeto foi construído com as tecnologias nativas da web: HTML, CSS e JavaScript puro. A decisão priorizou leveza e velocidade, mantendo uma separação clara entre estrutura, estilo e comportamento.
- Estrutura e Interface (HTML + CSS): a interface escura e responsiva foi feita com HTML semântico e CSS puro, sem framework. O resultado é uma página leve, de carregamento quase instantâneo e com controle total sobre o layout do diagnóstico.
- Lógica (Vanilla JavaScript): toda a regra de negócio (consulta da URL, montagem do checklist, verificação dos requisitos e geração do relatório copiável) roda em JavaScript puro, sem dependências externas. A organização em funções pequenas e bem separadas mantém o código limpo e fácil de estender com novos requisitos.
- Análise dos Sites (API): para ler o conteúdo e o
ads.txtde sites de terceiros direto do navegador, o JavaScript consome uma API/proxy externa que contorna as restrições de CORS e devolve os dados para serem processados em tempo real. - Deploy (Vercel): por ser totalmente estático, o projeto roda na Vercel com deploy contínuo a cada push, entregue via CDN para carregamento rápido e disponibilidade global, sem nenhum custo de servidor.
Desafios de Engenharia no Mundo Real
Auditar sites de terceiros parece trivial até você precisar ler o conteúdo de um domínio que não é seu, dentro de um navegador que faz de tudo para impedir isso. Foi aqui que o projeto ganhou profundidade.
"A diferença entre um site monetizado e um site recusado quase sempre mora nos detalhes que ninguém audita."
1. O Fantasma do CORS
O navegador não permite que o JavaScript leia livremente o conteúdo de domínios de terceiros por causa das políticas de CORS (Cross-Origin Resource Sharing). Como a ferramenta roda inteira no front, sem servidor próprio, a solução foi rotear as requisições por uma API/proxy externa, que busca o HTML e o ads.txt do site alvo e devolve o conteúdo de uma forma que o JavaScript consegue ler e processar no próprio navegador.
2. A Web Aberta é Hostil
Cada site responde de um jeito. Alguns demoram, outros bloqueiam acessos automatizados, outros têm estruturas fora do padrão. A análise precisou ser resiliente a timeouts, redirecionamentos e respostas inesperadas, sem travar a experiência de quem está apenas esperando o resultado.
3. Caçando o ads.txt
O ads.txt é um dos itens que mais derrubam aprovações e fica em um caminho fixo (/ads.txt) na raiz do domínio. A ferramenta busca e interpreta esse arquivo diretamente, transformando uma checagem manual e chata em um item objetivo do checklist.
4. Velocidade como Requisito
De nada adianta um diagnóstico completo se ele demora. O foco foi manter a resposta rápida, devolvendo o status em poucos segundos, para que a auditoria seja algo que você roda no meio de uma conversa, e não uma tarefa à parte.
Por que Isso Importa
O Analisador Joinads não é um exercício acadêmico: ele nasceu da rotina real de Ad Operations. Dentro de uma Ad Network, auditar o site de um publisher antes de iniciar a monetização é um passo crítico, e fazer isso manualmente, site após site, consome horas. Automatizar esse diagnóstico significa aprovar publishers mais rápido, reduzir idas e vindas e proteger a receita dos dois lados.
Para donos de site e criadores de conteúdo, o ganho é igualmente direto: em vez de esperar a reprovação do Google para descobrir o problema, eles corrigem tudo antes de aplicar.
Conheça o Projeto em Produção
A ferramenta já está no ar e pode ser usada agora mesmo. Faça a auditoria do seu site e veja o diagnóstico em tempo real:
- 🚀 Acessar a Ferramenta: Analisador Joinads.
O Analisador Joinads é a prova de que unir conhecimento de Ad Operations e de engenharia de software gera ferramentas que resolvem problemas reais, transformando as exigências do Google em uma lista clara de ações.