Protocollo e dati di riferimento

Visualizza o scarica i file che supportano il protocollo RTB.

Proto

File Descrizione Versione Ultimo aggiornamento
cookie-bulk-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 JSON o Protobuf codifica. Questo protocollo è necessario se utilizzi OpenRTB/Protobuf. Inoltre, include la documentazione dei campi supportati e la relativa mappatura al e il protocollo nativo. 2.6 1° agosto 2024
openrtb-adx.proto Il protocollo OpenRTB di Google include alcune estensioni, fornite in un protocollo separato. v.177 06 agosto 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 offerte. Un BidRequest include l'area annuncio di un una singola impressione. v.330 06 agosto 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.182 06 agosto 2024
realtime-bidding.proto Protocollo RTB di Authorized Buyers di Google. Questo è il messaggio utilizzato da Google per richiedere offerte. Un BidRequest include l'area annuncio di un una singola impressione. v.340 06 agosto 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 le categorie di prodotti e di servizi non consentiti da un publisher, ad esempio se non vuole ospitare annunci relativi all'online banking.
Categorie con limitazioni degli annunci Utilizzato nel campo allowed_restricted_category di BidRequest e il campo restricted_category di BidResponse. allowed_restricted_category descrive le categorie che sono normalmente limitate, ma che dichiarati da un publisher come consentiti, ad esempio annunci contenenti contenuti correlati agli alcolici.
Categorie sensibili per gli annunci Utilizzato nel campo excluded_sensitive_category di BidRequest e il campo category di BidResponse. excluded_sensitive_category descrive le categorie sensibili non consentite dal publisher, Ad esempio, se il publisher non vuole ospitare annunci relativi politica.
Inserzionisti Utilizzato nel campo advertiser_id di SnippetStatusItem. Questo specifica l'inserzionista rappresentato dalla creatività associata lo snippet. Questo elenco riflette gli inserzionisti di tutta la piattaforma di scambio pubblicitario non riflettono gli inserzionisti rappresentati da un 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 devono non compaiono in excluded_attribute in BidRequest.
Codici di stato dei callout Codici di stato restituiti dal metodo performancereport chiamata.
Etichette contenuti Utilizzato nel campo detected_content_labels della BidRequest.
Codici di stato dello strumento di abbinamento dei cookie Utilizzato nel campo cookieMatcherStatusRate del protocollo RTB report sul rendimento. I codici disponibili sono descritti nella sezione Corrispondenza dei cookie guida.
Codici di stato delle creatività

Utilizzato in

creative_status_code restituito in tempo reale Feedback.
Codici di stato di corrispondenza ospitati Utilizzato nel campo hostedMatchStatusRate del protocollo RTB report sul rendimento.
Nessun motivo di offerta Valori standard dei motivi per nessuna offerta da fornire nel campo BidResponse.no_bid_reason della Protocollo di offerta di Authorized Buyers.
Attributi delle creatività pre-target Utilizzato nel campo supportedCreativeAttribute nella sezione 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 Limitazioni sul fatto che l'utilizzo dei cookie sia consentito o se contenuti multimediali e/o testo sono consentiti.
Verticali dei publisher Utilizzato nel campo detected_vertical di BidRequest. Questo campo specifica i verticali (simile a parole chiave) della pagina su cui verrà pubblicato l'annuncio. che genera Google eseguire la scansione della pagina e determinare quali verticali vengono utilizzati.
Fornitori Utilizzato nel campo allowed_vendor_type di BidRequest. In questo campo sono elencati i fornitori rich media, Campaign Monitor e VoiceFive sono consentiti per la pubblicazione della creatività, come specificato dal publisher.

Include i fornitori ritirati File di dizionario gdn-vendors.txt.

Fornitori di dati Utilizzato nel campo SegmentData.id di BidRequest. Questo campo contiene informazioni sull'entità che ha fornito 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 i relativi ID app, ID categoria e nomi delle 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 informazioni.
Fornitori LGPD L'elenco dei fornitori di personalizzazione degli annunci autorizzati a pubblicare annunci sul traffico LGPD. con il loro ID, un nome leggibile, un URL di privacy e un elenco di domini che possono essere attribuiti al provider. L'applicazione della legge LGPD è indicata in un data richiesta di offerta tramite 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 dell'URL dei criteri e un elenco di domini che possono essere attribuiti al provider. Attualmente, i provider vengono utilizzati Campo BidRequest.AdSlot.consented_providers_settings per AdX e il protocollo BidRequest.User.UserExt.consented_providers_settings per OpenRTB protocollo. In questi campi, i fornitori elencati hanno il consenso degli utenti trasmesso da publisher per gli utenti nei paesi all'interno dello Spazio economico europeo.

Impostazioni publisher

Richiedi il file publisher-settings.pb.gz dal tuo account responsabile.

Argomenti delle norme relative alla revisione delle creatività

Puoi utilizzare gli argomenti delle norme in questo file per filtrare le creatività durante revisione nell'API Real-time Bidding

Scarica come file CSV.

Ultimo aggiornamento: 18 aprile 2022