Validador de ads.txt
Cole o conteúdo do seu ads.txt para verificar a sintaxe instantaneamente. Valida linha por linha os campos DOMAIN, PUBLISHER_ID e RELATIONSHIP (DIRECT/RESELLER), ajudando você a configurar corretamente o arquivo que protege contra a revenda não autorizada de inventário publicitário (domain spoofing).
O que é o ads.txt
O ads.txt (Authorized Digital Sellers) é um arquivo de texto por meio do qual o responsável por um site declara quais sistemas de anúncios têm autorização para vender o espaço publicitário desse site. Trata-se de um padrão do setor definido pelo IAB Tech Lab, que deve ser hospedado na raiz do domínio (por exemplo, https://example.com/ads.txt). Cada linha segue uma especificação com 3 ou 4 campos separados por vírgula: DOMAIN (o domínio do sistema de anúncios), PUBLISHER_ID (o identificador da conta) e RELATIONSHIP (DIRECT ou RESELLER). Basta um único caractere fora do padrão para que a verificação feita pelo sistema de anúncios falhe, fazendo com que um espaço publicitário legítimo seja tratado como "não autenticado".
Este validador analisa, linha por linha, o conteúdo do ads.txt colado pelo usuário e detecta problemas como número incorreto de campos, campos vazios, formato inválido de DOMAIN e valores incorretos de RELATIONSHIP (qualquer coisa além de DIRECT ou RESELLER). Linhas de comentário (que começam com #) e diretivas de variáveis como CONTACT=, SUBDOMAIN= e OWNERDOMAIN= também são identificadas corretamente e exibidas separadamente das linhas de registro. Também é possível informar uma URL e buscar diretamente o ads.txt já publicado em um site existente para validá-lo.
Como usar o validador de ads.txt
- Prepare o conteúdo do ads.txt Tenha em mãos, em formato de texto, o arquivo atual do seu site ou o conteúdo que pretende publicar em breve.
- Cole no campo de entrada ou busque por URL Cole o conteúdo diretamente na caixa de texto ou informe o domínio no campo "Buscar por URL" para carregar o ads.txt já existente.
- Verifique o resultado da validação Consulte a lista para ver se cada linha foi classificada como válida, com erro, variável ou comentário.
- Corrija as linhas com erro Reescreva a linha correspondente seguindo o motivo específico exibido na coluna de observações, como número insuficiente de campos ou formato inválido de DOMAIN.
- Publique na raiz do domínio após corrigir Quando todas as linhas estiverem marcadas como válidas, publique o arquivo no servidor como https://seudominio.com/ads.txt.
Dicas para aproveitar melhor
- O formato básico tem 3 campos — DOMAIN, PUBLISHER_ID e RELATIONSHIP — com um quarto campo opcional para o ID da autoridade certificadora. Conte as vírgulas para verificar se não falta nem sobra nenhuma.
- RELATIONSHIP só aceita
DIRECT(o proprietário do site tem contrato direto) ouRESELLER(vendido por meio de um revendedor). Não diferencia maiúsculas de minúsculas, mas o estilo convencional usa maiúsculas. - Linhas que começam com
#são ignoradas como comentários. Adicionar diretivas de variáveis comoCONTACT=ouOWNERDOMAIN=ajuda os sistemas de anúncios a conferir sua conta. - O ads.txt deve ser hospedado na raiz do domínio (
https://example.com/ads.txt). Colocá-lo em um subdiretório faz com que sistemas de anúncios e rastreadores não o reconheçam. - Existe uma especificação complementar para aplicativos móveis chamada
app-ads.txt. Se você vende inventário de anúncios tanto em um site quanto em um aplicativo móvel, precisa hospedar os dois arquivos.
Quando usar esta ferramenta
Revisão antes da análise do Google AdSense
Verifique com antecedência se o ads.txt já publicado tem algum erro de sintaxe, seja para a análise de aprovação do AdSense ou para resolver avisos sobre veiculação de anúncios.
Ao adicionar um novo sistema de anúncios (SSP)
Ao acrescentar uma linha fornecida por um novo SSP ou rede de anúncios, confirme na hora se o número de vírgulas e a grafia estão corretos antes de publicar.
Confirmação após migração de CMS ou redesign do site
Use o recurso de busca por URL para verificar diretamente o ambiente de produção e confirmar que o ads.txt não sofreu corrupção de caracteres ou quebras de linha após uma migração do WordPress ou troca de servidor.
Checagem de operações com múltiplos domínios
Agências de publicidade e gestores de múltiplos sites podem usar esta etapa de validação para revisar em conjunto o ads.txt de cada domínio administrado.
Validação de trechos fornecidos por terceiros
Antes de aplicar ao seu site um trecho de ads.txt enviado por uma rede de anúncios, faça a checagem de sintaxe isoladamente para evitar problemas.
Glossário
- ads.txt
- Especificação de arquivo de texto criada pelo IAB Tech Lab para declarar os vendedores autorizados de um espaço publicitário. Deve ser hospedado na raiz do domínio.
- DIRECT
- Valor de RELATIONSHIP que indica que o responsável pelo site tem contrato direto com o sistema de anúncios e detém, ele mesmo, a autoridade para vender o espaço publicitário.
- RESELLER
- Valor de RELATIONSHIP usado quando um revendedor (como uma rede de anúncios), com autoridade delegada pelo responsável do site, é quem vende o espaço publicitário.
- ID da autoridade certificadora (Certification Authority ID)
- Quarto campo, opcional, que indica o identificador do sistema de anúncios emitido por entidades como a TAG (Trustworthy Accountability Group).
- Domain spoofing
- Prática fraudulenta em que terceiros copiam e revendem, sem autorização, um espaço publicitário legítimo, fazendo com que anunciantes veiculem anúncios em outro site. O ads.txt foi criado para impedir isso.
- Authorized Digital Sellers
- Nome completo do ads.txt. Significa "vendedores digitais autorizados" e resume o princípio por trás de toda a especificação.
- PUBLISHER_ID
- Identificador emitido por cada sistema de anúncios para cada conta. No Google AdSense, é uma string que começa com "pub-".
- SSP (Supply-Side Platform)
- Plataforma intermediária que oferece o espaço publicitário do lado do editor aos sistemas de lances dos anunciantes. O campo DOMAIN do ads.txt registra o domínio do SSP.
Perguntas frequentes
DIRECT significa que o proprietário do site tem contrato direto com o sistema de anúncios e detém a autoridade para vender esse inventário. RESELLER é usado quando um revendedor (como uma rede de anúncios) vende o inventário em nome do proprietário, com autoridade delegada. Se um mesmo espaço publicitário for vendido por vários sistemas de anúncios, cada relação precisa ser listada corretamente.SUBDOMAIN= que permite apontar subdomínios específicos para um arquivo separado.
Curiosidade — Por que o ads.txt existe: um padrão do setor contra a "falsificação" de inventário publicitário
O ads.txt (Authorized Digital Sellers) é uma especificação criada em 2017 pelo IAB Tech Lab. Na época, a publicidade programática era assolada pelo chamado "domain spoofing": golpistas copiavam e revendiam sem autorização o inventário de editores legítimos. Anunciantes acreditavam estar comprando espaço em um site premium, mas seus anúncios acabavam em páginas de baixa qualidade sem relação alguma, corroendo a confiança tanto de anunciantes quanto de editores.
O mecanismo é simples: o editor publica, na raiz do seu domínio, um arquivo de texto simples listando os sistemas de anúncios que autorizou a vender seu inventário. Os sistemas de compra de anúncios consultam esse arquivo para verificar se o inventário em que estão dando lances é realmente vendido por um canal oficialmente aprovado por aquele domínio. Por ser um design tão simples, o custo de adoção é baixo, e em poucos anos a maioria dos grandes sistemas de anúncios e editores o adotou como padrão do setor.
O Google AdSense também vem promovendo a adoção do ads.txt desde 2019, e sites sem a configuração correta podem ter parte da veiculação de anúncios restringida. Para um site cujo modelo de negócio depende de receita publicitária, o ads.txt não é apenas uma recomendação — é, na prática, uma configuração obrigatória para proteger essa receita.
Como especificações complementares, o IAB Tech Lab também criou o app-ads.txt para aplicativos móveis e o sellers.json, que publica informações sobre os vendedores do lado dos sistemas de anúncios. Juntas, elas permitem que os anunciantes verifiquem quem vende qual inventário e sob qual relação em toda a cadeia de suprimentos.