Ads.txt spiegato: cos’è e perché gli editori ne hanno bisogno

Ads.txt è un semplice file di testo, pubblicato nella directory principale del tuo sito web, che elenca tutte le aziende autorizzate a vendere o rivendere il tuo inventario pubblicitario. È uno dei file più semplici dell’ad tech – e uno dei più determinanti. Gli acquirenti lo controllano prima di fare un’offerta, la maggior parte delle fonti di domanda non servirà alcuna impression se non sei presente nel tuo file ads.txt, e una sola riga mancante o scritta male può tagliare fuori la domanda senza che te ne accorga. In questa guida spieghiamo cos’è ads.txt, come funziona, cosa significa ogni campo (con un esempio completo) e come si collocano standard correlati come sellers.json e app-ads.txt.

Cos’è Ads.txt?

Ads.txt è l’acronimo di Authorized Digital Sellers (venditori digitali autorizzati). È uno standard creato dall’IAB Tech Lab nel 2017 per combattere un tipo specifico di frode pubblicitaria: il domain spoofing. Prima di ads.txt, i truffatori potevano offrire inventario falso negli exchange programmatici, sostenendo che appartenesse a un sito premium – vendendo spazi pubblicitari “su nytimes.com” che in realtà non comparivano mai su quel sito. Gli acquirenti non avevano alcun modo affidabile per verificare se il venditore rappresentasse davvero il sito.

Ads.txt risolve il problema con una semplicità radicale. L’editore – l’unico a controllare ciò che è ospitato sul proprio dominio – pubblica un elenco leggibile dalle macchine dei venditori autorizzati a un indirizzo prevedibile: yourdomain.com/ads.txt. Se un venditore offre il tuo inventario ma non è nel tuo elenco, gli acquirenti considerano quell’inventario non autorizzato e lo ignorano.

Puoi vedere un esempio reale su quasi tutti i siti importanti – per esempio nytimes.com/ads.txt. L’adozione è quasi universale tra i siti monetizzati: lo standard è ormai un requisito di base della pubblicità programmatica e non più un extra facoltativo.

Come funziona Ads.txt

Il meccanismo coinvolge tre attori:

1. Gli editori dichiarano i propri venditori autorizzati nel file ads.txt, uno per riga, indicando anche l’ID dell’account che hanno presso ciascun venditore.
2. Gli acquirenti (DSP) analizzano regolarmente i file ads.txt in tutto il web e costruiscono una mappa delle coppie venditore-account autorizzate per ciascun dominio. Scopri di più su come operano gli acquirenti nella nostra guida alle demand-side platform.
3. Al momento dell’asta, quando arriva una bid request che dichiara di provenire dal tuo dominio tramite un certo exchange e un certo account venditore, l’acquirente la confronta con la mappa. Corrispondenza: l’acquirente può fare la sua offerta con sicurezza. Nessuna corrispondenza: la richiesta viene scartata perché non autorizzata.

Per questo gli errori in ads.txt costano denaro in entrambe le direzioni. Un truffatore non presente nel tuo elenco viene bloccato – bene. Ma anche un partner di domanda legittimo che manca dal tuo elenco viene bloccato, e il denaro che i suoi acquirenti avrebbero speso sul tuo inventario va altrove.

Perché Ads.txt è importante per i tuoi ricavi

Ads.txt è nato come misura antifrode, ma per gli editori di oggi fa semplicemente parte dell’infrastruttura dei ricavi:

• Gli acquirenti filtrano in base a esso. I principali DSP rifiutano o svalutano l’inventario che non può essere verificato tramite ads.txt. Nessun file – o un file sbagliato – significa meno offerenti in ogni asta, il che abbassa direttamente i tuoi CPM.
• Nella pratica è obbligatorio. Google AdSense e Ad Manager segnalano le voci mancanti o errate e smettono di servire annunci sull’inventario non verificato – e la maggior parte delle altre fonti di domanda si comporta allo stesso modo.
• Protegge il tuo brand. Nessuno può vendere in modo credibile inventario falso a nome del tuo dominio, quindi il tuo inventario legittimo mantiene il suo valore.
• Diventa più importante man mano che il tuo stack cresce. Con l’header bidding e più network pubblicitari in gioco, un singolo sito può avere legittimamente decine di voci – e ognuna deve essere corretta.

