Como corrigir erros de ads.txt da Adgora

Como corrigir erros de ads.txt da Adgora em um site de publisher

Se a Adgora estiver sinalizando seu site por causa do ads.txt, trate isso primeiro como um problema de arquivo, não de receita. A correção mais rápida normalmente vem de conferir o arquivo publicado em https://yourdomain.com/ads.txt e comparar o que a Adgora vê com o que você pretendia publicar. Um host errado pode comprometer tudo.

Este guia foca no caso específico em que o arquivo existe em algum lugar, mas a Adgora ainda reporta erro. Em outras palavras, ele ajuda quando você precisa entender como corrigir erro de ads.txt da Adgora, já que isso pode significar que o arquivo está ausente, inacessível, mal cacheado ou tecnicamente presente, mas invisível para o crawler. A diferença importa.

Comece pela mensagem exata dentro da Adgora. Se o site estiver marcado como ads.txt Adgora não detectado, isso é diferente de uma divergência de crawl, e ambos são diferentes de uma lista que parece válida, mas não está sendo detectada. Uma captura de tela ajuda depois, especialmente se o suporte pedir prova.

1. Identifique o estado exato do erro de ads.txt na Adgora

Abra o site do publisher na Adgora e leia com atenção o estado do erro. Um arquivo ausente, um 404 e uma mensagem de “não detectado” não são a mesma coisa, mesmo que pareçam iguais à primeira vista. Eles levam a verificações diferentes.

Se a Adgora disser que não consegue encontrar o arquivo, talvez o crawler nem esteja alcançando o verificar ads.txt no domínio ao vivo. Se disser que o arquivo parece errado, o problema pode ser de formato ou de posicionamento do hostname. Se o arquivo for válido, mas ainda ignorado, então o cache ou os redirecionamentos costumam ser os verdadeiros culpados.

Guarde a redação exata. Isso faz diferença.

Anote o domínio exato que a Adgora está verificando. Um publisher que gerencia tanto example.com quanto www.example.com pode corrigir um e ainda deixar o outro quebrado. Esse pequeno descompasso causa mais confusão do que muita gente imagina.

Se você também trabalha com vários sistemas de anúncios, pode ajudar comparar o problema com uma decisão de modelo CPC vs CPM vs CPA, porque o erro no arquivo afeta a entrega de formas diferentes dependendo de como o inventário é vendido. Isso não corrige o arquivo, mas deixa a conversa de relatório mais organizada.

2. Confirme que o arquivo está acessível publicamente no domínio ao vivo

Digite a URL ao vivo diretamente no navegador: https://yourdomain.com/ads.txt. Não teste apenas pelo painel do CMS. O painel pode dizer “publicado” enquanto o arquivo público retorna um 301, um 403 ou uma cópia antiga em cache.

Verifique se o navegador cai no host correto e permanece nele. Um redirecionamento de http para https é normal, mas um redirecionamento do domínio sem prefixo para outro subdomínio pode esconder o arquivo do crawler. Um redirecionamento está ok. Três, não.

O cache da CDN é outro problema comum. Se a CDN armazenou um ads.txt vazio ou uma versão de teste, a Adgora pode continuar vendo o arquivo antigo até o cache expirar ou ser limpo. Isso acontece com mais frequência do que a maioria das equipes admite.

Regras de robots também podem interferir indiretamente. O ads.txt em si deve ser público, então, se seu servidor ou plugin de segurança bloquear o acesso direto ao arquivo, o crawler talvez nunca chegue até ele. Isso normalmente aparece como um site aparentemente normal com um único problema teimoso de arquivo.

Confusão com ambiente de staging também atrapalha. Um arquivo em staging.example.com não ajuda se a Adgora estiver validando example.com. O domínio ao vivo é o único que importa aqui.

Se você publica notícias, blogs ou sites de conteúdo em vários domínios, mantenha um checklist. Uma entrada para a URL ao vivo, uma para o destino final do redirecionamento, uma para a camada de cache. Três etapas, não dez.

