Configurar um arquivo app-ads.txt para seu app

Para que a AdMob encontre e verifique seu arquivo app-ads.txt:

• Seu app precisa estar registrado na Google Play Store ou na App Store da Apple.
• A página Detalhes do app precisa incluir um site de desenvolvedor, conforme explicado abaixo.

Se quiser configurar um arquivo app-ads.txt para seu app, siga estas etapas:

• Etapa 1: criar seu site de desenvolvedor
• Etapa 2: criar o arquivo app-ads.txt
• Etapa 3: publicar o arquivo app-ads.txt no seu site de desenvolvedor
• Etapa 4: aguardar a AdMob rastrear e verificar seu arquivo app-ads.txt
• Etapa 5: conferir se o arquivo app-ads.txt foi verificado na sua conta da AdMob

Etapa 1: criar seu site de desenvolvedor

O site de desenvolvedor é onde os usuários encontram mais informações sobre seus apps e outros tipos de conteúdo. Também é onde arquivo padrão app-ads.txt estabelece quem é o proprietário de um app. Esse site precisa estar vinculado à página Detalhes do app no Google Play ou na App Store da Apple para que a AdMob e outras plataformas de publicidade identifiquem a propriedade do app.

Se você não tem um site para sua empresa de desenvolvimento de apps, precisará providenciar um se quiser incluir um arquivo app-ads.txt. Existem diversas opções gratuitas e pagas de hospedagem disponíveis na Web.

Se você não tiver um site adequado que permita o upload de um arquivo app-ads.txt na raiz, use o Firebase Hosting para hospedar esse arquivo. Saiba como publicar o app-ads.txt com o Firebase Hosting.

Depois de fazer isso, atualize os detalhes do seu aplicativo nas app stores para incluir o site no URL de contato do desenvolvedor. Nesse site, você também pode publicar informações relevantes de suporte e marketing do app.

Observação: não é necessário incluir o URL completo do app-ads.txt na página Detalhes do app. A AdMob rastreia seu arquivo app-ads.txt usando o nome de host (domínio) do URL do site. Saiba como encontramos o arquivo app-ads.txt.

Etapa 1a: adicionar seu site de desenvolvedor à página Detalhes do app

Para adicionar seu site de desenvolvedor à página "Detalhes do app":

• Para Google Play: adicione o URL do site nos dados de contato da página "Detalhes do app".
  1. Faça login no Play Console.
  2. Selecione um app.
  3. No menu à esquerda, clique em Presença na loja e em Configurações da loja.
  4. Role a página até Detalhes de contato da página "Detalhes do app".
  5. Adicione o URL do seu site de desenvolvedor. Para confirmar que você fez isso corretamente, verifique se o link "Site do desenvolvedor" aparece na parte de baixo da página do app Android.
     Observação: se você adicionou ou atualizou o site de um desenvolvedor na página "Detalhes do app" no Google Play, aguarde até 24 horas para a AdMob detectar essas mudanças.

• Na app store da Apple: adicione seu site de desenvolvedor no campo do URL de marketing da página "Detalhes do app". Para confirmar que você adicionou o URL, verifique se o link "Site do desenvolvedor" aparece na parte de baixo da página do app iOS.

Etapa 2: criar o arquivo app-ads.txt

Crie um arquivo app-ads.txt caso seu site não tenha um. Seu ID do publisher precisa ser incluído e formatado corretamente para que o arquivo ads.txt seja verificado. Crie um arquivo de texto (.txt) usando um editor de texto simples, como o Bloco de Notas (Windows) ou o Editor de Texto (Mac). Você precisa adicionar seu snippet de código personalizado ao arquivo app-ads.txt.

Confira um exemplo de arquivo app-ads.txt:

# exemplo de arquivo app-ads.txt:

greenadexchange.com, 12345, DIRECT, d75815a79

silverssp.com, 9675, RESELLER, 496211

blueadexchange.com, XF436, DIRECT

orangeexchange.com, 45678, RESELLER

silverssp.com, ABE679, RESELLER

google.com, pub-0000000000000000, DIRECT, f08c47fec0942fa0