Sintassi di Ads.txt: cosa significa ogni campo

Ogni riga di dati in ads.txt contiene tre campi obbligatori e un campo facoltativo, separati da virgole:

google.com, pub-1234567890123456, DIRECT, f08c47fec0942fa0

I commenti iniziano con # e le righe vuote vengono ignorate. Da dove arrivano le righe? Non devi inventarle: ogni partner di domanda ti dice esattamente quali righe aggiungere. Google pubblica le tue in AdSense e Ad Manager, nelle impostazioni di ads.txt, e i partner di monetizzazione come Clickio forniscono un blocco completo che copre ogni fonte di domanda a cui ti collegano.

Esempio di Ads.txt: un file completo

Ecco come appare un file ads.txt realistico per un editore che lavora con Google e con un partner di monetizzazione:

# Ads.txt per example.com - ultimo aggiornamento YYYY-MM-DD
CONTACT=adops@example.com
OWNERDOMAIN=example.com
MANAGERDOMAIN=clickio.com

# Google - account diretto
google.com, pub-1234567890123456, DIRECT, f08c47fec0942fa0

# Fonti di domanda del partner di monetizzazione
rubiconproject.com, 12345, RESELLER, 0bfd66d529a55807
pubmatic.com, 156789, RESELLER, 5d62403b186f2ace
openx.com, 540123456, RESELLER, 6a698e2ec38604c6
appnexus.com, 3456, RESELLER, f5ab79cb980f11d1
indexexchange.com, 189012, RESELLER, 50b1c356f2c5c8fc

Gli ID qui sopra sono puramente illustrativi: copia sempre le righe esatte che ti forniscono i tuoi partner. Nota le righe con variabili in cima al file. CONTACT fa parte dello standard dal 2017; OWNERDOMAIN e MANAGERDOMAIN sono state aggiunte nella versione 1.1 (2022):

• CONTACT – un indirizzo email o un URL che gli acquirenti possono usare per contattare chi gestisce il file.
• OWNERDOMAIN – dichiara il dominio aziendale del proprietario del sito, così gli acquirenti possono raggruppare più siti sotto un unico proprietario. Utile quando i tuoi siti sono distribuiti su più domini.
• MANAGERDOMAIN – dichiara il dominio aziendale di un partner di monetizzazione principale o esclusivo che vende il tuo inventario e può essere impostato per singolo paese (ad esempio MANAGERDOMAIN=clickio.com, FR). Indica agli acquirenti chi gestisce la tua vendita pubblicitaria – e si abbina naturalmente alla delega di ads.txt, in cui lo stesso partner ospita e mantiene anche il file per te.

Come aggiungere Ads.txt al tuo sito web

1. Raccogli le voci. Chiedi a ogni partner di domanda le righe richieste. In Google AdSense o in Google Ad Manager, la sezione ads.txt mostra la tua riga esatta, compreso il tuo ID editore.
2. Crea un file di testo semplice chiamato ads.txt – UTF-8, senza formattazione, una voce per riga.
3. Caricalo nella directory principale del tuo dominio in modo che sia raggiungibile all’indirizzo https://yourdomain.com/ads.txt. Il percorso deve essere esattamente /ads.txt sul tuo dominio principale – i crawler controllano i sottodomini solo se il file principale rimanda a essi tramite la variabile SUBDOMAIN. Su WordPress puoi caricarlo con un plugin (o con il file manager del tuo hosting); molti plugin pubblicitari lo gestiscono anche al posto tuo.
4. Verifica che si carichi aprendo l’URL in un browser, poi passalo in un ads.txt checker per individuare eventuali errori di sintassi.
5. Tienilo aggiornato. Modifica il file ogni volta che aggiungi o rimuovi un partner di domanda – e aspettati che anche gli elenchi di reseller dei tuoi partner cambino nel tempo.

La specifica consente inoltre al tuo server di rispondere alle richieste di /ads.txt con un singolo redirect HTTP (301, 302 o 307) verso un file ospitato su un altro dominio. È così che funziona la delega: il tuo partner di monetizzazione ospita il file e lo mantiene aggiornato, mentre il tuo server si limita a reindirizzare verso di esso. Se mantenere il file a mano su uno o più siti ti sembra noioso – lo è – leggi la nostra guida completa alla gestione e delega di ads.txt.

