Creare file ads.txt/app-ads.txt in Ad Manager

Questo articolo descrive come creare e gestire i file ads.txt e app-ads.txt utilizzando Google Ad Manager. Un file ads.txt specifica quali venditori sono autorizzati a vendere l'inventario pubblicitario per un sito web, mentre un file app-ads.txt fa lo stesso per le app.

La corretta implementazione di questi file è fondamentale per evitare perdite di entrate dovute a errori "Venditore non autorizzato (Ads.txt)" o "Venditore non autorizzato nella catena di fornitura", che possono impedire la spesa degli elementi pubblicitari.

Puoi creare file ads.txt/app-ads.txt per la tua rete su Ad Manager. Ad Manager genera contenuti per il file in base alle informazioni del venditore per la rete, fornisce la convalida della sintassi del file e consente di visualizzare i venditori autorizzati a vendere il tuo inventario.

Se stai creando un file ads.txt per un sito web, vai direttamente al Passaggio 1: crea il file ads.txt/app-ads.txt. Se stai invece creando un file app-ads.txt, continua con il prerequisito relativo alla definizione di un sito web dello sviluppatore.

Prerequisito per il file app-ads.txt: definire un sito web dello sviluppatore

Il sito web dello sviluppatore consente agli utenti di saperne di più sulle tue app e su altri contenuti. Inoltre, tramite il sito lo standard app-ads.txt identifica il proprietario di un'app. Devi inserire un link al tuo sito web dello sviluppatore nelle tue schede dello Store su Google Play o nell'App Store affinché Ad Manager e altre piattaforme pubblicitarie possano stabilire chi è il proprietario dell'app.

Non è necessario indicare l'URL completo di app-ads.txt nei dettagli dell'app nello store.

Se aggiungi o aggiorni un sito web dello sviluppatore all'interno di una scheda dello Store, il rilevamento di queste modifiche da parte di Ad Manager richiederà un po' di tempo:

Negozio	Tempo previsto
Google Play	Fino a 24 ore
Apple App Store	Fino a 7 giorni

Per aggiungere il sito web dello sviluppatore ai dettagli dell'app nello store:

Google Play Store

Aggiungi l'URL del sito web ai dati di contatto della scheda dell'app:

1. Accedi a Play Console.
2. Seleziona un'app.
3. Nel menu a sinistra, fai clic su Presenza nello Store e poi su Impostazioni dello Store.
4. Scorri fino a Dati di contatto scheda dello Store.
5. Aggiungi l'URL del sito web dello sviluppatore.

Apple App Store

Aggiungi il tuo sito web dello sviluppatore nel campo URL di marketing della scheda dello Store.

Store di TV connesse a Internet

Per alcuni store di TV connesse a Internet (CTV), potresti non essere in grado di associare il tuo app-ads.txt a un'app tramite il portale dello sviluppatore dello store perché quest'ultimo potrebbe non essere disponibile in alcune regioni. Ad esempio, gli store Samsung TV attualmente includono solo app statunitensi e non app CTV in Europa. Ad Manager collaborerà con gli acquirenti per assicurarsi che non forzino l'applicazione dello stato di autorizzazione app-ads.txt per le piattaforme CTV che al momento non supportano questo flusso di lavoro.

Passaggio 1: crea il file ads.txt/app-ads.txt in Ad Manager

Se hai la stessa scheda dell'app sia per l'app mobile Android sia per Android TV, il file app-ads.txt verrà applicato a entrambe le piattaforme. Aggiorna il file app-ads.txt di conseguenza.

1. Accedi a Google Ad Manager.

2. Fai clic su Amministrazione, poi su Gestione di Ads.txt.

   Perché tu possa visualizzare questa pagina, la rete Ad Manager deve avere almeno un account Ad Exchange collegato e al tuo utente deve essere assegnato a un ruolo dotato dell'autorizzazione "Gestione di Ads.txt".

3. Decidi se creare un file per il web o le app.
   • Per il web: fai clic sulla scheda ads.txt su web, quindi su Crea un file ads.txt.
   • Per le app: fai clic sulla scheda app-ads.txt, quindi su Crea un file ads.txt.
4. Nella finestra di dialogo, esamina il testo generato automaticamente fornito da Google.
   
   Ogni riga rappresenta un account venditore distinto che può essere autorizzato a vendere il tuo inventario. Per escludere un venditore e rimuovere l'autorizzazione, elimina la riga contenente le relative informazioni nella finestra di dialogo.
   Scopri come convalidare la sintassi di ads.txt/app-ads.txt.
   Il nostro generatore di file ads.txt/app-ads.txt può solo fornire informazioni per gli account venditore di Google. Sei responsabile di aggiungere le informazioni dagli account venditore sulle altre SSP o piattaforme di scambio con cui eventualmente collabori, per assicurare che le query siano autorizzate su quei domini. Assicurati di includere il loro dominio, il tuo ID venditore/publisher e il tipo di relazione (DIRECT o RESELLER).

   Per impostazione predefinita, le righe generate automaticamente potrebbero includere un valore "DIRECT" nel campo #3, che indica la presenza di una relazione diretta con l'account venditore. Se non possiedi e gestisci il dominio, aggiorna questo valore a "RESELLER". Se esistono voci in conflitto per lo stesso ID venditore (ad esempio, una contrassegnata come "DIRECT" e un'altra come "RESELLER"), in genere è sicuro rimuovere la riga "RESELLER" se possiedi direttamente l'inventario e hai un rapporto diretto con il venditore.

Passaggio 2: pubblica il file ads.txt/app-ads.txt sul sito web

5. Fai clic su uno dei seguenti pulsanti:
   • Copia testo negli appunti per copiare il testo e incollarlo nel tuo file ads.txt/app-ads.txt.
   • Scarica il file ads.txt come nuovo file di testo (.txt).
6. Invia il file al webmaster perché lo carichi sul tuo dominio principale (ad esempio, https://example.com/ads.txt o https://example.com/app-ads.txt).

Passaggio 3: controlla che il file ads.txt/app-ads.txt sia verificato

7. Trascorse 24 ore, assicurati che sia possibile eseguire la scansione del file ads.txt/app-ads.txt.
8. Ricontrolla a intervalli regolari lo stato di autorizzazione dei tuoi domini.

È tua responsabilità assicurare che il tuo file ads.txt/app-ads.txt sia corretto e aggiornato. Ti forniamo la convalida della sintassi, ma non possiamo impedirti di caricare un file formattato in modo errato o contenente account non collegati.

Risoluzione dei problemi comuni

• Errori relativi a venditori non autorizzati: se gli elementi pubblicitari non vengono pubblicati a causa di errori "Venditore non autorizzato (ads.txt)" o "Venditore non autorizzato nella catena di fornitura", verifica che il file ads.txt/app-ads.txt dichiari correttamente tutti i venditori autorizzati con il loro dominio, il tuo ID venditore/publisher specifico per quel venditore e il tipo di relazione corretto (DIRECT o RESELLER).
• Catena di fornitura incompleta: se le richieste di offerta vengono filtrate a causa di una catena di fornitura incompleta, assicurati che l'oggetto SupplyChain nella richiesta di offerta sia completo e indichi "complete": 1. inventorypartnerdomain nella richiesta di offerta deve essere dichiarato e corrispondere a una voce nel file ads.txt.
• sellers.json: anche se non fa direttamente parte di ads.txt, assicurati che il file sellers.json (se applicabile, spesso gestito dagli exchange con cui collabori) sia configurato correttamente e accessibile, in quanto integra ads.txt nel fornire trasparenza.

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