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. 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 são rastreáveis por trocas, plataformas de fornecimento (SSPs), 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 do desenvolvedor do app. 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 que diferentes fornecedores de adtechs possam fazer o rastreamento. Há várias soluções de hospedagem de domínios 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 snippet de código abaixo no arquivo app-ads.txt. Substitua pub-00000000000000 pelo ID do editor. Seu ID de editor pode ser encontrado em AdMob Console > 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 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), use o Firebase Hosting para hospedar o arquivo app-ads.txt.

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 CLI do Firebase usando o npm (Gerenciador de pacotes do Node.js). No entanto, se você não conhece o Node.js, use o binário independente.

Acesse 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 seu 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 um projeto da lista 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 diretório local do projeto.

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

    firebase deploy --only hosting

  3. Depois que a implantação for concluída, acesse o URL a seguir 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" na loja

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

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

https://PROJECT_ID.web.app

Configurar as configurações de redirecionamento (opcional)

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

O Firebase Hosting vai usar public/index.html como página de destino por padrão quando um usuário visitar seu site. Para redirecionar os usuários para o 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 "Object de hospedagem", adicione o objeto de redirecionamento 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 do 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