Google mette a disposizione gli elenchi di impostazioni dei publisher aggregati caricandoli in un bucket Google Cloud Storage specifico per l'account (in un progetto di proprietà di Google). Puoi scaricarli per utilizzarli per il targeting che non possono essere eseguiti al momento dell'offerta. Rivolgiti al tuo account manager tecnico per abilitare questa funzionalità per il tuo account.
I file contenenti impostazioni dei publisher possono essere scaricati in modo programmatico mediante l'API Cloud Storage, manualmente tramite l'interfaccia utente di Google Developers Console o utilizzando lo strumento a riga di comando gsutil. Consulta la documentazione di Google Cloud Storage per ulteriori dettagli sull'accesso ai dati archiviati in Google Cloud Storage.
Il file è compresso con gzip secondo RFC 1952. Per estrarre il file dalla riga di comando, esegui gzip -d <filename>. Per estrarre il file in modo programmatico, puoi utilizzare zlib o una libreria di compressione simile che supporti il formato gzip. Il risultato è un buffer di protocollo serializzato, simile al payload della richiesta POST in un BidRequest, che può essere analizzato con il seguente snippet:
string compressed = /* the payload from the GET request */;
string uncompressed = gunzip(compressed);
PublisherSettingsList publisher_settings;
if (publisher_settings.ParseFromString(uncompressed)) {
// Process the publisher settings.
}
La definizione del buffer di protocollo per PublisherSettingsList può essere scaricata dalla pagina dei dati di riferimento. Puoi anche richiedere un file publisher-settings.pb.gz compresso dal rappresentante del tuo account. Contiene la definizione del buffer di protocollo e un file di impostazioni del publisher di esempio.
L'ordine di PublisherSettingsList può cambiare in qualsiasi momento.
Non è garantito alcun ordine o ordinamento specifico. Ogni voce nell'elenco delle impostazioni dell'editore contiene un identificatore e diverse impostazioni che si applicano a BidRequests con tale identificatore. Puoi aggiungere una funzionalità ai sistemi di offerta per verificare periodicamente la presenza di un nuovo elenco di impostazioni del publisher.
Quando riceve un'impressione idonea per le offerte in tempo reale, Google include nella richiesta di offerta gli identificatori che corrispondono alle voci nell'elenco delle impostazioni del publisher. Il tuo sistema di offerta può utilizzare le impostazioni del publisher per filtrare gli annunci candidati per l'impressione in questione. Per essere idoneo per una determinata impressione, l'annuncio candidato deve rispettare tutte le voci di impostazione del publisher per cui sono stati inviati identificatori nella richiesta.
Tieni presente che le impostazioni del publisher mancanti nel file sono dovute al fatto che gli identificatori non hanno URL bloccati associati.
Il file delle impostazioni del publisher viene suddiviso in più file più piccoli per ridurre la quantità di dati che devono essere scaricati in una singola transazione. I file sono suddivisi in circa 5 MB blocchi e nomi da publisher-settings.0.pb.gz a publisher-settings.n.pb.gz (dove n è il numero di file meno uno). Contatta il rappresentante del tuo account per ottenere questi file.