Configure um ficheiro app-ads.txt para a sua app

Para que o AdMob encontre e valide o ficheiro app-ads.txt:

• A sua app tem de estar registada na Google Play Store ou Apple App Store
• A ficha da loja de apps tem de incluir um Website do programador, conforme explicado abaixo.

Configure um ficheiro app-ads.txt para a sua app:

• Passo 1: configure um Website do programador
• Passo 2: crie o ficheiro app-ads.txt
• Passo 3: publique o ficheiro app-ads.txt no Website do programador
• Passo 4: aguarde que o AdMob rastreie e valide o ficheiro app-ads.txt
• Passo 5: verifique se o ficheiro app-ads.txt está validado na sua conta do AdMob

Passo 1: configure um Website do programador

Um Website do programador permite aos utilizadores saber mais acerca das apps e de outro conteúdo. É também assim que a norma app-ads.txt estabelece quem é o proprietário de uma app. O Website do programador tem de estar associado às suas fichas da loja no Google Play ou na App Store para que o AdMob e outras plataformas de publicidade estabeleçam a propriedade da app.

Se, atualmente, não tiver um Website configurado para a sua empresa de desenvolvimento de apps, terá de configurar um Website antes de poder usar o ficheiro app-ads.txt. Estão disponíveis várias opções de alojamento Web gratuitas e pagas.

Se não tiver um Website adequado que permita o carregamento de um ficheiro app-ads.txt ao nível da raiz, pode usar o Firebase Hosting para alojar o ficheiro app-ads.txt. Saiba como publicar o app-ads.txt com o Firebase Hosting.

Uma vez configurado, atualize a ficha da sua app nas lojas de apps para incluir o Website do programador no URL de contacto do programador. Opcionalmente, poderá publicar nesse Website todas as informações de marketing e de apoio técnico relevantes para a sua app.

Nota: não é necessário listar o URL completo do app-ads.txt na Ficha da loja de apps. O AdMob usa a parte do nome do anfitrião (domínio) do URL do Website para rastrear o seu ficheiro app-ads.txt. Saiba como encontramos o ficheiro app-ads.txt.

Passo 1a: adicione o Website do programador à Ficha da loja de apps

Para adicionar o Website do programador à sua ficha da loja de apps:

• Para o Google Play: adicione o URL do Website nas informações de contacto da ficha da loja de apps:
  1. Inicie sessão na Play Console.
  2. Selecione uma app.
  3. No menu do lado esquerdo, clique em Presença na loja e, de seguida, em Definições da loja.
  4. Desloque a página até Detalhes de contacto da Ficha da loja.
  5. Adicione o URL do Website do programador. Para confirmar que adicionou o URL com êxito, verifique se o URL do Website do programador está associado ao "apoio técnico da app" da página da app Android.
     Nota: se adicionou ou atualizou o Website do programador na ficha da loja de apps no Google Play, aguarde até 24 horas para que o AdMob detete estas alterações.

• Para a App Store da Apple: adicione o Website do programador no campo do URL de marketing da ficha da loja de apps. Pode editar o campo do URL de marketing quando lançar uma nova versão da sua app iOS ou quando lançar uma nova app na loja de apps, no campo de informações da app. Para confirmar que adicionou o URL com êxito, verifique se o link "Website do programador" é apresentado na parte inferior da página da app iOS.

Passo 2: crie o ficheiro app-ads.txt

Se o seu site não tiver um ficheiro app-ads.txt, pode criar um. Para ser validado, o ficheiro ads.txt tem de incluir o seu ID de publicador formatado corretamente. Crie um ficheiro de texto (.txt) usando um editor de texto simples, como o Bloco de notas (Windows) ou o Editor de Texto (Mac). Tem de adicionar o fragmento do código personalizado ao ficheiro app-ads.txt.

Veja um exemplo de ficheiro app-ads.txt:

# app-ads.txt example file:

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

No exemplo anterior:

• google.com é um Ad Exchange
• pub-0000000000000000 é o ID da conta/publicador
• DIRECT é o tipo de relação

Nota: o ficheiro app-ads.txt tem de estar formatado conforme as especificações do IAB Tech Lab para ser validado. Se precisar de ajuda adicional, reveja a especificação dos Vendedores de apps autorizados fornecida pelo IAB Tech Lab.

Passo 2a: adicione o fragmento do código personalizado ao ficheiro app-ads.txt

O AdMob fornece um fragmento do código personalizado que facilita a configuração do ficheiro app-ads.txt. O fragmento do código personalizado inclui o seu ID de publicador. 

Nota: para ser validado, o ficheiro app-ads.txt tem de incluir o seu ID de publicador formatado corretamente.

Para ter o seu fragmento do código personalizado, que inclui o ID de publicador:

1. Inicie sessão na sua conta do AdMob em https://admob.google.com.
2. Clique em Apps na barra lateral.
3. Clique em Ver todas as apps.
4. Clique em app-ads.txt.
5. Clique em Como configurar o ficheiro app-ads.txt. 
6. Clique em junto ao fragmento do código a copiar.
7. Cole o fragmento do código no ficheiro app-ads.txt.

Passo 2b (opcional): adicione outros IDs de vendedor autorizado ao ficheiro app-ads.txt

Se estiver a usar outra rede de publicidade, não se esqueça de a adicionar ao ficheiro app-ads.txt. Isto permite que o seu vendedor de terceiros também encontre e valide o ficheiro app-ads.txt. Contacte a rede de publicidade para obter as informações que deve incluir no ficheiro app-ads.txt. 

