Protocollo e dati di riferimento

Visualizzare o scaricare file che supportano il protocollo RTB.

Protos

File Descrizione Versione Ultimo aggiornamento
cookie-bulk-upload.proto Utilizza questo messaggio per caricare collettivamente i dati di targeting degli utenti. v.24 27 mar 2024
openrtb.proto Google supporta il protocollo OpenRTB, utilizzando la codifica JSON o Protobuf. Questo proto è necessario se utilizzi OpenRTB/Protobuf. Include anche la documentazione dei campi supportati e la loro mappatura al protocollo nativo di Google. 2.6 23 giugno 2025
openrtb-adx.proto Il protocollo OpenRTB di Google include alcune estensioni, fornite in un proto separato. v.191 8 luglio 2025
publisher-settings.proto Un insieme di impostazioni del publisher specifiche per una rete di offerenti in tempo reale. v.14 5 feb 2024
realtime-bidding.proto Avviso: questo protocollo verrà ritirato a partire dal 1° maggio 2025. Se non l'hai ancora fatto, Google consiglia vivamente di eseguire la migrazione a OpenRTB il prima possibile per ridurre al minimo le interruzioni dell'integrazione di Real Time Bidding. v.333 4 giu 2025

Open Beta Protos

File Descrizione Versione Ultimo aggiornamento
openrtb-adx.proto Il protocollo OpenRTB di Google include alcune estensioni, fornite in un proto separato. v.198 8 luglio 2025
realtime-bidding.proto Avviso: questo protocollo verrà ritirato a partire dal 1° maggio 2025. Se non l'hai ancora fatto, Google consiglia vivamente di eseguire la migrazione a OpenRTB il prima possibile per ridurre al minimo le interruzioni dell'integrazione di Real Time Bidding. v.344 4 giu 2025

Dati di riferimento

Dizionari (fai clic per scaricare il file .txt)

Categorie di prodotti pubblicitari Utilizzato nel campo excluded_product_category di BidRequest. Questo campo descrive le categorie di prodotti e servizi non consentiti da un publisher, ad esempio se il publisher non vuole ospitare annunci correlati all'online banking.
Categorie di annunci con 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 da un publisher come consentite, ad esempio gli annunci contenenti contenuti correlati all'alcol.
Categorie sensibili degli annunci 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 correlati alla politica.
Inserzionisti Utilizzato nel campo advertiser_id di SnippetStatusItem. Questo campo specifica l'inserzionista rappresentato dalla creatività associata allo snippet. Questo elenco riflette gli inserzionisti dell'exchange e non riflette gli inserzionisti rappresentati da un singolo acquirente.
Brand Elenco dei brand utilizzati nell'API Client Access.
Attributi della 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 del BidRequest.
Codici di stato del matcher dei 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 è stato restituito in tempo reale feedback.
Codici di stato della corrispondenza ospitata Utilizzato nel campo hostedMatchStatusRate dei report sul rendimento del protocollo RTB.
Motivi nessuna offerta Valori standard del motivo di mancata offerta da indicare nel campo BidResponse.no_bid_reason del protocollo di offerta Authorized Buyers.
Attributi delle creatività pre-targetizzabili Utilizzato nel campo supportedCreativeAttribute della risorsa PretargetingConfig esposta nell'API REST per gli acquirenti. Questo campo descrive gli attributi della creatività che devono essere presenti in tutte le creatività corrispondenti a una singola configurazione di pretargeting.
Attributi delle creatività escludibili dai publisher Utilizzato nel campo excluded_attribute di BidRequest. Questo campo descrive i tipi di creatività che non sono consentiti dall'editore. Ad esempio, potrebbero specificare restrizioni sull'utilizzo dei cookie o sull'ammissibilità di annunci multimediali e/o di testo.
Verticali del publisher Utilizzato nel campo detected_vertical di BidRequest. Questo campo specifica i verticali (simili alle parole chiave) della pagina in cui verrà mostrato l'annuncio. Google genera questo campo eseguendo la scansione della pagina e determinando quali verticali vengono utilizzati.
Fornitori Utilizzato nel campo allowed_vendor_type di BidRequest. Questo campo elenca i fornitori di rich media, come Campaign Monitor e VoiceFive, consentiti per la creatività pubblicata, come specificato dal publisher.

Sono inclusi i fornitori del file dizionario gdn-vendors.txt ritirato.

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 mobile Android a cui è possibile applicare il targeting con i relativi ID app, ID categoria e nomi delle app leggibili.
Tabelle geografiche La tabella utilizzata per decodificare il campo geo_criteria_id 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 loro 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 campo BidRequest.adslot.regs_lgpd nel protocollo di offerta di Authorized Buyers e il campo BidRequest.regs.ext.lgpd nel protocollo di offerta OpenRTB.
Operatori di telefonia mobile Elenco degli operatori di telefonia mobile.
Dispositivi mobili Elenco dei dispositivi mobili.
Sistemi operativi mobile Elenco dei sistemi operativi per dispositivi mobili.
Fornitori ID fornitore della personalizzazione degli annunci di Maps a un nome leggibile, un URL delle norme sulla privacy e un elenco di domini che possono essere attribuiti al fornitore. Attualmente, i fornitori vengono utilizzati nel campo BidRequest.AdSlot.consented_providers_settings per il protocollo AdX e BidRequest.User.UserExt.consented_providers_settings per il protocollo OpenRTB. In questi campi, i fornitori elencati hanno il consenso degli utenti trasmesso dagli editor 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 dei criteri in questo file per filtrare le creatività durante la revisione nell'API Real-time Bidding

Scarica gli argomenti delle norme come file CSV.

Ultimo aggiornamento: 18 aprile 2022