> 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/editori/rtb-aperto/pub-open-rtb-2.5-request.md). # Richiesta di offerta Open RTB 2.5 Questa pagina spiega come effettuare richieste di offerta. ## Intestazioni suggerite per la richiesta di bid * **Intestazione HTTP della versione OpenRTB:** `x-openrtb-version: 2.5` * **Intestazione HTTP Keep-Alive:** `Connection: Keep-Alive` * **Contenuto JSON:** `Content-Type: application/json` I seguenti oggetti devono essere inviati codificati come JSON nel corpo della richiesta: ## Oggetto della richiesta di offerta | Attributo | Obbligatorio? | Descrizione | | --------- | ------------- | --------------------------------------------------------------------------------- | | a | Sì | Tipo di asta, first price = 1 (int) | | id | Sì | ID univoco della richiesta di offerta (stringa) | | imp | Sì | Array di oggetti Imp che rappresentano le impression offerte (oggetto). | | site | Sì | Dettagli sul sito web dell'editore (oggetto). | | app | Sì | Dettagli sull'app dell'editore (oggetto). | | device | Sì | Dettagli sul dispositivo dell'utente a cui verrà erogata l'impressione (oggetto). | | user | No | Dettagli sull'utente umano del dispositivo; il pubblico pubblicitario (oggetto). | | ext | No | Segnaposto per estensioni di OpenRTB. | {% hint style="info" %} Solo uno degli oggetti `{site, app}` deve essere presente in ogni richiesta. {% endhint %} ## imp | Attributo | Obbligatorio? | Descrizione | | --------- | ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | id | Sì | ID univoco dell'impression all'interno di questa richiesta di offerta (stringa) | | bidfloor | No | Offerta minima per questa impressione (CPM) / clic (CPC) e valuta dell'account (float). | | banner | Solo per imp a pagina intera | Un oggetto banner (oggetto). | | secure | No; consigliato 1 | Flag per indicare se l'impression richiede asset creativi e markup con URL HTTPS sicuri, dove 0 = non sicuro, 1 = sicuro. Se omesso, lo stato di sicurezza è sconosciuto, ma si può assumere il supporto HTTP non sicuro; facoltativo (intero) | ### imp.banner | Attributo | Obbligatorio? | Descrizione | | --------- | ------------- | -------------------------------------------------------- | | w | Sì | Larghezza del banner (intero) | | h | Sì | Altezza del banner (intero) | | mimes | Sì | Tipi MIME - image/jpg, image/png, video/mp4 o image/webp | ### imp.video | Attributo | Obbligatorio? | Descrizione | | ------------- | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | | mimes | Sì | Tipi MIME del contenuto supportati (ad es., "video/mp4") (array di stringhe) | | minduration | No | Durata minima dell'annuncio video in secondi (intero) | | maxduration | No | Durata massima dell'annuncio video in secondi (intero) | | protocols | No | Array di protocolli video supportati (intero) | | linearity | No | Indica se l'impressione deve essere lineare, non lineare, ecc. Se non ne viene specificato alcuno, si presume che siano consentiti tutti (intero) | | boxingallowed | No | Indica se è consentito il letterboxing di contenuti 4:3 in una finestra 16:9, dove 0 = no, 1 = sì (intero) | | pos | No | Posizione dell'annuncio sullo schermo (intero) | | h | No | Larghezza del player video in pixel indipendenti dal dispositivo (DIPS) (intero) | | w | No | Altezza del player video in pixel indipendenti dal dispositivo (DIPS) (intero) | | ext | No | Segnaposto per estensioni specifiche dell'exchange di OpenRTB (oggetto) | ### imp.video.ext | Attributo | Obbligatorio? | Descrizione | | ---------- | ------------- | ------------------------------------------------------------------------------------- | | zone\_type | No | Tipo di zona all'interno dei formati pubblicitari di ExoClick (ad es.: video\_slider) | | cta | No | Specifica se la zona pubblicitaria mostra un componente CTA (intero) | ## site | Attributo | Obbligatorio? | Descrizione | | --------- | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | id | Consigliato | ID univoco del sito (stringa) | | name | No | Nome del sito (stringa) | | domain | Consigliato | Nome di dominio del sito (stringa) | | cat | No | ID categoria IAB (array di stringhe) | | page | Consigliato | URL completo della pagina in cui verrà mostrato l'annuncio (stringa) | | keywords | No | 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 | ### site.ext | Attributo | Obbligatorio? | Descrizione | | ----------- | ------------- | ---------------------------------------------- | | exchangecat | No | ID categoria personalizzato ExoClick (intero) | | idzone | No | ID personalizzato della zona ExoClick (intero) | ## app | Attributo | Obbligatorio? | Descrizione | | --------- | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | id | Consigliato | ID univoco dell'app (stringa) | | name | No | Nome dell'app (stringa) | | domain | Consigliato | Nome di dominio dell'app (stringa) | | cat | No | ID categoria IAB (array di stringhe) | | keywords | No | Le parole chiave possono essere utilizzate per assicurarsi che le zone pubblicitarie ricevano il tipo giusto di pubblicità. Le parole chiave dovrebbero essere una stringa di parole separate da virgole (stringa) | | publisher | No | Dettagli sull'editore (oggetto) | ## device | Attributo | Obbligatorio? | Descrizione | | --------- | ------------- | ------------------------------------------------------------------------------------------------------------------------------- | | ua | Sì | User agent del browser (stringa) | | sua | No | Informazioni strutturate sullo user agent, che possono essere usate quando un client supporta User-Agent Client Hints (oggetto) | | geo | No | Posizione del dispositivo assunta come posizione attuale dell'utente definita da un oggetto Geo. | | ip | Sì | Indirizzo IPv4 dell'utente (stringa)\* | | ipv6 | Sì | Indirizzo IPv6 dell'utente (stringa)\* | | language | Consigliato | Lingua del browser (stringa) | | os | No | Sistema operativo (stringa) | | js | No | Supporto per JavaScript, dove 0 = no, 1 = sì (intero) | | ext | No | Segnaposto per estensioni specifiche dell'exchange a OpenRTB | {% hint style="info" %} Devi includere solo ip o ipv6 nella tua richiesta, non entrambi. Se usi ipv6, rimuovi l'attributo ip, e viceversa. Includerli entrambi può causare errori. {% endhint %} ### device.geo | Attributo | Obbligatorio? | Descrizione | | --------- | ------------- | ----------- | | country | No | Paese ISO3 | ### device.ext | Attributo | Obbligatorio? | Descrizione | | ----------------- | ------------- | -------------------------------------------------------------------------------- | | remote\_addr | No | Indirizzo IP principale dell'utente (stringa) | | x\_forwarded\_for | No | 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 | Obbligatorio? | Descrizione | | ------------ | ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | browsers | Consigliato | Gli implementatori dovrebbero inviare brand e versioni derivati dall'header Sec-CH-UA-Full-Version-List. (Array di `BrandVersion` oggetti) | | platform | Consigliato | Gli implementatori dovrebbero inviare un brand derivato dall'header Sec-CH-UA-Platform e una versione derivata dall'header Sec-CH-UA-Platform-Version. (`BrandVersion` Oggetto) | | mobile | Consigliato | Gli implementatori dovrebbero derivare questo valore dall'header Sec-CH-UA-Mobile. (intero) | | architecture | Consigliato | Gli implementatori dovrebbero recuperare questo valore dall'header Sec-CH-UA-Arch. (stringa) | | bitness | Consigliato | Gli implementatori dovrebbero recuperare questo valore dall'header Sec-CH-UA-Bitness. (stringa) | | model | Consigliato | Gli implementatori dovrebbero recuperare questo valore dall'header Sec-CH-UA-Model. (stringa) | | source | Consigliato | 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 | Obbligatorio? | Descrizione | | --------- | ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | brand | Obbligatorio | 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 | Consigliato | Una sequenza di componenti di versione, in ordine gerarchico decrescente \[major, minor, micro, …] (array di stringhe) | ## user | Attributo | Obbligatorio? | Descrizione | | --------- | ------------- | ----------------------------------------------------------------------- | | id | No | ID utente univoco (stringa) | | ext | No | Segnaposto per estensioni specifiche dell'exchange di OpenRTB (oggetto) | ### user.ext | Attributo | Obbligatorio? | Descrizione | | --------- | ------------- | ------------------------------------------------------------------------------------------------------ | | consent | No | Questa è la stringa di consenso richiesta dagli standard IAB. Per ora solo consenso negativo (stringa) | ## regs | Attributo | Obbligatorio? | Descrizione | | --------- | ------------- | ----------------------------------------------------------------------- | | ext | No | Segnaposto per estensioni specifiche dell'exchange di OpenRTB (oggetto) | ### regs.ext | Attributo | Obbligatorio? | Descrizione | | --------- | ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | gdpr | No | 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. | ## ext | Attributo | Obbligatorio? | Descrizione | | --------- | ------------- | --------------------------------------------------------------------------------------------- | | sub | No | Il Sub ID. Deve essere un numero tra una e dieci cifre: non usare zeri all'inizio dei Sub ID. | --- # 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/editori/rtb-aperto/pub-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.