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 |
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