Visualizzare o scaricare file che supportano il protocollo RTB.
Protocollo
| File | Descrizione | Versione | Ultimo aggiornamento |
|---|---|---|---|
| cookie-bulk-upload.proto | Utilizza questo messaggio per caricare collettivamente i dati sul targeting degli utenti. | v.24 | 27 mar 2024 |
| openrtb.proto | Google supporta il protocollo OpenRTB mediante 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 | 23 mar 2024 |
| openrtb-adx.proto | Il protocollo OpenRTB di Google include alcune estensioni, fornite in un protocollo separato. | v.171 | 17 aprile 2024 |
| publisher-settings.proto | Un insieme di impostazioni del publisher specifiche per la rete di uno strumento di offerta in tempo reale. | v.13 | 05 feb 2024 |
| realtime-bidding.proto | Il protocollo RTB di Authorized Buyers di Google. Questo è il messaggio utilizzato da Google per richiedere le offerte. Un elemento BidRequest include l'area annuncio di una
singola impressione. |
v.324 | 17 aprile 2024 |
Protocollo beta aperto
| File | Descrizione | Versione | Ultimo aggiornamento |
|---|---|---|---|
| openrtb-adx.proto | Il protocollo OpenRTB di Google include alcune estensioni, fornite in un protocollo separato. | v.174 | 17 aprile 2024 |
| realtime-bidding.proto | Il protocollo RTB di Authorized Buyers di Google. Questo è il messaggio utilizzato da Google per richiedere le offerte. Un elemento BidRequest include l'area annuncio di una
singola impressione. |
v.331 | 17 aprile 2024 |
Dati di riferimento
Dizionari (fai clic per scaricare il file .txt) |
|
|---|---|
| Categorie di prodotti pubblicitari | Utilizzata nel campo excluded_product_category di
BidRequest. Questo campo descrive le categorie di prodotti e
servizi non consentite da un publisher, ad esempio se quest'ultimo
non vuole ospitare annunci relativi all'online banking. |
| Categorie con limitazioni 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 in genere sono limitate, ma dichiarate esplicitamente
da un publisher come consentite, ad esempio gli annunci con
contenuti correlati agli alcolici. |
| Categorie sensibili agli 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 relativi alla politica. |
| Inserzionisti | Utilizzata nel campo advertiser_id di SnippetStatusItem. Questo campo specifica l'inserzionista rappresentato dalla creatività associata allo snippet. Questo elenco riflette gli inserzionisti su tutta la piattaforma di scambio e non
quelli rappresentati da nessun 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 essere visualizzate in excluded_attribute in BidRequest. |
| Codici di stato dei callout | Codici di stato restituiti dalla chiamata al metodo performancereport. |
| Etichette contenuti | Utilizzata nel campo detected_content_labels di
BidRequest. |
| Codici di stato dello strumento di abbinamento 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 ospitata | Utilizzato nel campo hostedMatchStatusRate dei report sul rendimento del protocollo RTB. |
| Motivo nessuna offerta | Valori standard del motivo senza offerta da specificare nel campo BidResponse.no_bid_reason del protocollo di offerta di Authorized Buyers.
|
| Attributi delle creatività pretarget disponibili | Utilizzato nel campo supportedCreativeAttribute della risorsa PretargetingConfig esposta nell'API REST acquirente. Questo campo
descrive gli attributi delle creatività che devono essere presenti in tutte le creatività
corrispondenti a una singola configurazione di pretargeting. |
| Attributi della creatività escludibili dal publisher | Utilizzata nel campo excluded_attribute di
BidRequest. Questo campo descrive i tipi di creatività non consentiti dal publisher. Ad esempio, potrebbero specificare limitazioni relative all'autorizzazione dell'utilizzo dei cookie o all'uso o meno di annunci multimediali e/o di testo. |
| Verticali dei publisher | Utilizzata nel campo detected_vertical di
BidRequest. Questo campo specifica 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. |
| ID rete venditore | Utilizzata nel campo seller_network_id di
BidRequest. Questo campo specifica la rete del venditore a cui appartiene l'editore. I contenuti di questo file sono in ordine crescente
in base al valore dell'ID rete del venditore. |
| Fornitori | Utilizzata nel campo allowed_vendor_type di
BidRequest. Questo campo elenca i fornitori rich media, come Campaign Monitor e VoiceFive, autorizzati per la pubblicazione della creatività, come specificato dal publisher. Sono inclusi i fornitori del file del dizionario |
Tabelle di riferimento (fai clic per scaricare i file CSV) |
|
| App per dispositivi mobili Android | Elenco di app mobile Android disponibili per 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 della legge LGPD |
L'elenco dei fornitori di personalizzazione degli annunci autorizzati a pubblicare sul traffico LGPD,
con ID, un nome leggibile, un URL per la privacy e un elenco di domini
che possono essere attribuiti al provider. L'applicazione della LGPD è indicata su 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 dei sistemi operativi per dispositivi mobili. |
| Fornitori | Mappa gli ID fornitore di personalizzazione degli annunci a un nome leggibile, a un URL di 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 nel campo BidRequest.User.UserExt.consented_providers_settings per il protocollo OpenRTB. In questi campi, i fornitori elencati ricevono il consenso degli utenti trasmesso dagli editori 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 sulla verifica 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