Vendedores autorizados para apps (app-ads.txt)

O Authorized Sellers for Apps, também conhecido como app-ads.txt, é uma iniciativa do IAB que ajuda a proteger o inventário de anúncios do seu app contra fraudes. Você cria arquivos app-ads.txt para identificar quem tem autorização para vender seu inventário. Identificar vendedores autorizados pode ajudar você a receber gastos de anunciantes que poderiam ter sido direcionados a um inventário falsificado de apps de spoofing.

Os arquivos app-ads.txt estão disponíveis publicamente e são rastreáveis por trocas, plataformas de fornecimento (SSP), outros compradores e fornecedores terceirizados.

O uso do app-ads.txt não é obrigatório, mas é altamente recomendado, especialmente se você estiver preocupado que outras pessoas estejam fazendo spoofing do app.

Um arquivo app-ads.txt é um arquivo de texto que um desenvolvedor de apps posta no domínio raiz do site do desenvolvedor do aplicativo. Ele contém uma lista de entidades autorizadas a vender o inventário desse editor. O uso do arquivo app-ads.txt exige que os editores tenham um domínio da Web para publicar a lista de vendedores autorizados para diferentes fornecedores de tecnologia de anúncios. Há várias soluções de hospedagem de domínio que permitem a hospedagem arbitrária de arquivos, incluindo o Firebase.

Prerequisites

Como configurar o app-ads.txt para seus apps

  1. Se você ainda não fez isso, crie um arquivo de texto e salve-o com o nome ""app-ads.txt".

  2. Copie e cole o seguinte snippet de código no arquivo app-ads.txt. Substitua pub-00000000000000 pelo seu ID do editor. O ID do editor pode ser encontrado em Configurações do console da AdMob.

    google.com, pub-00000000000000, DIRECT, f08c47fec0942fa0
    
  3. Publique o arquivo app-ads.txt na raiz do seu site para desenvolvedores (por exemplo, https://example.com/app-ads.txt). Verifique se o domínio foi inserido exatamente como listado no Google Play e App Store.

  4. Aguarde pelo menos 24 horas para que a AdMob rastreie e verifique seu arquivo app-ads.txt.

  5. Volte para a AdMob e verifique o status do app-ads.txt.

Publicar o arquivo app-ads.txt com o Firebase Hosting

Se você tem um site que não permite o upload do arquivo app-ads.txt no nível raiz (por exemplo, um site criado e hospedado por um serviço de geração de sites), é possível usar o Firebase Hosting para hospedar esse arquivo.

O Firebase oferece uma maneira sem custo financeiro, rápida e confiável de hospedar seu arquivo app-ads.txt com seu próprio domínio personalizado ou nos subdomínios sem custo financeiro do projeto do Firebase: web.app e firebaseapp.com.

Antes de começar

Você precisará ter um projeto do Firebase para publicar o app-ads.txt com o Firebase Hosting. Se você não tiver um projeto do Firebase, crie um novo seguindo o guia do desenvolvedor.

Se você já vinculou seus apps da AdMob ao Firebase ou se seu app está usando um dos produtos do Firebase (por exemplo, Google Analytics para Firebase, Configuração remota etc.), você pode usar o projeto atual do Firebase.

Instale a CLI do Firebase

É possível instalar a CLI do Firebase usando o npm (Gerenciador de pacotes de nós). No entanto, se você não estiver familiarizado com o Node.js, poderá usar o binário autônomo.

Consulte a documentação da CLI do Firebase para saber como instalar a CLI ou atualizar para a versão mais recente.

Inicializar seu projeto

Para inicializar o projeto do Firebase na sua máquina local, execute o seguinte comando na raiz do diretório do seu projeto.

firebase init

Durante a inicialização do projeto, siga estas etapas dos prompts da Firebase CLI:

  1. Selecione para configurar o Hosting.

  2. Selecione um projeto do Firebase para conectar ao diretório do seu projeto local.

    Selecione Usar um projeto existente e escolha um projeto na lista que você quer conectar.

  3. Especifique um diretório para usar como diretório raiz público.

    Pressione Enter para selecionar uma opção padrão (pública).

  4. Escolha uma configuração para seu site.

    Como o site que você criará não é um app de página única, selecione N.

Ao final da inicialização, o Firebase cria e adiciona dois arquivos à raiz do diretório local do projeto:

  • Um diretório public que contém arquivos hospedados no seu site
  • Um arquivo de configuração firebase.json que lista a configuração do seu projeto.
  • Um arquivo .firebaserc que armazena seu alias de projeto.

Publicar o arquivo app-ads.txt

Para publicar o app-ads.txt no seu site, faça o seguinte:

  1. Coloque o arquivo app-ads.txt no diretório public no diretório do projeto local.

  2. Execute o seguinte comando na raiz do diretório do seu projeto local:

    firebase deploy --only hosting
  3. Após a conclusão da implantação, acesse o seguinte URL para verificar se o app-ads.txt foi publicado. PROJECT_ID é o ID do projeto do Firebase.

    https://PROJECT_ID.web.app/app-ads.txt

    Exemplo: se "awesome-project" for o ID do projeto, digite https://awesome-project.web.app/app-ads.txt na barra de endereço do seu navegador.

Adicionar o domínio/subdomínio à página "Detalhes do app"

Para que o arquivo app-ads.txt seja rastreado, você precisará listar o domínio ou subdomínio recém-criado na página "Detalhes do app" no Google Play ou App Store

Atualize o URL de marketing na página "Detalhes do app" da seguinte maneira:

https://PROJECT_ID.web.app

Definir as configurações de redirecionamento (opcional)

Se você já tem um site e planeja usar o Firebase Hosting apenas para hospedar o arquivo app-ads.txt, é possível configurá-lo para redirecionar a página de destino ao seu site atual.

Por padrão, o Firebase Hosting usa o public/index.html como página de destino quando um usuário acessa seu site. Para redirecionar os usuários ao site que você quer (por exemplo, a página de mídia social do app):

  1. Abra o arquivo firebase.json localizado na raiz do diretório do projeto local.

  2. Em "Objeto de hospedagem", adicione o objeto de redirecionamentos desta forma:

    "hosting": {
      ...
      "redirects": [
        {
          "source": "/",
          "destination": "URL_TO_REDIRECT",
          "type": 301
        }
      ]
    }
    

    Por exemplo, se o URL da página de destino for https://www.example.com, a configuração de redirecionamento será a seguinte:

    "hosting": {
      ...
      "redirects": [
        {
          "source": "/",
          "destination": "https://www.example.com",
          "type": 301
        }
      ]
    }
    
  3. Execute o comando a seguir para implantar as alterações no seu site.

    firebase deploy --only hosting
  4. Quando a implantação estiver concluída, acesse o site (https://PROJECT_ID.web.app) para verificar se a configuração de redirecionamento está correta ou não.

Recursos