Passo 3: publique o ficheiro app-ads.txt no Website do programador

Passo 3a: carregue o ficheiro app-ads.txt para o diretório raiz do Website do programador

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 ou a pasta raiz para o qual carregaria o ficheiro ads.txt.)

Sugestão: se não souber onde adicionar o ficheiro ads.txt, aceda ao criador ou editor de sites para receber instruções específicas. Também pode contactar o seu serviço de alojamento Web para saber como carregar ficheiros para o diretório raiz dos seus sites. Saiba mais sobre o diretório raiz.

Passo 3b: confirme se publicou o ficheiro corretamente

Verifique se o conteúdo do ficheiro app-ads.txt está disponível. No navegador de Internet, introduza o URL do ficheiro app-ads.txt (por exemplo, https://example.com/app-ads.txt). Se o ficheiro app-ads.txt for apresentado no seu navegador de Internet, é provável que o AdMob o encontre com êxito.

Motor de rastreio do app-ads.txt do AdMob

O motor de rastreio de app-ads.txt do AdMob procura o ficheiro app-ads.txt com base no Website do programador na Ficha da loja da sua app. De acordo com a especificação do app-ads.txt, os motores de rastreio procuram ficheiros nos seguintes padrões do URL:

• https://<<hostname>>/app-ads.txt
• http://<<hostname>>/app-ads.txt

O nome do anfitrião é determinado a partir do Website de programador da sua app. Este é o domínio ou (em determinadas circunstâncias) um subdomínio do Website, conforme descrito abaixo.

A tabela seguinte apresenta exemplos gerais de onde o motor de rastreio do AdMob irá procurar um ficheiro app-ads.txt para diferentes URLs de Websites de programadores.

Se o Website do programador for:	O motor de rastreio faz a verificação pela ordem seguinte:
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ínios

A especificação do app-ads.txt tem regras específicas relativamente aos subdomínios

• Rastreio até ao subdomínio de primeiro nível
• Exclusão de subdomínios "www." e "m."
• Redirecionamentos do servidor Web

Rastreio até ao subdomínio de primeiro nível

Os motores de rastreio verificam até um nível de subdomínio do Website do programador quando criam um URL de app-ads.txt.

Por exemplo:

Se o Website do programador for:	O motor de rastreio faz a verificação pela ordem seguinte:
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 Nota: "help.example.com" está no primeiro nível de subdomínio e é usado para rastreio, enquanto "support.help.example.com" está no segundo nível de subdomínio e não é usado para rastreio.

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

A especificação exclui subdomínios "www." e "m." enquanto localizações onde os motores de rastreio procuram ficheiros.

Se o Website do programador for:	O motor de rastreio faz a verificação pela ordem seguinte:
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 do servidor Web

O seu servidor Web pode redirecionar o motor de rastreio para um ficheiro app-ads.txt alojado noutro local (incluindo um subdomínio "www.").

Se o motor de rastreio procurar um ficheiro aqui:	Os destinos de redirecionamento válidos podem incluir, entre outros:
https://example.com/app-ads.txt	O subdomínio "www." do seu website: 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 ficheiro: 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 verificar se publicou o ficheiro corretamente, confirme se consegue ver o conteúdo do app-ads.txt quando acede ao respetivo URL no navegador de Internet. Se conseguir ver o ficheiro no navegador de Internet, é provável que os motores de rastreio o encontrem com êxito.

Veja os detalhes acerca das tentativas de o AdMob rastrear o ficheiro app-ads.txt na sua conta do AdMob.

Passo 4: aguarde que o AdMob rastreie e valide o ficheiro app-ads.txt

O AdMob pode demorar até 24 horas a rastrear e a validar os ficheiros app-ads.txt. O AdMob verifica regularmente o ficheiro mais recente, mas também pode pedir ao AdMob que rastreie a sua app para ter uma resposta mais rápida:

1. Inicie sessão na sua conta do AdMob em https://admob.google.com.
2. Clique em Apps na barra lateral.
3. Clique em Ver todas as apps.
4. Clique em app-ads.txt.

5. Na linha da app que quer rever, clique em  para a expandir. Esta ação abre detalhes adicionais e permite pedir ao AdMob que rastreie a sua app.

   

6. Clique em Procurar atualizações. Quando pede ao AdMob que rastreie um ficheiro app-ads.txt, o AdMob atualiza o estado de todas as apps que partilham o mesmo ficheiro app-ads.txt.
   • Em alguns casos, o botão "Procurar atualizações" pode não estar disponível. Tenha em atenção que o AdMob rastreia regularmente o seu ficheiro mais recente para verificar se existem atualizações.

Nota: o AdMob pode demorar até 24 horas a rastrear e a validar os ficheiros app-ads.txt. Tem de aguardar, pelo menos, 24 horas para que o estado do app-ads.txt seja atualizado.

Se adicionou recentemente o seu Website do programador ou atualizou a ficha da app no Google Play, aguarde até 24 horas para que o AdMob detete estas alterações.

Passo 5: verifique se o ficheiro app-ads.txt está validado na sua conta do AdMob

Pode ver o estado e os detalhes do ficheiro app-ads.txt de todas as suas apps na conta do AdMob.

Se não foi possível encontrar nem validar o ficheiro, reveja as informações fornecidas na sua conta do AdMob ou saiba mais acerca da resolução de problemas do ficheiro app-ads.txt.