Richiesta di offerta Open RTB 2.5
Questa pagina descrive i diversi componenti delle richieste RTB che riceverai per effettuare un'offerta.
Header della richiesta di offerta
Intestazione HTTP della versione OpenRTB: x-openrtb-version: 2.5
Intestazione HTTP Keep-Alive: Connection: Keep-Alive
Contenuto JSON: Content-Type: application/json
Intestazione di codifica dei dati: Accept-Encoding
Richiesta di offerta 2.5
Quando richiedi offerte per un contesto specifico, la piattaforma eseguirà una richiesta HTTP con un timeout di 300ms e invierà il seguente oggetto codificato come JSON nel corpo della richiesta. HTTP è consigliato a causa della latenza aggiuntiva quando si usa HTTPS.
id
ID univoco della richiesta di offerta (stringa)
site
Dettagli, tramite un oggetto Site, sul sito web dell'editore (oggetto)
device
Dettagli del dispositivo dell'utente a cui verrà recapitata l'impressione (oggetto)
user
Dettagli dell'utente umano del dispositivo; il pubblico pubblicitario (oggetto)
imp
Dettagli dello spazio pubblicitario o dell'impressione messa all'asta (oggetto)
regs
Dettagli di eventuali normative di settore, legali o governative in vigore per questa richiesta (oggetto)
ext
Segnaposto per estensioni di OpenRTB (oggetto)
site
id
ID univoco del sito (stringa)
domain
Nome di dominio del sito (stringa)
cat
ID categoria IAB (array di stringhe)
page
URL completo della pagina in cui verrà mostrato l'annuncio (stringa)
keywords
Le parole chiave possono essere usate per garantire che le zone pubblicitarie ricevano il giusto tipo di pubblicità. Le parole chiave dovrebbero essere una stringa di parole separate da virgole
ext
Segnaposto per estensioni specifiche dell'exchange (oggetto)
site.ext
exchangecat
ID categoria personalizzato ExoClick (intero)
idzone
ID personalizzato della Ad Zone ExoClick (intero)
keyword
Parola chiave corrispondente, se presente (stringa)
device
ua
User agent del browser (stringa)
sua
Informazioni strutturate sullo user agent, che possono essere usate quando un client supporta User-Agent Client Hints (oggetto)
geo
Posizione del dispositivo, assunta come posizione corrente dell'utente, definita da un oggetto Geo
ip
Indirizzo IPv4 dell'utente (stringa)*
ipv6
Indirizzo IPv6 dell'utente (stringa)*
language
Lingua del browser (stringa)
os
Sistema operativo (stringa)
js
Supporto per JavaScript, dove 0 = no, 1 = sì (intero)
ext
Segnaposto per estensioni specifiche dell'exchange di OpenRTB (oggetto)
*Esattamente uno tra ip o ipv6 sarà presente nella richiesta di offerta.
device.geo
country
Paese ISO3
ipservice
Servizio o provider usato per determinare la geolocalizzazione dall'indirizzo IP, se applicabile (intero)
device.ext
remote_addr
Indirizzo IP principale dell'utente (stringa)
x_forwarded_for
Indirizzo IP X-FORWARDED-FOR dell'utente oppure vuoto se non impostato (stringa)
device.sua
Informazioni strutturate sullo User Agent. device.sua è considerata la rappresentazione più accurata degli attributi del dispositivo.
browsers
Invia marchi e versioni derivati dall'header Sec-CH-UA-Full-Version-List. (Array di BrandVersion oggetti)
platform
Invia un marchio derivato dall'header Sec-CH-UA-Platform e una versione derivata dall'header Sec-CH-UA-Platform-Version. (BrandVersion Oggetto)
mobile
Deriva questo valore dall'header Sec-CH-UA-Mobile. (intero)
architecture
Recupera questo valore dall'header Sec-CH-UA-Arch. (stringa)
bitness
Recupera questo valore dall'header Sec-CH-UA-Bitness. (stringa)
model
Recupera questo valore dall'header Sec-CH-UA-Model. (stringa)
source
La fonte dei dati usati per creare questo oggetto, Elenco: User-Agent Source nell'AdCOM 1.0 (intero; predefinito 0)
device.sua.browsers | device.sua.platform
brand
Il valore può provenire dagli header User-Agent Client Hints, rappresentando il marchio dello user agent (da Sec-CH-UA-Full-Version header) o il marchio della piattaforma (da Sec-CH-UA-Platform header). (stringa)
version
Una sequenza di componenti di versione, in ordine gerarchico decrescente [major, minor, micro, …] (array di stringhe)
user
id
ID utente univoco (stringa)
user.ext
consent
Questa è la stringa di consenso richiesta dagli standard IAB. Per ora solo consenso negativo (stringa)
regs
ext
Segnaposto per estensioni specifiche dell'exchange a OpenRTB.
regs.ext
gdpr
Questo è 0 se il chiamante ritiene che l'utente non sia soggetto al GDPR, e 1 se l'utente è soggetto al GDPR. In caso contrario, questo parametro non sarà definito.
imp
id
Un identificatore univoco per questa impressione nel contesto della richiesta di offerta (stringa)
instl
1 = l'annuncio è interstitial o a schermo intero, 0 = non interstitial (intero)
video
Dettagli, tramite un oggetto Video, che rappresenta un'impressione video in-stream
secure
Flag per indicare se l'impressione richiede un URL HTTPS sicuro (intero)
ext
Segnaposto per estensioni specifiche dell'exchange di OpenRTB (oggetto)
imp.video
mimes
Tipi MIME del contenuto supportati (ad es., "video/mp4") (array di stringhe )
minduration
Durata minima dell'annuncio video in secondi (intero)
maxduration
Durata massima dell'annuncio video in secondi (intero)
protocols
Array di protocolli video supportati (intero)
linearity
Indica se l'impressione deve essere lineare, non lineare, ecc. Se non ne viene specificato alcuno, si presume che siano consentiti tutti (intero)
boxingallowed
Indica se è consentito il letterboxing di contenuti 4:3 in una finestra 16:9, dove 0 = no, 1 = sì (intero)
pos
Posizione dell'annuncio sullo schermo (intero)
h
Larghezza del player video in pixel indipendenti dal dispositivo (DIPS) (intero)
w
Altezza del player video in pixel indipendenti dal dispositivo (DIPS) (intero)
ext
Segnaposto per estensioni specifiche dell'exchange di OpenRTB (oggetto)
imp.video.ext
zone_type
Tipo di zona all'interno dei formati pubblicitari di ExoClick (ad es.: video_slider)
Ultimo aggiornamento
È stato utile?