Sellers.json: l’altra metà del quadro

Ads.txt permette agli acquirenti di verificare i venditori dal lato dell’editore. Sellers.json è lo standard speculare dal lato del sistema pubblicitario: ogni SSP e ad exchange pubblica un file JSON (ad esempio il sellers.json di Google) che elenca tutti i venditori – editori e intermediari – che paga, con i rispettivi ID e l’indicazione se ciascuno agisce come PUBLISHER, INTERMEDIARY o entrambi.

Insieme al SupplyChain object (un campo della bid request che elenca ogni passaggio attraverso cui è transitato l’inventario), i due standard permettono a un acquirente di ricostruire l’intero percorso di un’impression: il tuo ads.txt conferma chi può vendere il tuo inventario, e il sellers.json di ciascun sistema conferma chi pagano davvero. Gli acquirenti usano sempre più spesso questi dati per eliminare i percorsi di rivendita poco chiari – una pratica nota come supply path optimization. Per gli editori, la conclusione pratica è semplice: assicurati che i tuoi account siano rappresentati correttamente da entrambe le parti e mantieni trasparenti i rapporti con i venditori. I percorsi puliti ricevono più offerte.

App-ads.txt: la stessa idea per le app

App-ads.txt estende lo standard alle app mobile e CTV. Poiché un’app non ha un dominio proprio, il file si trova sul sito web dello sviluppatore – quello indicato nella scheda dell’app store – all’indirizzo /app-ads.txt. La sintassi è la stessa. Un errore comune: l’URL dello sviluppatore nella scheda dello store deve corrispondere esattamente al dominio che ospita il file, altrimenti i crawler non lo troveranno. Se monetizzi app o giochi HTML5 oltre ai siti web, ti servono entrambi i file.

Come convalidare Ads.txt (e gli errori da evitare)

Un ads.txt difettoso fallisce in silenzio: nulla si blocca, gli annunci continuano a essere serviti e i ricavi semplicemente scendono. Convalida il file ogni volta che lo modifichi e ricontrollalo periodicamente. Google segnala i problemi di ads.txt in AdSense e Ad Manager, e l’Ads.txt Checker gratuito di Clickio convalida l’ads.txt o l’app-ads.txt di qualsiasi dominio secondo la specifica IAB, segnalando errori e avvisi con il numero di riga esatto. Tieni presente che le modifiche non sono istantanee: i crawler ricontrollano il file con i propri tempi, quindi aspettati anche un giorno o più prima che una correzione abbia effetto. La piattaforma Clickio include il monitoraggio di ads.txt, che verifica continuamente il tuo file e ti avvisa quando mancano delle voci o il file diventa irraggiungibile.

Gli errori più comuni (e più costosi):

• Righe dei partner mancanti. Hai aggiunto un nuovo partner di domanda ma non hai aggiornato il file – tutta la sua domanda viene filtrata.
• ID editore sbagliato. Un errore di battitura nell’ID dell’account è grave quanto una riga mancante: gli ID nelle bid request non corrisponderanno.
• Errori di sintassi. Virgole mancanti, spazi vuoti dentro gli ID o voci incollate da un documento con la formattazione (virgolette tipografiche, caratteri invisibili).
• File non raggiungibile. Una migrazione del sito, una configurazione errata dei redirect o una regola della CDN possono far restituire un errore 404 a /ads.txt – dopodiché i crawler finiscono per considerare tutto il tuo inventario non verificabile.
• Voci obsolete. Righe di partner con cui non lavori più. Oltre a ingombrare il file, rappresentano autorizzazioni ancora attive che non riflettono più la realtà – eliminale.
• Tipo di relazione sbagliato. Indicare un reseller come DIRECT (o viceversa) dichiara in modo errato la tua supply chain e può far segnalare i percorsi durante le revisioni della supply path degli acquirenti.

Lascia che sia Clickio a occuparsene

Clickio collega gli editori a decine di fonti di domanda – tra cui Google AdX e le principali SSP – e in questo modo ti toglie dalle mani la gestione di ads.txt. La piattaforma genera l’insieme completo delle voci richieste, monitora il tuo file in modo continuo e, con la delega di Ads.txt, può ospitare e aggiornare il file in automatico, così resta corretto al variare del panorama della domanda. La configurazione richiede pochi minuti.