KappS Base de conhecimento · Blog

app-ads.txt do AdMob em 2026: o checklist de verificação

Blog Checklist

O app-ads.txt é um pequeno arquivo de texto simples que decide se as plataformas de anúncios aceitam a resposta a uma única pergunta: quem está autorizado a vender o inventário de anúncios do seu app? É o equivalente nas lojas de apps do ads.txt da web, e o AdMob — junto com a maioria das grandes redes de anúncios — usa esse arquivo para vincular um app publicado à conta de publisher que realmente é dona do inventário. Publicar o arquivo leva dez minutos. Conseguir que ele seja verificado é onde a maioria dos desenvolvedores trava, porque a falha é silenciosa: nenhum erro, nenhum e-mail, apenas um app que nunca recebe o status de verificado que o arquivo deveria ter conquistado.

Este checklist segue a ordem em que o trabalho realmente acontece, usando as etapas publicadas na própria Ajuda do AdMob do Google: criar um site do desenvolvedor, vinculá-lo à ficha do app na loja, publicar o app-ads.txt na raiz do domínio, confirmar que a URL resolve no navegador, deixar o rastreador do AdMob encontrá-la, ler o status de verificação e manter o arquivo atualizado. A regra por trás de tudo isso: o domínio, a ficha e o ID do publisher precisam descrever o mesmo publisher real.


1. O que o app-ads.txt realmente é

O arquivo é definido pelo IAB Tech Lab como a extensão para o ecossistema de apps do ads.txt. Seu propósito é simples e defensivo: em vez de os compradores confiarem em uma solicitação de lance que afirma vir do seu app, eles podem consultar uma lista pública, controlada pelo publisher, de quem tem permissão para vender esse inventário. Os vendedores que não estão na lista podem ser filtrados, e é isso que torna mais difícil monetizar apps falsificados e revendas não autorizadas.

Especificamente para o AdMob, o arquivo é como o Google confirma que a conta de publicador que solicita a monetização corresponde ao desenvolvedor por trás da ficha do app na loja. Um arquivo publicado corretamente garante o status de verificado na sua conta AdMob; um arquivo ausente ou malformado deixa seus apps não verificados, mesmo enquanto os anúncios continuam sendo exibidos. Essa lacuna é justamente o motivo de existir este checklist.

2. Pré-requisito — um site do desenvolvedor vinculado à ficha do app na loja

O AdMob não adivinha seu domínio. Ele lê o site do desenvolvedor na ficha do app na loja e deriva o hostname a partir dele. Se esse campo estiver vazio — ou apontar para uma página social, um domínio estacionado ou uma URL de construtor de formulários — não há nada para o rastreador resolver, e publicar arquivos não vai ajudar.

  • Google Play. Adicione a URL do seu site de desenvolvedor às informações de contato do desenvolvedor. Para confirmar que funcionou, verifique se a URL do site do desenvolvedor está vinculada na seção "suporte do app" da página do seu app na loja.
  • App Store. Adicione a URL no campo URL de marketing da ficha do seu app (Informações do app) e confirme que ela aparece na página do produto.
  • Momento certo. Se você acabou de adicionar ou alterar o site em uma ficha, aguarde até 24 horas para que o AdMob detecte a mudança antes de esperar qualquer rastreamento.

Se você ainda não tem um site que permita enviar um arquivo na raiz, isso não é um impedimento — o Firebase Hosting é uma opção documentada para publicar um arquivo app-ads.txt.

3. Etapa 1 — publique o arquivo na raiz do domínio

O arquivo deve estar acessível na raiz do nome de host derivado da sua ficha, no formato:

https://<hostname>/app-ads.txt http://<hostname>/app-ads.txt

"Raiz" significa imediatamente após o domínio de nível superior — para example.com, o arquivo fica em example.com/app-ads.txt, não dentro de uma subpasta do projeto. Antes de qualquer outra coisa, abra essa URL no navegador. Se o conteúdo do arquivo aparecer, é muito provável que o rastreador o encontre; se o navegador mostrar uma tela de login, um shell JavaScript ou um prompt de download, corrija isso primeiro.

4. Etapa 2 — o ID do publisher e o formato exato da linha

Cada linha nomeia um vendedor autorizado, no formato exigido pela especificação do IAB:

<domínio do sistema de anúncios>, <ID da conta de publisher>, <relacionamento>, <ID da autoridade de certificação>

A linha do Google usa seu ID de publisher AdMob (o valor pub-… encontrado na sua conta) como ID da conta, DIRECT como relacionamento e o ID da autoridade de certificação TAG do Google:

google.com, pub-0000000000000000, DIRECT, f08c47fec0942fa0

Você não precisa montar isso manualmente. O AdMob oferece um snippet de código personalizado que já contém seu ID de publisher, e incluir esse ID formatado corretamente é um requisito explícito para a verificação. Crie o arquivo como texto simples (Notepad, TextEdit ou qualquer editor de texto — não um documento rich-text), cole o snippet e adicione uma linha para cada outra rede de anúncios com a qual você trabalha; cada rede publica suas próprias informações de app-ads.txt. Um arquivo que não segue o formato do IAB não será verificado, por mais válido que seja seu ID.

5. Etapa 3 — entenda como o rastreador da AdMob procura o arquivo

