Visualizza o scarica i file che supportano il protocollo RTB.
Proto
| File | Descrizione | Versione | Ultimo aggiornamento |
|---|---|---|---|
| cookie-batch-upload.proto | Utilizza questo messaggio per eseguire il caricamento collettivo dei dati di targeting per gli utenti. | v.24 | 27 mar 2024 |
| openrtb.proto | Google supporta il protocollo OpenRTB, utilizzando la codifica JSON o Protobuf. Questo protocollo è necessario se utilizzi OpenRTB/Protobuf. Include inoltre la documentazione dei campi supportati e la relativa mappatura al protocollo nativo di Google. | 2.6 | 22 maggio 2024 |
| openrtb-adx.proto | Il protocollo OpenRTB di Google include alcune estensioni, fornite in un protocollo separato. | v.174 | 21 maggio 2024 |
| publisher-settings.proto | Un insieme di impostazioni del publisher specifiche per una rete dello strumento di offerta in tempo reale. | v.13 | 5 feb 2024 |
| realtime-bidding.proto | Protocollo RTB di Authorized Buyers di Google. Questo è il messaggio utilizzato da Google per richiedere le offerte. Un BidRequest include l'area annuncio di una
singola impressione. |
v.328 | 21 maggio 2024 |
Protos beta aperti
| File | Descrizione | Versione | Ultimo aggiornamento |
|---|---|---|---|
| openrtb-adx.proto | Il protocollo OpenRTB di Google include alcune estensioni, fornite in un protocollo separato. | v.179 | 24 maggio 2024 |
| realtime-bidding.proto | Protocollo RTB di Authorized Buyers di Google. Questo è il messaggio utilizzato da Google per richiedere le offerte. Un BidRequest include l'area annuncio di una
singola impressione. |
v.338 | 24 maggio 2024 |
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 categorie di prodotti e servizi non consentiti da un publisher, ad esempio se l'editore non vuole ospitare annunci relativi all'online banking. |
| Categorie con limitazioni degli 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 sono normalmente soggette a restrizioni, ma dichiarate esplicitamente
come consentite da un publisher, ad esempio gli annunci con
contenuti correlati agli alcolici. |
| Categorie sensibili per gli 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 legati alla
politica. |
| Inserzionisti | Utilizzato nel campo advertiser_id di SnippetStatusItem. Questo campo consente di specificare l'inserzionista rappresentato dalla creatività associata allo snippet. Questo elenco riflette gli inserzionisti di tutta la piattaforma di scambio pubblicitario e non quelli rappresentati da un singolo acquirente. |
| Brand | Elenco di brand utilizzati 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 per le creatività che non devono
apparire in excluded_attribute in
BidRequest. |
| Codici di stato dei callout | Codici di stato restituiti dalla chiamata al metodo performancereport. |
| Etichette contenuti | Utilizzato nel campo detected_content_labels di
BidRequest. |
| Codici di stato dello strumento di abbinamento dei cookie | Utilizzato nel campo cookieMatcherStatusRate dei report sul rendimento del protocollo RTB. I codici disponibili sono descritti nella guida Corrispondenza dei cookie. |
| Codici di stato delle creatività | Utilizzato in creative_status_code restituito in feedback
in tempo reale.
|
| Codici di stato di corrispondenza ospitati | Utilizzato nel campo hostedMatchStatusRate dei report sul rendimento del protocollo RTB. |
| Nessun motivo di offerta | Valori standard dei motivi per nessuna offerta da fornire nel campo BidResponse.no_bid_reason del protocollo di offerta di Authorized Buyers.
|
| Attributi delle creatività pre-target | Utilizzato nel campo supportedCreativeAttribute nella risorsa PretargetingConfig esposta nell'API REST 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à 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, potrebbero specificare restrizioni relative all'autorizzazione dell'utilizzo dei cookie o agli annunci multimediali e/o di testo. |
| Verticali del publisher | Utilizzato nel campo detected_vertical di
BidRequest. Questo campo consente di specificare i verticali (simili alle parole chiave) della pagina su cui verrà pubblicato 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 rich media, come Campaign Monitor e VoiceFive, autorizzati 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 (file CSV click-to-download) |
|
| App per dispositivi mobili Android | Elenco di app mobile Android disponibili per il targeting con ID app, ID categoria e nomi di app leggibili da una persona. |
| 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 di fornitori di personalizzazione degli annunci autorizzati a pubblicare annunci sul traffico LGPD, con il loro ID, un nome leggibile, un URL per la privacy e un elenco di domini che possono essere attribuiti al fornitore. L'applicazione della legge 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 per dispositivi mobili | Elenco di sistemi operativi per dispositivi mobili. |
| Fornitori | Mappa gli ID fornitore 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 provider vengono utilizzati nel campo BidRequest.AdSlot.consented_providers_settings per il protocollo AdX e in BidRequest.User.UserExt.consented_providers_settings per il protocollo OpenRTB. In questi campi, i fornitori elencati hanno il consenso degli utenti trasmesso dai publisher per gli utenti nei paesi all'interno 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 dei criteri come file CSV.Ultimo aggiornamento: 18 aprile 2022