No exemplo acima:

• google.com é uma troca de anúncios
• pub-0000000000000000 é o ID do publisher/da conta
• DIRECT é o tipo de relacionamento
• f08c47fec0942fa0 é o ID da autoridade certificadora (por exemplo, o ID do Trustworthy Accountability Group)

Observação: seu arquivo app-ads.txt precisa ser formatado conforme as especificações do IAB Tech Lab para ser verificado. Se precisar de mais ajuda, consulte a especificação dos Vendedores autorizados do inventário de anúncios de apps (em inglês) disponibilizada pelo IAB Tech Lab.

Etapa 2a: adicionar seu snippet de código personalizado ao arquivo app-ads.txt

A AdMob disponibiliza um snippet de código personalizado que facilita a configuração do arquivo app-ads.txt. Esse snippet inclui seu ID do publisher.

Observação: seu ID do publisher precisa ser incluído e formatado corretamente para que o arquivo app-ads.txt seja verificado.

Para ter seu snippet de código personalizado, que inclui o ID do publisher:

1. Faça login na sua conta da AdMob em https://admob.google.com.
2. Clique em Apps na barra lateral.
3. Clique em Todos os aplicativos.
4. Clique na guia app-ads.txt.
5. Clique em Como configurar o app-ads.txt.
6. Clique em , ao lado do snippet de código a ser copiado.
7. Cole-o no arquivo app-ads.txt.

Etapa 2b (opcional): adicionar IDs de outros vendedores autorizados ao arquivo app-ads.txt

Se você estiver usando outra rede de publicidade, lembre-se de adicioná-la ao arquivo app-ads.txt. Com isso, o vendedor terceirizado também poderá encontrar e verificar o arquivo. Entre em contato com sua rede de publicidade para saber as informações dela que precisam ser incluídas ao app-ads.txt.

Etapa 3: publicar o arquivo app-ads.txt no seu site de desenvolvedor

Etapa 3a: fazer o upload do arquivo app-ads.txt no diretório raiz do seu site de desenvolvedor

O diretório raiz de um site é o diretório ou a pasta que segue o domínio de nível superior (por exemplo, example.com/ads.txt). Em example.com/ads.txt, example.com é o diretório raiz ou a pasta em que você faria upload do arquivo ads.txt.

Dica: se você não souber onde adicionar o arquivo ads.txt, acesse seu editor ou criador de sites para conferir instruções específicas. Você também pode entrar em contato com o serviço de hospedagem na Web para saber como fazer o upload no diretório raiz dos seus sites. Saiba mais sobre o diretório raiz.

Etapa 3b: verificar se você publicou o arquivo corretamente

