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 sul targeting per utente. | v.24 | 27 marzo 2024 |
| openrtb.proto | Google supporta il protocollo OpenRTB, utilizzando la codifica JSON o Protobuf. Questo proto è necessario se utilizzi OpenRTB/Protobuf. Inoltre, include 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.190 | 30 giugno 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 giugno 2025 |
Proto di beta aperta
| File | Descrizione | Versione | Ultimo aggiornamento |
|---|---|---|---|
| openrtb-adx.proto | Il protocollo OpenRTB di Google include alcune estensioni, fornite in un proto separato. | v.197 | 30 giugno 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 giugno 2025 |
Dati di riferimento
Dizionari (fai clic per scaricare il file .txt) |
|
|---|---|
| Categorie di prodotti degli annunci | 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 relativi alla banca online. |
| 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 come consentite da un publisher, ad esempio gli annunci con contenuti correlati 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
allo snippet. Questo elenco riflette gli inserzionisti della piattaforma di scambio pubblicitario e non gli inserzionisti rappresentati da un singolo acquirente. |
| Brand | Elenco di brand, utilizzato 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 di
BidRequest. |
| Codici di stato del corrispettivo dei cookie | Utilizzato nel campo cookieMatcherStatusRate dei report sul rendimento del protocollo RTB. I codici disponibili sono descritti nella guida sulla corrispondenza dei cookie. |
| Codici di stato delle creatività | Utilizzato in creative_status_code è stato restituito nel feedback
in tempo reale.
|
| Codici di stato delle corrispondenze ospitate | Utilizzato nel campo hostedMatchStatusRate dei report sul rendimento del protocollo RTB. |
| Nessun motivo di offerta | Valori standard del motivo per cui non è stata presentata un'offerta da inserire nel campo BidResponse.no_bid_reason del protocollo di offerta di Authorized Buyers.
|
| Attributi delle creatività preselezionabili | Utilizzato nel campo supportedCreativeAttribute della
risorsa PretargetingConfig esposta nell'API REST di Acquirente. 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à esclusi dal publisher | Utilizzato nel campo excluded_attribute di
BidRequest. Questo campo descrive i tipi di creatività
non consentiti dall'editore. Ad esempio, potrebbero specificare
limitazioni relative all'utilizzo dei cookie o alla pubblicazione di annunci media e/o di testo. |
| Verticali del publisher | Utilizzato nel campo detected_vertical di
BidRequest. Questo campo specifica i verticali (simile alle
parole chiave) della pagina in cui verrà pubblicato l'annuncio. Google genera questo
campo eseguendo la scansione della pagina e determinando i verticali utilizzati. |
| Fornitori | Utilizzato nel campo allowed_vendor_type di
BidRequest. Questo campo elenca i fornitori di contenuti rich media, come
Campaign Monitor e VoiceFive, consentiti per la creatività pubblicata,
come specificato dal publisher. Sono inclusi 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 che possono essere scelte come target con i relativi ID app, ID categoria e nomi 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 servizi 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 del 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 di operatori di telefonia mobile. |
| Dispositivi mobili | Elenco di dispositivi mobili. |
| Sistemi operativi mobile | Elenco dei sistemi operativi mobile. |
| Fornitori | Associa 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.
Al momento, i fornitori vengono utilizzati nel
BidRequest.AdSlot.consented_providers_settings per il protocollo AdX
e nel
BidRequest.User.UserExt.consented_providers_settings per il protocollo OpenRTB. In questi campi, i fornitori elencati dispongono del consenso degli utenti come comunicato dai publisher per gli utenti dei paesi dello Spazio economico europeo. |
Impostazioni publisher
Richiedi il file publisher-settings.pb.gz al rappresentante del tuo 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 Real-time Bidding.
Scarica gli argomenti delle norme come file CSV.Ultimo aggiornamento: 18 aprile 2022