3. Verifique se a linha da Adgora está presente apenas no host correto

O arquivo ads.txt pode existir e ainda assim falhar se a linha da Adgora estiver no hostname errado. Isso acontece em sites espelhados, subdomínios de idioma e propriedades clonadas em que o arquivo foi copiado uma vez e nunca ajustado ao site ao vivo.

Veja qual host exato a Adgora usa. Se o seu site tem versões www e sem www, garanta que o arquivo esteja acessível na versão que a plataforma espera. Se você publica ambas as versões, muitas vezes o arquivo precisa ser consistente com os redirecionamentos e os caminhos canônicos.

Não presuma que uma cópia em subdomínio seja suficiente. Um arquivo em blog.example.com não satisfaz automaticamente example.com. A Adgora lê o arquivo público do domínio que valida, não da pasta onde sua equipe editou o conteúdo.

Um teste prático é simples: abra o host exato no navegador e acrescente /ads.txt. Se a linha aparecer ali, o host provavelmente está correto. Se aparecer em um host e não em outro, você encontrou o descompasso.

Agências e publishers com várias propriedades às vezes mantêm um arquivo mestre e o distribuem para todos os lugares. Isso parece organizado, mas gera erro quando uma propriedade tem um host canônico diferente. Basta um espelho errado.

Se você também estiver trabalhando em uma estratégia mais ampla de monetização, o guia de rede de anúncios de criptomoedas para publishers pode ajudar a contextualizar onde esse site se encaixa no restante da sua estrutura, mas o arquivo ads.txt ainda precisa estar correto no host ao vivo.

4. Valide o ID exato do publisher e a linha de relacionamento com o seller

Agora examine a própria linha da Adgora. Não é hora de adivinhar. Compare o ID do publisher, o nome da conta e quaisquer dados de relacionamento com seller com as informações recebidas da Adgora. Um caractere fora do lugar já pode inutilizar o arquivo.

Use o formato exato da linha fornecido pela documentação da Adgora. Não reorganize campos porque outra rede usa um padrão parecido. Entradas de ads.txt podem parecer semelhantes, mas não são intercambiáveis.

Se o seu ID de publisher contiver espaços, pontuação ou um prefixo inesperado, pare e confira os dados da conta de origem. Pequenos erros de transcrição são comuns. Um zero e a letra O parecem inocentes até custarem um dia inteiro.

Um hábito útil é colar a linha em um editor de texto simples antes de salvar. Isso remove formatações ocultas de ferramentas rich text, que podem adicionar caracteres invisíveis. Esses caracteres são difíceis de perceber e fáceis de culpar no crawler.

A linha deve corresponder à conta ao vivo, não à conta que você usou no ano passado. Se o site mudou de proprietário, passou para uma nova empresa ou trocou de parceiros de supply, IDs antigos tendem a permanecer no arquivo por mais tempo do que gostariam.

Se você precisar de uma referência rápida de terminologia enquanto confere a entrada, o glossário de ad tech pode ajudar a manter os rótulos organizados, especialmente quando o suporte menciona seller lines, publishers ou account IDs na mesma conversa.

5. Procure sobrescritas do arquivo por CMS, tema ou ferramentas de sincronização

Muitos erros de ads.txt são causados pela própria automação. Plugins do WordPress, módulos de CMS, configurações de tema e scripts de implantação podem reescrever o arquivo depois que você o corrige. O resultado é irritante: você salva a linha certa, atualiza a página e o arquivo antigo volta.

Revise seu fluxo de publicação passo a passo. Se um plugin gerencia o ads.txt, ele pode estar regenerando o arquivo com base nas próprias configurações. Se o seu site usa um script de deploy, esse script pode estar copiando uma versão mais antiga do repositório. Se o arquivo é sincronizado a partir de uma pasta central de ativos, uma fonte ruim sobrescreverá a versão limpa toda vez.

Procure os carimbos de data/hora do arquivo. Depois compare com a hora em que você o editou. Se o arquivo mudar de novo 5 minutos depois, o problema é de processo, não de formato da linha.

