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 degli utenti. | v.25 | 27 marzo 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 | 15 ottobre 2026 |
| openrtb-adx.proto | Il protocollo OpenRTB di Google include alcune estensioni, fornite in un proto separato. | v.210 | 4 agosto 2026 |
| publisher-settings.proto | Un insieme di impostazioni del publisher specifiche per una rete di offerte in tempo reale. | v.14 | 5 feb 2024 |
Prototipi beta aperti
| File | Descrizione | Versione | Ultimo aggiornamento |
|---|---|---|---|
| openrtb-adx.proto | Il protocollo OpenRTB di Google include alcune estensioni, fornite in un proto separato. | v.220 | 16 settembre 2026 |
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 consentite da un publisher, ad esempio se il publisher non vuole ospitare annunci correlati all'online banking. |
| Categorie con restrizioni per gli annunci | Utilizzato nel campo allowed_restricted_category di BidRequest e nel campo restricted_category di BidResponse. Il campo allowed_restricted_category descrive le categorie che normalmente sono soggette a limitazioni, ma che vengono dichiarate esplicitamente come consentite da un publisher, ad esempio gli annunci contenenti contenuti correlati ad alcolici. |
| 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 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 della piattaforma di scambio pubblicitario e non quelli rappresentati da un singolo acquirente. |
| Brand | Elenco di brand, utilizzato nell'API Client Access. |
| Attributi delle creatività dichiarabili dall'acquirente | Utilizzato per il campo attribute in BidResponse.
Questo campo descrive gli attributi dichiarabili dall'acquirente sulle creatività che non devono essere visualizzati in excluded_attribute in BidRequest. |
| Etichette contenuti | Utilizzato nel campo detected_content_labels di BidRequest. |
| Codici di stato del sistema di corrispondenza 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 restituito nel feedback in tempo reale.
|
| Codici di stato della corrispondenza ospitata | Utilizzato nel campo hostedMatchStatusRate dei report sul rendimento del protocollo RTB. |
| Motivi nessuna offerta | Valori standard dei motivi di mancata offerta da fornire nel campo BidResponse.no_bid_reason nel protocollo di offerta di 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 delle creatività che dovrebbero 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à non consentiti dal publisher. Ad esempio, potrebbero specificare
restrizioni sull'utilizzo dei cookie o sulla pubblicazione di annunci multimediali e/o di testo. |
| Vendors | 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. Include i fornitori del file del dizionario |
| 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 di app mobile Android targetizzabili con i relativi ID app, ID categoria e nomi di app leggibili. |
| Tabelle geografiche | La tabella utilizzata per decodificare il campo geo_criteria_id di BidRequest. Per saperne di più, consulta 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 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 mobile. |
| Provider | Mappa gli ID dei fornitori di personalizzazione degli annunci a un nome leggibile, un URL delle norme sulla privacy e un elenco di domini che possono essere attribuiti al fornitore.
Al momento, 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 dell'utente trasmesso dai 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 di verifica 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