Protocollo e dati di riferimento

Visualizza o scarica i file che supportano il protocollo RTB.

Proto

File Descrizione Versione Ultimo aggiornamento
cookie-bulk-upload.proto Utilizza questo messaggio per caricare collettivamente i dati di targeting per utente. v.24 27 marzo 2024
openrtb.proto Google supporta il protocollo OpenRTB, utilizzando la codifica JSON o Protobuf encoding. Questo proto è necessario se utilizzi OpenRTB/Protobuf. Include anche la documentazione dei campi supportati e il loro mapping al protocollo nativo di Google. 2.6 2 giugno 2026
openrtb-adx.proto Il protocollo OpenRTB di Google include alcune estensioni, fornite in un proto separato. v.207 13 aprile 2026
publisher-settings.proto Un insieme di impostazioni del publisher specifiche per una rete di offerenti in tempo reale. v.14 5 febbraio 2024

Proto beta aperta

File Descrizione Versione Ultimo aggiornamento
openrtb-adx.proto Il protocollo OpenRTB di Google include alcune estensioni, fornite in un proto separato. v.215 13 aprile 2026

Dati di riferimento

Dizionari (fai clic per scaricare il file .txt)
Categorie di prodotti pubblicitari Utilizzato nel excluded_product_category campo di BidRequest. Questo campo descrive le categorie di prodotti e servizi non consentite da un publisher, ad esempio se il publisher non vuole ospitare annunci relativi all'online banking.
Categorie di annunci soggette a limitazioni Utilizzato nel campo allowed_restricted_category di BidRequest e nel campo restricted_category di BidResponse. Il campo allowed_restricted_category descrive le categorie normalmente soggette a limitazioni, ma dichiarate esplicitamente consentite da un publisher, ad esempio gli annunci contenenti contenuti relativi all'alcol.
Categorie di annunci sensibili Utilizzato nel campo excluded_sensitive_category di BidRequest e nel campo category di BidResponse. Il campo excluded_sensitive_category descrive le categorie sensibili non consentite dal publisher, ad esempio se il publisher non vuole ospitare annunci relativi alla politica.
Inserzionisti Utilizzato nel campo advertiser_id di SnippetStatusItem. Questo campo specifica l'inserzionista rappresentato dalla creatività associata a lo snippet. Questo elenco riflette gli inserzionisti dell'exchange e non gli inserzionisti rappresentati da un singolo acquirente.
Brand Elenco di brand, utilizzato nell'API Accesso client.
Attributi delle creatività dichiarabili dall'acquirente Utilizzato per il campo attribute in BidResponse. Questo campo descrive gli attributi dichiarabili dall'acquirente nelle creatività che non devono essere visualizzati in excluded_attribute in BidRequest.
Codici di stato dei callout Codici di stato restituiti dalla chiamata al metodo performancereport.
Etichette dei contenuti Utilizzato nel campo detected_content_labels di BidRequest.
Codici di stato del matcher di cookie Utilizzato nel campo cookieMatcherStatusRate dei report sul rendimento del protocollo RTB. I codici disponibili sono descritti nella guida alla corrispondenza dei cookie.
Codici di stato delle creatività

Utilizzato in

creative_status_code restituito nel feedback in tempo reale.
Codici di stato della corrispondenza ospitata Utilizzato nel campo hostedMatchStatusRate dei report sul rendimento del protocollo RTB.
Motivi di nessuna offerta Valori standard dei motivi di nessuna offerta da indicare nel campo BidResponse.no_bid_reason nel protocollo di offerta di Authorized Buyers.
Attributi delle creatività pretargetizzabili Utilizzato nel campo supportedCreativeAttribute nella risorsa PretargetingConfig esposta nell'API REST per gli acquirenti. Questo campo descrive gli attributi delle creatività che devono essere presenti in tutte le creatività corrispondenti a una singola configurazione di pretargeting.
Attributi delle creatività escludibili dal publisher Utilizzato nel campo excluded_attribute di BidRequest. Questo campo descrive i tipi di creatività che non sono consentiti dal publisher. Ad esempio, potrebbe specificare restrizioni relative all'utilizzo dei cookie o se sono consentiti annunci di testo e/o multimediali.
Fornitori Utilizzato nel campo allowed_vendor_type di BidRequest. Questo campo elenca i fornitori di rich media consentiti per la creatività pubblicata, ad esempio Campaign Monitor e VoiceFive, come specificato dal publisher.

Include i fornitori del file dizionario ritirato gdn-vendors.txt.
Fornitori di dati Utilizzato nel campo SegmentData.id di BidRequest. Questo campo contiene informazioni sull'entità che ha fornito gli indicatori forniti dal publisher.

Tabelle di riferimento (fai clic per scaricare i file CSV)
App per dispositivi mobili Android Elenco delle app per dispositivi mobili Android targetizzabili con i relativi ID app, ID categoria, e nomi app leggibili.
Tabelle geografiche La tabella utilizzata per decodificare il geo_criteria_id campo di BidRequest. Per ulteriori informazioni, consulta la sezione Targeting geografico.
Fornitori LGPD L'elenco dei fornitori di personalizzazione degli annunci autorizzati a pubblicare annunci sul traffico LGPD, con il relativo ID, un nome leggibile, l'URL della privacy e un elenco di domini che possono essere attribuiti al fornitore. L'applicazione della LGPD è indicata in una determinata richiesta di offerta tramite il BidRequest.adslot.regs_lgpd campo nel protocollo di offerta di Authorized Buyers e il BidRequest.regs.ext.lgpd campo nel protocollo di offerta OpenRTB.
Operatori di telefonia mobile Elenco degli operatori di telefonia mobile.
Dispositivi mobili Elenco dei dispositivi mobili.
Sistemi operativi per dispositivi mobili Elenco dei sistemi operativi per dispositivi mobili.
Fornitori Mappa gli ID dei fornitori di personalizzazione degli annunci a un nome leggibile, a un URL delle norme sulla privacy e a un elenco di domini che possono essere attribuiti al fornitore. Attualmente, i fornitori vengono utilizzati nel BidRequest.AdSlot.consented_providers_settings campo per il protocollo AdX e BidRequest.User.UserExt.consented_providers_settings per il protocollo OpenRTB. In questi campi, i fornitori elencati hanno il consenso dell'utente come trasmesso da publisher per gli utenti nei paesi dello Spazio economico europeo.

Impostazioni publisher

Richiedi il file publisher-settings.pb.gz al tuo rappresentante dell'account.

Argomenti delle norme relative alla revisione delle creatività

Puoi utilizzare gli argomenti delle norme in questo file per filtrare le creatività durante la revisione nell'API Offerte in tempo reale

Scarica gli argomenti delle norme come file CSV.

Ultimo aggiornamento: 18 aprile 2022