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 al pubblico e possono essere sottoposti a scansione da parte di piattaforme di scambio pubblicitario, supply-side platform (SSP), 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 persone giuridiche 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 da eseguire la scansione da parte di diversi fornitori di tecnologia pubblicitaria. Esistono diverse soluzioni di hosting di dominio 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. Puoi trovare il tuo ID publisher in 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 nell'App Store.

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

  5. Torna ad AdMob e controlla lo stato del file 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 con il tuo dominio personalizzato o sui sottodomini senza costi del progetto Firebase: web.app e firebaseapp.com.

Prima di iniziare

Per pubblicare il file 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 se la tua app utilizza uno dei prodotti Firebase (ad es. Google Analytics per Firebase, Remote Config e così via), 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 dimestichezza con Node.js, puoi utilizzare il file binario autonomo.

Consulta la documentazione dell'interfaccia a riga di comando di Firebase per scoprire come installarla o aggiornarla alla versione più recente.

Inizializza il progetto

Per inizializzare il progetto Firebase nella tua macchina locale, esegui il seguente comando dalla directory principale 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 collegare alla directory del progetto locale.

    Seleziona Utilizza un progetto esistente, quindi scegli un progetto dall'elenco da collegare.

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

    Premi Invio per selezionare una predefinita (pubblica).

  4. Scegli una configurazione per il tuo sito.

    Poiché il sito web che stai per creare non è un'app a pagina singola, seleziona N.

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

  • Una directory public contenente 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.

Pubblicare il file 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 il seguente comando dalla directory principale del progetto locale:

    firebase deploy --only hosting
  3. Al termine del deployment, visita il seguente URL per assicurarti che il file app-ads.txt sia stato pubblicato. (PROJECT_ID è l'ID progetto Firebase).

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

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

Aggiungere il dominio/sottodominio alla scheda dello Store dell'app

Affinché il file app-ads.txt venga sottoposto a scansione, dovrai elencare il dominio o il sottodominio appena creato nella scheda dell'app sull'App Store.

Aggiorna l'URL di marketing nella scheda dello Store come segue:

https://PROJECT_ID.web.app

(Facoltativo) Configura le impostazioni di reindirizzamento

Se hai già un sito web 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.

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

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

  2. Nell'oggetto di hosting, aggiungi l'oggetto reindirizzamenti come segue:

    "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 il seguente comando per eseguire il deployment delle modifiche sul tuo sito.

    firebase deploy --only hosting
  4. Al termine del deployment, accedi al tuo sito (https://PROJECT_ID.web.app) per verificare se l'impostazione di reindirizzamento è corretta.

Risorse