Authorized Sellers for Apps (app-ads.txt)

Authorized Sellers for Apps, noto anche come app-ads.txt, è un'iniziativa IAB che consente di proteggere l'inventario pubblicitario della tua app da frodi negli annunci. Puoi creare file app-ads.txt per identificare chi è autorizzato a vendere l'inventario. L'identificazione dei venditori autorizzati ti consente di ricevere una quota di spesa pubblicitaria che altrimenti sarebbe passata all'inventario contraffatto delle app soggette a spoofing.

I file app-ads.txt sono disponibili pubblicamente e possono essere sottoposti a scansione da parte di piattaforme di scambio pubblicitario, SSP (Supply-Side Platform), altri acquirenti e fornitori di terze parti.

L'utilizzo di app-ads.txt non è obbligatorio, ma caldamente consigliato, in particolare se ritieni che altri possano effettuare lo spoofing della tua app.

Un file app-ads.txt è un file di testo che uno sviluppatore di app pubblica nel dominio principale del sito web per sviluppatori della sua app. Contiene un elenco di entità autorizzate a vendere l'inventario del publisher. L'utilizzo del file app-ads.txt richiede che i publisher dispongano di un dominio web per pubblicare l'elenco dei venditori autorizzati per consentire ai diversi fornitori di tecnologia pubblicitaria di eseguire la scansione. Esistono diverse soluzioni di hosting di domini che consentono l'hosting arbitrario di file, tra cui Firebase.

Prerequisiti

Come configurare il file app-ads.txt per le tue app

  1. Se non l'hai ancora fatto, crea un file di testo e salvalo con il nome "app-ads.txt".

  2. Copia e incolla il seguente snippet di codice nel file app-ads.txt. Sostituisci pub-00000000000000 con il tuo ID publisher. Il tuo ID publisher è disponibile nella console AdMob > Impostazioni.

    google.com, pub-00000000000000, DIRECT, f08c47fec0942fa0
    
  3. Pubblica il file app-ads.txt nel dominio principale del sito web dello sviluppatore (ad esempio, https://example.com/app-ads.txt). Assicurati che il dominio sia stato inserito esattamente come indicato in Google Play.

  4. Attendi almeno 24 ore prima che AdMob esegua la scansione e la verifica del file app-ads.txt.

  5. Torna ad AdMob e verifica lo stato di app-ads.txt.

Pubblicare app-ads.txt con Firebase Hosting

Se hai un sito web che non consente il caricamento del file app-ads.txt a livello della directory principale (ad esempio un sito creato e ospitato da un servizio di generazione di siti), puoi utilizzare Firebase Hosting per ospitare il file app-ads.txt.

Firebase offre un modo senza costi, veloce e affidabile per ospitare il file app-ads.txt nel tuo dominio personalizzato o nei sottodomini senza costi del progetto Firebase: web.app e firebaseapp.com.

Prima di iniziare

Per pubblicare app-ads.txt con Firebase Hosting, devi avere un progetto Firebase. Se non hai un progetto Firebase, creane uno nuovo seguendo la guida per gli sviluppatori.

Se hai già collegato le tue app AdMob a Firebase o la tua app utilizza uno dei prodotti Firebase (ad es. Google Analytics for Firebase, Remote Config, ecc.), puoi utilizzare il progetto Firebase esistente.

Installa l'interfaccia a riga di comando di Firebase

Puoi installare l'interfaccia a riga di comando di Firebase utilizzando npm (Node Package Manager). Tuttavia, se non hai familiarità con Node.js, puoi utilizzare il binario autonomo.

Visita la documentazione dell'interfaccia a riga di comando di Firebase per scoprire come installare l'interfaccia a riga di comando o aggiornarla all'ultima versione.

Inizializza il progetto

Per inizializzare il progetto Firebase nella tua macchina locale, esegui il seguente comando dalla radice della directory del progetto.

firebase init

Durante l'inizializzazione del progetto, dai prompt dell'interfaccia a riga di comando di Firebase:

  1. Seleziona per configurare l'hosting.

  2. Seleziona un progetto Firebase da connettere alla directory del progetto locale.

    Seleziona Utilizza un progetto esistente, quindi scegli dall'elenco un progetto a cui vuoi connetterti.

  3. Specifica una directory da utilizzare come directory principale pubblica.

    Premi Invio per selezionarne uno predefinito (pubblico).

  4. Scegli una configurazione per il tuo sito.

    Poiché il sito web che stai per creare non è un'app di una sola pagina, seleziona N.

Al termine dell'inizializzazione, Firebase crea e aggiunge due file alla radice della directory del progetto locale:

  • Una directory public che contiene i file ospitati sul tuo sito web.
  • Un file di configurazione firebase.json che elenca la configurazione del progetto.
  • Un file .firebaserc che memorizza l'alias del progetto.

Pubblica app-ads.txt

Per pubblicare il file app-ads.txt sul tuo sito:

  1. Inserisci il file app-ads.txt nella directory public della directory del progetto locale.

  2. Esegui questo comando dalla directory principale del tuo progetto locale:

    firebase deploy --only hosting
  3. Una volta completato il deployment, visita il seguente URL per assicurarti che app-ads.txt sia pubblicato. (PROJECT_ID è l'ID progetto Firebase).

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

    Esempio: se "awesome-project" è l'ID progetto, inserisci https://awesome-project.web.app/app-ads.txt nella barra degli indirizzi del browser.

Aggiungere il dominio/sottodominio alla scheda del negozio della tua app

Affinché il file app-ads.txt venga sottoposto a scansione, devi elencare il dominio o sottodominio appena creato nella scheda della tua app su Google Play.

Aggiorna il sito web sviluppatore nella scheda dello store come segue:

https://PROJECT_ID.web.app

Configurare le impostazioni di reindirizzamento (facoltativo)

Se hai un sito web esistente e prevedi di utilizzare Firebase Hosting solo per ospitare il file app-ads.txt, puoi configurare Firebase Hosting in modo da reindirizzare la pagina di destinazione al tuo sito web esistente.

Firebase Hosting utilizzerà public/index.html come pagina di destinazione per impostazione predefinita quando un utente visita il tuo sito. Per reindirizzare gli utenti al sito web che preferisci (ad esempio, la pagina dei social media della tua app):

  1. Apri il file firebase.json che si trova nella directory principale del progetto locale.

  2. In hosting object, aggiungi l'oggetto reindirizzamenti nel seguente modo:

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

    Ad esempio, se l'URL pagina di destinazione è https://www.example.com, la configurazione del reindirizzamento sarà la seguente:

    "hosting": {
      ...
      "redirects": [
        {
          "source": "/",
          "destination": "https://www.example.com",
          "type": 301
        }
      ]
    }
    
  3. Esegui questo comando per eseguire il deployment delle modifiche al tuo sito.

    firebase deploy --only hosting
  4. Una volta completato il deployment, accedi al tuo sito (https://PROJECT_ID.web.app) per verificare se l'impostazione di reindirizzamento è corretta o meno.

Risorse