Um único erro de formatação no seu ficheiro ads.txt pode desencadear supressão de licitações pelos DSP e aniquilar uma percentagem significativa da sua receita publicitária programática - silenciosamente, sem qualquer mensagem de erro no seu site. O ads.txt é um ficheiro de texto simples com regras de parsing rigorosas, e a maioria dos editores só descobre problemas através de quedas inexplicáveis de CPM no painel publicitário. Este guia cobre todos os métodos para verificar ficheiros ads.txt, os erros que mais importam e como manter o ficheiro saudável a longo prazo.
O que é o ads.txt?
ads.txt significa Authorized Digital Sellers (Vendedores Digitais Autorizados). É um ficheiro de texto simples alojado na raiz do seu domínio - `oseudominio.com/ads.txt` - que lista todas as ad exchanges, redes e plataformas do lado da oferta (SSP) autorizadas a vender inventário publicitário no seu site. O IAB Tech Lab introduziu a norma em 2017 especificamente para combater a usurpação de domínio: uma forma de fraude publicitária em que atores maliciosos vendem inventário fingindo provir de um domínio de editor premium que não possuem.
Quando uma plataforma do lado da procura (DSP) ou um anunciante coloca uma licitação programática, o seu sistema consulta o ficheiro ads.txt do editor antes de gastar. Se a entidade vendedora listada no pedido de licitação não aparecer no ficheiro ads.txt, o comprador salta a licitação por inteiro ou aplica um desconto significativo. Um ficheiro em falta, uma entrada mal configurada ou um registo desatualizado traduzem-se diretamente em taxas de preenchimento mais baixas e CPMs efetivos reduzidos.
O formato de linha do ads.txt
Cada linha de um ficheiro ads.txt válido segue um formato preciso de quatro campos. Compreender a estrutura é essencial para detetar erros - a maioria dos problemas de validação provém de linhas que se desviam deste padrão exato.
# Format: domain, publisher-account-id, account-type, authority-id
# account-type must be DIRECT or RESELLER
# authority-id (TAG-ID) is optional but strongly recommended
google.com, pub-0000000000000000, DIRECT, f08c47fec0942fa0
appnexus.com, 1234, RESELLER, f5ab79cb980f11d1
openx.com, 540191398, RESELLER, 6a698e965929
# Lines starting with # are comments - ignored by parsers
# [email protected]
# SUBDOMAIN=sub.oseudominio.com- domain: O domínio raiz do sistema publicitário (p. ex. `google.com`, não `ads.google.com`).
- publisher-account-id: O seu ID de conta ou de editor junto dessa rede publicitária.
- account-type: Ou `DIRECT` (tem um contrato direto) ou `RESELLER` (vendido via intermediário).
- authority-id: O TAG-ID ou Seller Account ID, opcional mas recomendado, do Trustworthy Accountability Group. Omiti-lo reduz a confiança do comprador.
Note
Porque é que os erros do ads.txt custam receita
A aplicação do ads.txt pelo ecossistema programático não é uniforme - diferentes DSP tratam ficheiros inválidos de forma diferente, o que torna o impacto na receita difícil de prever e fácil de perder até os CPMs caírem visivelmente. Compreender como os compradores reagem aos erros explica porque vale a pena verificar o ads.txt regularmente.
Como os DSP reagem a problemas do ads.txt
- Ficheiro em falta (404): A maioria dos grandes DSP trata um ads.txt em falta como "inventário não verificado". Alguns saltam a licitação por inteiro; outros licitam a um piso fortemente descontado.
- Formato de linha inválido: Linhas com contagem errada de campos ou valores de tipo de conta inválidos são silenciosamente ignoradas - a entrada é tratada como se não existisse.
- Divergência DIRECT vs RESELLER: Se uma rede vende como DIRECT mas o seu ficheiro a lista como RESELLER (ou vice-versa), os compradores sinalizam a divergência e reduzem a confiança no inventário.
- authority-id em falta: O programa TAG Certified Channels exige authority-ids. Compradores que aplicam a certificação TAG ignoram entradas sem eles.
- Redirecionamento para a homepage: Um redirecionamento 301 ou 302 de /ads.txt para a homepage é tratado como ficheiro em falta pela maioria dos rastreadores.
Os compradores de publicidade digital podem usar o ads.txt para determinar se uma oportunidade de compra de media digital está autorizada pelo editor e se é permitido aos revendedores vender o inventário do editor.
Google AdSense e avisos de ads.txt
O Google AdSense é particularmente rigoroso na aplicação do ads.txt. Se o seu ID de editor do AdSense não estiver corretamente listado no seu ficheiro ads.txt, o AdSense mostra um aviso no painel e pode reduzir a exibição nos seus blocos de anúncios aprovados. A entrada exigida do AdSense segue este formato exato: `google.com, pub-XXXXXXXXXXXXXXXXX, DIRECT, f08c47fec0942fa0`. O authority-id `f08c47fec0942fa0` é o TAG-ID fixo do Google - tem de aparecer exatamente como está escrito.
Warning
Como verificar o seu ficheiro ads.txt
Verificar o ads.txt exige duas verificações separadas: acessibilidade (o ficheiro é alcançável no URL certo?) e validade (cada linha está corretamente formatada?). Ambas as verificações são rápidas e podem ser feitas em menos de dois minutos com as ferramentas certas.
Verifique que o ficheiro é acessível no domínio raiz
Abra um navegador em modo anónimo e navegue para `oseudominio.com/ads.txt`. O ficheiro deve carregar como texto simples, sem invólucro HTML, sem pedido de início de sessão e sem redirecionamento. Se vir um 404 ou o ficheiro redirecionar para a sua homepage, o ads.txt não está acessível aos rastreadores das plataformas publicitárias, independentemente de existir no seu servidor. Verifique a configuração do seu servidor web - muitos sites WordPress redirecionam acidentalmente todos os caminhos indefinidos para a página inicial via regras `.htaccess`.
Cole o ficheiro no Validador de Ads.txt dos Aback Tools
Copie o conteúdo integral do seu ficheiro ads.txt - do navegador ou diretamente do seu servidor - e cole-o no Validador de Ads.txt. A ferramenta analisa cada linha contra a especificação IAB, sinaliza contagens de campos erradas, valores de tipo de conta inválidos e entradas duplicadas, e reporta cada erro com o número da linha. Os seus dados são processados inteiramente no navegador - nada é enviado para um servidor.
Cruze com a sua lista de parceiros publicitários
Compare as entradas validadas com as linhas ads.txt atuais fornecidas por cada rede publicitária que usa. A maioria das redes publica as entradas ads.txt exigidas na documentação para editores ou no painel. As redes ocasionalmente atualizam as entradas exigidas - uma mudança de domínio ou um novo authority-id - e os editores perdem a atualização. Uma divergência entre o que o seu ficheiro lista e o que uma rede exige atualmente causa a mesma supressão de licitações que uma entrada em falta.
Corrija os erros e re-verifique a acessibilidade
Corrija cada erro reportado, reenvie o ficheiro para o diretório raiz do seu servidor e navegue novamente para `oseudominio.com/ads.txt` para confirmar que o ficheiro atualizado está ativo. Aguarde 24-48 horas para que as grandes plataformas publicitárias re-rastreiem o ficheiro antes de esperar recuperação de receita. Use o validador uma segunda vez no ficheiro ativo para confirmar que nenhum erro de envio introduziu problemas novos.
Validador de Ads.txt
Valide ficheiros ads.txt quanto a erros de formato, tipos de conta inválidos, entradas duplicadas e campos obrigatórios em falta - local no navegador, sem envio.
Erros comuns e como corrigi-los
A maioria dos problemas do ads.txt enquadra-se num pequeno número de padrões recorrentes. Cada um tem uma causa específica e uma correção específica - uma vez que sabe o que procurar, resolvem-se em minutos.
Contagem de campos errada
O erro mais comum é uma linha com o número errado de campos separados por vírgulas. Cada linha deve ter exatamente três campos obrigatórios (domínio, account-id, account-type) e um campo opcional (authority-id). Linhas de dois campos (apenas domínio e account-id) e linhas de cinco campos (campos extra acrescentados por erros de copiar-colar) falham ambas a validação. Verifique cada linha que o seu validador sinaliza - frequentemente o problema é uma vírgula a mais ou em falta de uma edição manual.
Valor de tipo de conta inválido
O campo account-type aceita apenas dois valores: `DIRECT` e `RESELLER`. Parsers insensíveis a maiúsculas aceitam `direct` e `reseller`, mas a especificação IAB recomenda maiúsculas. Qualquer outro valor - `DIRECT/RESELLER`, `Partner`, `Network` ou em branco - falha a validação e a linha é inteiramente ignorada pelos parsers conformes. Reveja cada linha sinalizada e corrija o valor exatamente para `DIRECT` ou `RESELLER` conforme a sua relação contratual com essa rede.
Ficheiro servido do caminho errado ou com Content-Type errado
O ficheiro ads.txt tem de ser acessível exatamente em `oseudominio.com/ads.txt` - não `/ads.txt.php`, não `/ads-txt`, não num caminho de subdiretório. O servidor deve devolver um estado `200 OK` com um `Content-Type` de `text/plain`. Algumas plataformas de alojamento servem ficheiros `.txt` com `application/octet-stream`, que alguns rastreadores rejeitam. Use o Validador de Robots juntamente com a sua verificação de ads.txt - se o robots.txt tiver problemas de acessibilidade semelhantes, provavelmente tem um problema de configuração do servidor que afeta todos os ficheiros `.txt` na raiz.
| Erro | O que o validador reporta | Correção |
|---|---|---|
| Contagem de campos errada | A linha tem 2 campos, esperados 3-4 | Adicione o domínio, account-id ou tipo em falta |
| Tipo de conta inválido | "partner" não é DIRECT nem RESELLER | Mude para DIRECT ou RESELLER |
| Entrada duplicada | Duplicado da linha 12 | Remova a linha duplicada |
| Redirecionamento / 404 | Ficheiro não acessível em /ads.txt | Corrija o roteamento do servidor ou .htaccess |
| Caracteres Unicode ocultos | Caráter inesperado na posição 8 | Reescreva a linha - não copie de PDFs |
| Entrada de subdomínio errada | Use antes a diretiva SUBDOMAIN= | Adicione o comentário SUBDOMAIN=sub.dominio.com |
| TAG authority-id em falta | Authority-id recomendado | Adicione o TAG-ID da documentação da rede |
Caracteres ocultos e problemas de codificação
Um problema de ads.txt particularmente difícil são linhas que parecem corretas visualmente mas falham o parsing por conterem caracteres Unicode ocultos - espaços inquebráveis, espaços de largura zero ou aspas tipográficas - introduzidos ao copiar de um PDF, um documento Word ou um e-mail em texto formatado. A maioria dos editores de texto não mostra estes caracteres. Se uma linha falha a validação sem erro de formatação óbvio, reescreva-a manualmente em vez de copiar e colar. A ferramenta de reparação de Unicode e codificação consegue remover caracteres Unicode invisíveis do texto colado antes de o colocar no seu ficheiro ads.txt.
app-ads.txt e sellers.json
O ads.txt foi desenhado para editores web. O ecossistema publicitário programático estendeu a norma a duas especificações relacionadas: app-ads.txt para inventário de aplicações móveis e sellers.json para transparência da cadeia de abastecimento. Compreender os três formatos ajuda-o a construir um quadro completo de autorização.
app-ads.txt para editores de aplicações móveis
Os desenvolvedores de aplicações móveis usam app-ads.txt em vez de ads.txt. O formato do ficheiro é idêntico - a mesma estrutura de linha de quatro campos, os mesmos tipos de conta DIRECT/RESELLER, o mesmo campo authority-id. A diferença está na descoberta: para apps, as plataformas publicitárias procuram o URL do site do desenvolvedor na ficha da App Store ou Google Play e verificam a existência de app-ads.txt na raiz desse domínio. Aloja o app-ads.txt no seu site de programador, não na aplicação em si. Use o Validador de App-ads.txt para verificar a autorização de inventário de apps móveis com as mesmas regras de validação.
sellers.json - o complemento da cadeia de abastecimento
O sellers.json é o complemento do ads.txt na direção oposta: as redes publicitárias e SSPs publicam um ficheiro sellers.json no seu próprio domínio listando todos os editores (vendedores) que representam. Um comprador pode cruzar a sua entrada RESELLER do ads.txt com o sellers.json do SSP para verificar que a cadeia de abastecimento é legítima. Embora não crie sellers.json como editor, compreendê-lo explica porque importa ter authority-ids corretos no seu ads.txt - são usados para casar as suas entradas com registos de sellers.json.
Note
Monitorizar a saúde do ads.txt
Uma verificação pontual do ads.txt não basta - as entradas das redes mudam, novos parceiros são integrados e a acessibilidade do ficheiro pode quebrar após atualizações do servidor ou do CMS. Construir uma rotina leve de monitorização previne perdas silenciosas de receita entre auditorias manuais.
Avisos do painel do Google AdSense
O painel do AdSense mostra uma faixa de aviso de ads.txt se o seu ID de editor falta no seu ficheiro ads.txt ou se o ficheiro não está acessível. Verifique o painel do AdSense após qualquer migração de servidor, atualização de CMS ou alteração de `.htaccess` - são os três eventos mais comuns que quebram a acessibilidade do ads.txt sem o editor dar por isso. O aviso aparece na secção "Conta" das configurações do AdSense.
Notificações de parceiros programáticos
A maioria dos grandes SSPs e redes publicitárias envia notificações por e-mail quando as suas entradas ads.txt exigidas mudam. Subscreva as notificações de atualização do portal de editores de cada parceiro, se disponível. Quando um parceiro atualiza o seu domínio ou authority-id, normalmente concedem uma janela de migração de 30-90 dias antes de as entradas antigas deixarem de ser honradas - mas apenas os editores que estão a monitorizar detetarão a mudança a tempo.
Fluxo de auditoria técnica
Inclua a validação do ads.txt na sua auditoria técnica de SEO trimestral ao lado do robots.txt, da validação do sitemap e das verificações de etiquetas canónicas. Use o Explicador de Conflitos de Regras do Robots.txt para verificar que nenhuma regra do robots.txt bloqueia acidentalmente os rastreadores das plataformas publicitárias, e o Validador de Sitemap para verificar a saúde do sitemap na mesma sessão. Estes ficheiros vivem ao mesmo nível da raiz do servidor e frequentemente são afetados pelos mesmos eventos de má configuração.
Tip
Boas práticas do ads.txt
Seguir estas práticas mantém o seu ficheiro ads.txt exato, acessível e eficaz - maximizando a elegibilidade de licitações enquanto protege o seu inventário de revendedores não autorizados.
Mantenha o ficheiro enxuto e atualizado
Remova as entradas das redes publicitárias com que já não trabalha. Um ads.txt sobredimensionado com dezenas de entradas inativas não prejudica diretamente a receita, mas aumenta a superfície de erros e dificulta a auditoria do ficheiro. Quando se desvincula de uma rede, remova as suas entradas ao mesmo tempo que retira as etiquetas de anúncios das suas páginas - trate ambas como parte do mesmo processo de desvinculação.
Use sempre authority-ids quando disponíveis
O TAG authority-id (também chamado TAG-ID ou Seller Account ID) é tecnicamente opcional na especificação ads.txt, mas os grandes DSP preferem entradas que o incluam. Permite que os compradores verifiquem toda a cadeia de abastecimento, do editor à exchange, por cruzamento com sellers.json. Cada grande rede publicitária publica o seu authority-id na documentação para editores - inclua-o em cada entrada onde esteja disponível.
- Uma entrada por linha: Nunca combine várias redes numa só linha - cada relação de vendedor autorizado tem a sua própria linha.
- Valide antes de cada envio: Execute o Validador de Ads.txt no ficheiro antes de o enviar para apanhar erros introduzidos durante a edição.
- Use codificação UTF-8 sem BOM: Guarde o ficheiro como UTF-8 simples. Um BOM (Byte Order Mark) no início do ficheiro pode quebrar o parsing em alguns rastreadores de plataformas publicitárias.
- Não use espaços no fim da linha: Muitos editores de texto acrescentam espaços finais invisíveis. Podem causar falhas de parsing por linha em validadores rigorosos.
- Controle de versões do seu ads.txt: Mantenha o ads.txt no repositório de controlo de versões do seu site. Um histórico git permite-lhe rastrear exatamente quando uma entrada foi adicionada ou removida se a receita cair inesperadamente.
Validador de App-ads.txt
Valide ficheiros app-ads.txt para inventário publicitário de aplicações móveis - mesmas regras de formato do ads.txt, otimizado para o contexto do editor de apps móveis.
Key takeaways
- O ads.txt lista todos os vendedores autorizados do seu inventário publicitário - entradas em falta ou inválidas fazem os DSP saltarem licitações ou descontarem os seus CPMs.
- Verifique primeiro a acessibilidade: navegue para `oseudominio.com/ads.txt` e confirme que carrega como texto simples com estado 200, sem redirecionamento nem invólucro HTML.
- Use o Validador de Ads.txt para verificar cada linha quanto a erros de formato, tipos de conta inválidos e duplicados - todo o processamento acontece no seu navegador.
- Os cinco erros mais comuns são a contagem errada de campos, valores de tipo de conta inválidos, ficheiro servido no caminho errado, caracteres Unicode ocultos e authority-ids em falta.
- O Google AdSense exige a entrada exata `google.com, pub-XXXXXXXXXXXXXXXXX, DIRECT, f08c47fec0942fa0` - o authority-id `f08c47fec0942fa0` é fixo e tem de coincidir exatamente.
- Para aplicações móveis, use app-ads.txt com o mesmo formato alojado na raiz do seu site de programador, descoberto via a ficha da loja de aplicações.
- Revalide o ads.txt após cada migração de servidor, atualização de CMS ou mudança de alojamento - são os eventos mais comuns que quebram silenciosamente a acessibilidade do ficheiro.