Protocollo e dati di riferimento

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 22 maggio 2024
openrtb-adx.proto Il protocollo OpenRTB di Google include alcune estensioni, fornite in un protocollo separato. v.173 21 maggio 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.328 21 maggio 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.179 24 maggio 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.338 24 maggio 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 gdn-vendors.txt ritirato.

Fornitori di dati Utilizzata 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 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