Erro de ads.txt da Adgora no Shopify
Entenda por que o Shopify pode não exibir o ads.txt da Adgora e como corrigir domínio, host, redirecionamentos e a linha do vendedor.
Nesta página0%
Definição: o que esse erro significa no Shopify
“Erros de ads.txt da Adgora em uma loja Shopify” significa que a Adgora verificou sua loja e não conseguiu ler o arquivo ads.txt do jeito esperado. Isso normalmente aponta para uma de quatro coisas: o arquivo está ausente, o arquivo está bloqueado, o arquivo está no host errado ou a linha de vendedor da Adgora não está visível no arquivo. Em muitos casos, a origem do erro ads.txt Adgora Shopify está justamente nessa diferença entre o que a loja mostra para o cliente e o que o rastreador consegue acessar.
A frase soa técnica, mas o problema real é simples. A Adgora quer encontrar um arquivo de texto simples na raiz pública da loja e, se o Shopify exibir algo diferente ali, a verificação falha. Basta faltar uma linha, e por isso entender como corrigir ads.txt no Shopify costuma ser mais importante do que mexer no tema.
Pense no ads.txt como uma breve declaração pública. Uma única linha pode importar mais do que uma longa edição do tema. Se o rastreador não conseguir corresponder o domínio da loja e a entrada esperada da Adgora, a plataforma pode sinalizar a loja mesmo quando a vitrine parece normal para os clientes.
É por isso que o erro pode parecer estranho. Sua página inicial carrega, seus produtos carregam e o checkout funciona, mas a Adgora ainda marca a loja. O problema está no caminho do arquivo, no host ou no texto exato, especialmente quando há ads.txt Shopify domínio personalizado em jogo.
ads.txt no Shopify: como o Shopify lida com o arquivo
O Shopify trata o Shopify ads.txt por meio do seu próprio mecanismo no nível da loja, e não por uma página do tema ou uma postagem de blog. Isso importa porque um arquivo de texto no editor de tema não é a mesma coisa que um arquivo ads.txt público na raiz da loja.
Na prática, o Shopify espera que o arquivo ads.txt esteja disponível na raiz do domínio, onde os rastreadores podem solicitá-lo diretamente. Uma página como /pages/ads-txt não conta, e um trecho escondido no liquid do tema também não conta, a menos que o Shopify esteja realmente publicando o arquivo no local público correto.
Essa distinção confunde muita gente toda semana. O dono da loja pode colar a linha da Adgora no tema, salvar e assumir que o trabalho acabou. Não acabou.
O Shopify também se importa com qual host é o principal. Se a loja usa um domínio personalizado, o arquivo ainda precisa resolver corretamente no host que a Adgora verifica, e não apenas em um endereço de teste ou em uma versão alternativa da vitrine.
Um pequeno detalhe pode mudar o resultado. Se o arquivo raiz estiver presente em www, mas a Adgora verificar o domínio sem www, ou o contrário, o rastreador pode não ver a linha de jeito nenhum.
Causas comuns no Shopify por trás dos erros de ads.txt da Adgora
Várias escolhas de configuração no Shopify causam o mesmo erro. A mais comum é uma incompatibilidade de domínio: a loja ainda não terminou de apontar para o domínio principal, então a Adgora verifica um host enquanto o Shopify serve o arquivo em outro.
Hosts de vitrine duplicados também causam problemas. Uma loja pode aparecer no domínio personalizado, na versão www e, às vezes, em um endereço atribuído pelo Shopify durante a configuração, mas apenas um deles deve ser o host canônico. Se a Adgora rastrear o host errado, ela pode informar que o arquivo ads.txt está ausente mesmo que ele exista em outro lugar.
Conflitos com arquivos gerados por apps são outra fonte. Alguns apps ou scripts tentam criar ou reescrever arquivos do site, e isso pode substituir a configuração do Shopify ads.txt. Um arquivo que parecia correto ao meio-dia pode desaparecer à tarde.
O comportamento dos redirecionamentos também importa. Se a solicitação raiz para /ads.txt cair em uma página que redireciona de forma estranha, retorna um erro suave ou afasta o rastreador da raiz real da loja, a Adgora pode não aceitar o resultado. Isso não é um problema de tema; é um problema de host e de resposta.
Há também o caso simples de uma linha incompleta. A linha de relacionamento do vendedor da Adgora pode estar faltando, incompleta ou copiada com um identificador errado. Um caractere fora do lugar pode ser suficiente.
Lojas que ainda estão sendo migradas enfrentam um risco especial. Durante uma transferência de domínio, o host antigo pode continuar respondendo às solicitações enquanto o novo host já está ativo para os clientes, e essa divisão pode confundir a verificação do arquivo pela Adgora.
Corrigir ads.txt no Shopify: o caminho mais curto e seguro
Para corrigir ads.txt no Shopify, comece pelo domínio principal. Abra as configurações da loja e confirme qual host é canônico, porque o arquivo precisa funcionar onde a Adgora realmente está olhando.
Depois, verifique se é o Shopify que está publicando o arquivo. Não dependa de um trecho no tema, de uma página do blog ou de um bloco de conteúdo escondido. O arquivo deve ficar acessível como um arquivo de texto na raiz, e não como uma página web comum.
Em seguida, confira a própria linha da Adgora. A linha deve aparecer no arquivo público, exatamente como exigido, e apenas no host correto. Se a loja usa um domínio personalizado, teste tanto a versão sem www quanto a versão www para saber qual delas resolve o arquivo.
Depois disso, publique novamente ou faça uma nova verificação da vitrine. Às vezes a atualização é imediata; às vezes o rastreador precisa de tempo para revisitar o arquivo. Um novo rastreamento pode limpar um alerta antigo.
Se o erro continuar depois de uma checagem limpa, inspecione a resposta ao vivo do arquivo. Um retorno 200 não basta por si só se o conteúdo estiver errado ou se o host não for o que a Adgora espera.
Veja a sequência prática em um só lugar:
- Confirme o domínio principal.
- Abra a URL ativa /ads.txt.
- Verifique se o Shopify está servindo o arquivo.
- Confirme a linha da Adgora.
- Verifique novamente após a atualização da vitrine.
Onde colocar a linha da Adgora em uma loja Shopify
A linha da Adgora deve ficar no arquivo ads.txt público na raiz do domínio. Esse é o único lugar que importa para as verificações do rastreador.
Não a coloque apenas no código do tema. Não a coloque apenas em uma página, em um item de menu ou em um artigo do blog. Os mecanismos de busca podem indexar essas páginas, mas a validação de ads.txt trata de um caminho de arquivo específico, não de conteúdo geral do site.
Se a loja usa o domínio sem www como principal, teste primeiro exatamente esse domínio. Se www for o canônico, teste www primeiro. Uma incompatibilidade entre essas duas versões pode gerar um falso alarme.
Um hábito útil é abrir o arquivo no navegador e ler a barra de URL com atenção. O endereço deve ser o host ativo da loja mais /ads.txt, sem nada extra. Um redirecionamento a mais pode distorcer o resultado.
Para lojas com vários idiomas ou variantes regionais, mantenha o arquivo ads.txt no host principal que a Adgora verifica. Uma landing page em francês ou um subcaminho de mercado alternativo não substitui o arquivo raiz.
Uma observação rápida: muitos lojistas confiam demais no editor de tema. O tema é para o design da vitrine. O ads.txt é uma verificação de arquivo.
Exemplos de entradas ads.txt para lojas Shopify
Veja um exemplo simples de como uma linha válida de ads.txt no Shopify pode parecer para a Adgora:
| Caso | Exemplo | Resultado |
|---|---|---|
| Arquivo raiz correto | adgora.net, publisher-id-123, DIRECT | Parece uma entrada padrão, se o formato real da Adgora corresponder |
| Host errado | Colocado apenas em um domínio de teste | A Adgora pode não detectá-lo |
| Local errado | Adicionado a uma página do tema | Não é válido como ads.txt |
Use o exemplo apenas como estrutura, não como resposta final. O valor exato do publisher ou do seller da Adgora precisa corresponder aos dados da conta.
Outro erro comum é escrever uma linha sem os separadores corretos. Uma vírgula faltando ou um identificador quebrado pode tornar a entrada ilegível, mesmo que pareça correta aos olhos.
Exemplo de formato errado: uma linha colada como texto simples em um parágrafo na página inicial. Isso é conteúdo, não ads.txt.
Exemplo de host errado: o arquivo existe em shop-name.myshopify.com, mas a loja agora usa um domínio personalizado. A Adgora pode verificar o domínio personalizado e não encontrar nada lá.
Se você quiser uma visão mais ampla dos formatos de anúncios nesse tipo de configuração, o guia de anúncios de cripto para lojas de e-commerce mostra como o tráfego da loja e as verificações de arquivo costumam se encontrar no mesmo ponto operacional.
Termos relacionados e o que verificar a seguir
ads.txt é o arquivo de texto público que lista os vendedores autorizados. Não é uma página, não é um banner e não é uma nota escondida do tema.
Domínio principal é o host principal que o Shopify usa para a loja. Se isso estiver errado, a verificação do arquivo pode apontar para o lugar errado.
Host canônico é a versão do domínio que deve responder à solicitação primeiro. Em uma loja Shopify, isso pode ser o domínio sem www ou o www, mas não os dois como líderes concorrentes.
Linha de relacionamento do vendedor é a entrada exata que a Adgora espera no arquivo. Se essa linha estiver ausente ou com formato incorreto, o erro pode continuar mesmo quando o arquivo é público.
Rastreador é o bot que busca o arquivo. Ele não se importa com as configurações do seu tema; ele se importa com a URL, a resposta e o texto que consegue ler.
Substituição da vitrine acontece quando um app, ferramenta de sincronização ou etapa de implantação substitui o arquivo depois que você o corrige. É por isso que um problema pode voltar após uma atualização bem-sucedida.
Se o arquivo estiver correto no navegador, mas a Adgora ainda relatar um problema após uma nova verificação, junte duas coisas: uma captura de tela da página ativa /ads.txt e a URL exata que você testou. Depois, entre em contato com o suporte com esses detalhes. Quanto mais específica for a evidência, mais rápida será a análise.
A verificação final deve levar menos de 5 minutos. Abra o arquivo ativo, confirme o host, leia a linha da Adgora e teste novamente após qualquer alteração no Shopify. Se o arquivo mudar, o erro pode mudar junto.
Para equipes que também anunciam em outros formatos, o lado operacional do tráfego da loja é abordado no guia de opções de segmentação de rede de anúncios de cripto, que é útil quando o arquivo já está estável e a loja voltou às verificações normais.
Termos neste artigo
Definições curtas do glossário do Adgora.
- Página de destino
- A página para a qual um clique envia alguém. Ela tem uma única função: continuar a promessa que o anúncio fez. Veja otimização da página de destino.
Perguntas frequentes
O que normalmente significa um erro de ads.txt da Adgora em uma loja Shopify?
Normalmente significa que a Adgora não conseguiu ler o arquivo ads.txt da loja como esperado. As causas comuns incluem arquivo ausente, arquivo bloqueado, arquivo no host errado ou a linha de vendedor da Adgora não estar visível.
Onde a linha da Adgora deve ser colocada em uma loja Shopify?
Ela deve ficar no arquivo ads.txt público na raiz do domínio. Colocá-la no código do tema, em uma página, em um item de menu ou em um post de blog não conta para as verificações do rastreador.
Por que o Shopify pode mostrar uma vitrine correta e mesmo assim disparar um erro de ads.txt?
Porque o problema pode estar no caminho do arquivo, no host ou no texto exato, e não na vitrine em si. A página inicial e o checkout podem funcionar normalmente enquanto o rastreador ainda não encontra a entrada esperada do ads.txt.
Qual é a forma mais segura de corrigir um erro de ads.txt no Shopify?
Primeiro confirme o domínio principal, depois garanta que o Shopify está servindo um arquivo /ads.txt ativo na raiz. Em seguida, verifique se a linha da Adgora está correta e faça uma nova checagem da loja após a atualização.
Incompatibilidades de domínio podem causar erros de ads.txt da Adgora no Shopify?
Sim. Se a Adgora verifica um host e o Shopify serve o arquivo em outro, o rastreador pode informar que o arquivo está ausente mesmo que ele exista. Isso costuma acontecer em configurações com www versus domínio sem www ou durante transferências de domínio.