Vendedores autorizados do inventário de anúncios de 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. Com ele, você cria arquivos app-ads.txt para identificar quem está autorizado a vender seu inventário. Ao identificar vendedores autorizados, você recebe receitas de anunciantes que poderiam ter sido direcionadas a um inventário falsificado ou aplicativos com spoofing.

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

O uso do app-ads.txt não é obrigatório, mas é altamente recomendado, principalmente se você tiver alguma suspeita de falsificação do seu aplicativo.

Um arquivo app-ads.txt é um arquivo de texto que um desenvolvedor de apps publica no domínio raiz do site de desenvolvedor do app. Ela 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 que diferentes fornecedores de adtech podem rastrear. Há várias soluções de hospedagem de domínio que permitem a hospedagem arbitrária de arquivos, incluindo o Firebase.

Pré-requisitos

Como configurar o app-ads.txt para seus apps

  1. Crie um arquivo de texto e salve-o com o nome "app-ads.txt", caso ainda não tenha feito isso.

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

    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 você digitou o domínio exatamente como ele aparece no Google Play e na App Store.

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

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

Publicar o app-ads.txt com o Firebase Hosting

Se você tiver um site que não permite o upload do arquivo app-ads.txt na raiz (por exemplo, um site criado e hospedado por um serviço de geração de sites), hospede-o no Firebase Hosting.

O Firebase oferece uma maneira sem custo financeiro, rápida e confiável de hospedar o 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ê precisa 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 para desenvolvedores.

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

instalar a CLI do Firebase

É possível instalar a Firebase CLI usando o npm (gerenciador de pacotes do Node.js). No entanto, se você não conhece o Node.js, use o binário independente.

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

Inicializar seu projeto

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

firebase init

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

  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 na lista o projeto que você quer conectar.

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

    Pressione Enter para selecionar um padrão (público).

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

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

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

  • 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 o alias do projeto.

Publicar o app-ads.txt

Para publicar o app-ads.txt no seu site:

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

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

    firebase deploy --only hosting
  3. Depois que a implantação for concluída, acesse o seguinte URL para verificar se o app-ads.txt foi publicado. (PROJECT_ID é o ID do seu 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 navegador.

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

Para que seu arquivo app-ads.txt seja rastreado, liste o domínio ou subdomínio recém-criado na página do app no Google Play ou na App Store.

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

https://PROJECT_ID.web.app

Configurar as opções de redirecionamento (opcional)

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

O Firebase Hosting usa public/index.html como página de destino por padrão quando um usuário visita seu site. Para redirecionar os usuários ao site que você quer (por exemplo, a página de mídia social do seu 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 da seguinte maneira:

    "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 mudanças no seu site.

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

Recursos