> For the complete documentation index, see [llms.txt](https://docs.exoclick.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.exoclick.com/rtb/it/inserzionisti/rtb-aperto/adv-open-rtb-2.5-request.md). # 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. | Attributo | Descrizione | | --------- | --------------------------------------------------------------------------------------------------------- | | 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 | Attributo | Descrizione | | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 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 | Attributo | Descrizione | | ----------- | --------------------------------------------------- | | exchangecat | ID categoria personalizzato ExoClick (intero) | | idzone | ID personalizzato della Ad Zone ExoClick (intero) | | keyword | Parola chiave corrispondente, se presente (stringa) | ## device | Attributo | Descrizione | | --------- | ------------------------------------------------------------------------------------------------------------------------------- | | 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 | Attributo | Descrizione | | --------- | --------------------------------------------------------------------------------------------------------- | | country | Paese ISO3 | | ipservice | Servizio o provider usato per determinare la geolocalizzazione dall'indirizzo IP, se applicabile (intero) | ### device.ext | Attributo | Descrizione | | ----------------- | -------------------------------------------------------------------------------- | | 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. | Attributo | Descrizione | | ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 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](https://github.com/InteractiveAdvertisingBureau/AdCOM/blob/master/AdCOM%20v1.0%20FINAL.md#list--user-agent-source-) nell'AdCOM 1.0 (intero; predefinito 0) | ### device.sua.browsers | device.sua.platform | Attributo | Descrizione | | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 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 | Attributo | Descrizione | | --------- | --------------------------- | | id | ID utente univoco (stringa) | ### user.ext | Attributo | Descrizione | | --------- | ------------------------------------------------------------------------------------------------------ | | consent | Questa è la stringa di consenso richiesta dagli standard IAB. Per ora solo consenso negativo (stringa) | ## regs | Attributo | Descrizione | | --------- | ------------------------------------------------------------- | | ext | Segnaposto per estensioni specifiche dell'exchange a OpenRTB. | ### regs.ext | Attributo | Descrizione | | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 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 | Attributo | Descrizione | | --------- | -------------------------------------------------------------------------------------------------- | | 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 | Attributo | Descrizione | | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | | 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 | Attributo | Descrizione | | ---------- | ------------------------------------------------------------------------------------- | | zone\_type | Tipo di zona all'interno dei formati pubblicitari di ExoClick (ad es.: video\_slider) | --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.exoclick.com/rtb/it/inserzionisti/rtb-aperto/adv-open-rtb-2.5-request.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.