O crawler monta sua URL a partir do hostname do site do desenvolvedor na sua ficha, e então sobe em uma ordem definida. Conhecer as regras evita toda uma classe de mistérios do tipo "mas meu arquivo está bem ali".

  • Ordem do protocolo. Ele verifica primeiro a URL HTTPS e depois a URL HTTP.
  • Subdomínios. O crawler verifica até um nível de subdomínio. Se a sua ficha do app na loja aponta para support.help.example.com, ele vai procurar em help.example.com e depois em example.com — mas nunca em um subdomínio de segundo nível como support.help.example.com.
  • Subdomínios excluídos. A especificação exclui www. e m. como locais a verificar, então uma ficha que aponta para www.example.com ainda é resolvida em example.com.
  • Redirecionamentos. Seu servidor web pode redirecionar o rastreador para o arquivo hospedado em outro lugar, inclusive em um subdomínio www., em um host estático ou em um CDN — redirecionamentos são permitidos. Um arquivo servido diretamente, porém, elimina mais uma coisa que pode dar errado silenciosamente.
  • robots.txt. Dê acesso ao crawler do AdMob no seu robots.txt. Bloqueá-lo é uma causa comum e autoinfligida de "não encontrado".

6. Etapa 4 — aguarde o rastreamento e solicite um se for preciso

O AdMob rastreia rotineiramente seu arquivo mais recente, e isso pode levar até 24 horas para rastrear e verificar. Se você está aguardando um arquivo recém-publicado, pode pedir uma análise mais rápida:

  1. Entre no AdMob, abra Apps e depois Ver todos os apps.
  2. Abra a página app-ads.txt e expanda a linha do app que você quer verificar.
  3. Clique em Verificar atualizações.

Dois detalhes controlam a impaciência aqui. Um novo rastreamento manual atualiza o status de todos os apps que compartilham o mesmo arquivo app-ads.txt, então raramente é preciso solicitar por app. E o botão às vezes fica indisponível — quando isso acontece, o rastreamento de rotina continua rodando, então espere as 24 horas em vez de reeditar o arquivo repetidamente.

7. Passo 5 — leia o status de verificação e solucione problemas a partir dele

A página app-ads.txt no AdMob mostra o status e os detalhes de rastreamento de cada app. Trate essa página como a única fonte de verdade, e não como uma captura de tela da semana passada. Se o arquivo não foi encontrado ou não foi verificado, os detalhes do status apontam a causa, e o Google publica um caminho dedicado de solução de problemas.

As causas mais comuns, em ordem: o campo de site do desenvolvedor na ficha do app na loja está vazio ou inutilizável; o arquivo está em um caminho em vez da raiz; o ID do publisher está ausente ou malformado; o crawler está bloqueado pelo robots.txt; ou a ficha foi alterada tão recentemente que o AdMob ainda não a releu.

8. O checklist de verificação do app-ads.txt

Execute estas doze verificações em ordem. Cada uma delas corresponde a uma regra acima, e cada uma é algo que o crawler vai julgar implicitamente.

  1. Existe um site do desenvolvedor e você controla o domínio dele.
  2. Essa URL está listada na ficha do app na loja — site do desenvolvedor no Play ou App Store URL de marketing — e visível na área de suporte do app.
  3. app-ads.txt sits at the domain root, as https://<hostname>/app-ads.txt.
  4. A URL exibe o conteúdo do arquivo diretamente no navegador.
  5. O arquivo é texto simples, não um documento formatado nem uma imagem.
  6. Seu ID de publicador AdMob está presente, no formato correto de linha IAB, com a linha Google incluída.
  7. Toda outra rede de anúncios que você usa tem a própria linha adicionada.
  8. O arquivo está acessível na raiz ou no subdomínio de primeiro nível que o crawler realmente verifica — não apenas em um subdomínio mais profundo.
  9. O robots.txt permite o rastreador AdMob.
  10. Se você alterou o site da ficha, conceda até 24 horas para o AdMob detectar a mudança.
  11. Você solicitou Verificar atualizações se precisar de um rastreamento mais rápido e então aguardou a janela de 24 horas.
  12. Você reconfere o status sempre que sua lista de vendedores muda e mantém o arquivo atualizado.

9. Onde o KappS se encaixa

O app-ads.txt é um elo de uma corrente mais longa que decide se um app monetizado realmente recebe o pagamento: a conta de desenvolvedor, o perfil de pagamentos, as informações fiscais e a identidade do publisher precisam estar alinhados. O KappS ajuda os desenvolvedores a preparar e enviar material em conformidade ao longo dessa corrente, para que uma etapa de verificação — app-ads.txt, identidade ou impostos — não atrase silenciosamente a receita mais tarde. Na prática, isso significa verificar se a ficha do app na loja, o domínio e o publisher ID descrevem o mesmo publisher genuíno, e corrigir as divergências antes que um crawler ou um revisor as encontre.

O que não fazemos é fabricar autorização. O app-ads.txt existe justamente para expor publishers que não são quem dizem ser; listar um vendedor que você não tem o direito de representar é fraude, coloca a conta e seus repasses em risco, e não é um serviço que oferecemos. A única forma duradoura de passar na verificação é ser o publisher real por trás do app.

Fontes (Google documentação oficial): Ajuda do AdMob — Configurar um arquivo app-ads.txt para o seu app; Entender os status do arquivo app-ads.txt; Solucionar problemas do app-ads.txt; Sobre o rastreador de conteúdo (support.google.com/admob). IAB Tech Lab — especificação do app-ads.txt.

Gerencia contas de desenvolvedor em escala? Cuidamos do lado operacional.

Clique para escolher um arquivo · clique com o botão direito → Colar, ou pressione Ctrl/⌘+V para colar uma captura de tela

Você também pode arrastar um arquivo para esta caixa.

Respondemos ao e-mail que você fornecer. Seus dados ficam com KappS.

✔ Enviado

Recebemos sua mensagem e responderemos em até 24 horas.


← Voltar para editar