Confira se o conteúdo do arquivo app-ads.txt está disponível. No navegador da Web, insira o URL do arquivo app-ads.txt (por exemplo, https://example.com/app-ads.txt). Se o arquivo app-ads.txt aparecer no seu navegador da Web, é provável que seja encontrado pela AdMob.

Rastreador do arquivo app-ads.txt da AdMob

O rastreador do app-ads.txt da AdMob procura o arquivo com base no site de desenvolvedor indicado na página Detalhes do app. De acordo com a especificação do app-ads.txt, os rastreadores procuram arquivos nos seguintes padrões de URL:

• https://<<nome do host>>/app-ads.txt
• http://<<nome do host>>/app-ads.txt

O nome do host é determinado pelo site do desenvolvedor associado ao seu app. Ele se refere ao domínio do site ou (em determinadas circunstâncias) a um subdomínio, conforme descrito abaixo.

A tabela a seguir mostra exemplos gerais de onde o rastreador da AdMob procurará um arquivo app-ads.txt para diferentes URLs de sites de desenvolvedores.

Se o site de desenvolvedor for:	O rastreador verifica na seguinte ordem:
https://example.com/game	https://example.com/app-ads.txt http://example.com/app-ads.txt
http://help.example.com/game	https://help.example.com/app-ads.txt http://help.example.com/app-ads.txt https://example.com/app-ads.txt http://example.com/app-ads.txt

Regras de subdomínio

A especificação do app-ads.txt tem regras próprias para subdomínios.

• Rastreamento até o subdomínio de primeiro nível
• Exclusão dos subdomínios "www." e "m."
• Redirecionamentos de servidor da Web

Rastreamento até o subdomínio de primeiro nível

Ao criar o URL do app-ads.txt, os rastreadores verificam até um nível de subdomínio no site de desenvolvedor.

Por exemplo:

Se o site de desenvolvedor for:	O rastreador verifica na seguinte ordem:
http://support.help.example.com/game	https://help.example.com/app-ads.txt http://help.example.com/app-ads.txt https://example.com/app-ads.txt http://example.com/app-ads.txt Observação: "help.example.com" está no primeiro nível de subdomínio e é usado para rastreamento, enquanto "support.help.example.com" está no segundo nível de subdomínio e não é usado para rastreamento.

Exclusão dos subdomínios "www." e "m."

A especificação exclui os subdomínios "www." e "m." como locais onde os rastreadores procuram os arquivos.

Se o site de desenvolvedor for:	O rastreador verifica na seguinte ordem:
https://www.example.com/game	https://example.com/app-ads.txt http://example.com/app-ads.txt
https://m.example.com/game	https://example.com/app-ads.txt http://example.com/app-ads.txt

Redirecionamentos de servidor da Web

Seu servidor da Web pode redirecionar o rastreador para um arquivo app-ads.txt hospedado em outro local, incluindo um subdomínio "www.".

Se o rastreador procurar um arquivo aqui:	Os destinos de redirecionamento válidos poderão incluir, entre outros:
https://example.com/app-ads.txt	O subdomínio "www." do seu site: https://www.example.com/app-ads.txt Outro subdomínio e subdiretório: https://static.example.com/files/app-ads.txt Outro subdomínio, subdiretório ou nome de arquivo: https://static.example.com/files/app-ads-1.txt Outro domínio, incluindo vários subdomínios: https://www.cdn.files.example.com/app-ads.txt

Para conferir se você publicou o arquivo corretamente, verifique se o conteúdo dele aparece ao acessar o URL do app-ads.txt no navegador da Web. Se você conseguir visualizar o arquivo no navegador da Web, é provável que os rastreadores o encontrem.

Confira os detalhes sobre as tentativas da AdMob de rastrear o arquivo app-ads.txt na sua conta da AdMob.

Etapa 4: aguardar a AdMob rastrear e verificar seu arquivo app-ads.txt

Pode levar até 24 horas para que a AdMob rastreie e verifique seus arquivos app-ads.txt. Ela costuma buscar o arquivo mais recente, mas você também pode solicitar o rastreamento do app para ter uma resposta mais rápida:

1. Faça login na sua conta da AdMob em https://admob.google.com.
2. Clique em Apps na barra lateral.
3. Clique em Todos os aplicativos.
4. Clique na guia app-ads.txt.

5. Na linha do app que você quer analisar, clique em para expandir. Isso mostra detalhes adicionais e a opção de solicitar que a AdMob rastreie seu app.

   

6. Clique em Verificar se há atualizações. Quando você solicita que a AdMob rastreie um arquivo app-ads.txt, ela atualiza o status de todos os apps que compartilham esse arquivo.
   • Em alguns casos, o botão "Verificar se há atualizações" pode estar indisponível. A AdMob costuma rastrear o arquivo mais recente para procurar atualizações.

Observação: pode levar até 24 horas para que a AdMob rastreie e verifique seus arquivos app-ads.txt. Aguarde esse prazo para que o status do app-ads.txt seja atualizado.

Se você adicionou um site de desenvolvedor ou atualizou a página Detalhes do app recentemente no Google Play, aguarde até 24 horas para a AdMob detectar essas mudanças.

Etapa 5: conferir se o arquivo app-ads.txt foi verificado na sua conta da AdMob

Você pode acessar o status e os detalhes do arquivo app-ads.txt de todos os seus apps na conta da AdMob.

Se o arquivo não for encontrado ou verificado, consulte as informações disponibilizadas na sua conta da AdMob ou saiba mais sobre solução de problemas do app-ads.txt.