Protocollo e dati di riferimento

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 per gli utenti. 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 18 novembre 2024
openrtb-adx.proto Il protocollo OpenRTB di Google include alcune estensioni, fornite in un proto separato. v.180 1° novembre 2024
publisher-settings.proto Un insieme di impostazioni del publisher specifiche per una rete di offerenti in tempo reale. v.13 5 feb 2024
realtime-bidding.proto Il protocollo RTB di Authorized Buyers di Google. Questo è il messaggio utilizzato da Google per richiedere le offerte. Un BidRequest include lo spazio annuncio di una singola impressione. v.331 1° novembre 2024

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.186 1° novembre 2024
realtime-bidding.proto Il protocollo RTB di Authorized Buyers di Google. Questo è il messaggio utilizzato da Google per richiedere le offerte. Un BidRequest include lo spazio annuncio di una singola impressione. v.342 31 ottobre 2024

Dati di riferimento

Dizionari (fai clic per scaricare il file .txt)

Categorie di prodotti per gli 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 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 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 di mancata offerta da inserire nel campo BidResponse.no_bid_reason nel protocollo delle offerte di Authorized Buyers.
Attributi delle creatività preselezionabili Utilizzato nel campo supportedCreativeAttribute della risorsa PretargetingConfig esposta nell'API REST di Buyer. 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 sull'utilizzo dei cookie o sull'utilizzo di annunci illustrati 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 rich media, come Campaign Monitor e VoiceFive, consentiti per la creatività pubblicata, come specificato dal publisher.

Sono inclusi i fornitori del file del dizionario gdn-vendors.txt ritirato.

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