Alguns publishers mantêm o ads.txt em um diretório do tema, o que funciona até o tema ser atualizado. Depois o arquivo desaparece ou é substituído. Isso é especialmente irritante após um grande redesign.

Pesquise no CMS por qualquer campo chamado ads.txt, seller file ou authorization file. Se dois sistemas podem editar o mesmo conteúdo, um deles vai vencer. Normalmente o errado.

Se sua stack inclui monetização programática com vários parceiros, o padrão operacional é parecido com o que você pode ver em fluxos de publicidade em criptomoedas: uma pequena mudança de configuração pode sobrescrever um ativo ao vivo sem muito aviso. Aqui, esse ativo é o arquivo lido pela Adgora.

6. Refaça o crawl do arquivo após uma publicação limpa

Depois que o arquivo estiver corrigido, publique-o de forma limpa. Em seguida, limpe todas as camadas de cache relevantes, incluindo CDN, cache do servidor e cache do plugin, se você usar esses recursos. Não edite o arquivo de novo por um tempo. Dê ao crawler uma versão estável.

Aguarde a Adgora captar o arquivo atualizado em vez de persegui-la com mudanças rápidas. Crawler não precisa de um novo salvamento a cada 2 minutos. Ele precisa de uma URL ativa que permaneça igual tempo suficiente para ser buscada, armazenada e verificada novamente.

Uma sequência simples de tentativa funciona bem: verifique a URL ao vivo, purgue o cache, confirme a linha e depois não mexa mais no arquivo. Essa sequência parece básica porque é. Correções complicadas costumam piorar a situação.

Se o site tiver uma janela de deploy, use-a. Publique o arquivo quando o tráfego estiver baixo e depois monitore a URL ao vivo após o cache ser limpo. Um arquivo estável vale mais do que um arquivo rápido.

Verifique o código de resposta após a publicação. Um 200 é o objetivo. Um redirecionamento ainda pode funcionar, mas deve ser intencional e consistente. Se o navegador mostrar um host diferente, isso ainda é uma pista.

Para publishers que trabalham com vários modelos de tráfego, esse tipo de limpeza combina bem com um planejamento mais amplo de aquisição, como o de tráfego pago para dropshipping, em que a higiene do site pode afetar tanto a aprovação quanto o rastreamento. Aqui, porém, a tarefa é mais específica: tornar o arquivo legível uma vez e então deixar a Adgora fazer o recrawl.

7. Escalone com evidências se o arquivo estiver correto, mas o erro continuar

Se tudo estiver certo e a Adgora ainda mostrar erro, reúna evidências antes de abrir um ticket. Inclua a URL ao vivo, a hora em que você conferiu, uma captura de tela do navegador mostrando o arquivo e a linha exata do ads.txt como aparece na página. Esse pacote evita trocas desnecessárias.

O suporte consegue agir mais rápido quando recebe um caso limpo. Envie a URL pública, o domínio que a Adgora está validando e a conta ou o ID de publisher envolvido. Se houve redirecionamentos, mencione isso. Se uma CDN foi purgada, diga também.

Não envie apenas “não funciona”. Essa mensagem obriga o suporte a começar do zero. Uma captura com resposta 200 e a linha visível é muito melhor do que uma reclamação vaga.

Se você tiver acesso aos logs do servidor, inclua o horário de uma requisição direta a /ads.txt. Isso mostra se o arquivo foi buscado com sucesso no nível do servidor. Uma linha de log pode resolver uma discussão rapidamente.

Às vezes o problema está do lado da plataforma, não do seu. Isso é raro, mas acontece. O suporte pode confirmar o tempo de crawl, atrasos de validação ou uma leitura interna desatualizada se seu arquivo público já estiver correto e inalterado.

Ao documentar como corrigir erros de ads.txt da Adgora em um site de publisher, mantenha a prova perto do próprio arquivo. URL ao vivo, horário, captura de tela, linha exata. Três itens, um caso, menos discussão.