> 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.4-request.md). # Richiesta di offerta Open RTB 2.4 Questa pagina descrive i diversi componenti delle richieste RTB che riceverai per effettuare un'offerta. ## Header della richiesta di offerta * **Header HTTP della versione OpenRTB**: `x-openrtb-version: 2.4` * **Header HTTP Keep-Alive**: `Connection: Keep-Alive` * **JSON del contenuto**: `Content-Type: application/json` * **Header di codifica dei dati**: `Accept-Encoding` ## Oggetto della richiesta di offerta 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 | | --------- | ------------------------------------------------------------------------------------------------------------- | | a | Tipo di asta, first price = 1 (int) | | id | ID univoco della richiesta di offerta (stringa) | | imp | Oggetto che rappresenta l'impression offerta (oggetto). | | site | Dettagli tramite un oggetto Site sul sito web del publisher (oggetto). | | device | Dettagli tramite un oggetto Device sul dispositivo dell'utente a cui verrà consegnata l'impression (oggetto). | | user | Dettagli tramite un oggetto User sull'utente umano del dispositivo; il pubblico pubblicitario (oggetto). | | ext | Segnaposto per estensioni specifiche dell'exchange. | ## imp | Attributo | Descrizione | | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | id | ID univoco dell'impression all'interno di questa richiesta di offerta (stringa) | | bidfloor | Offerta minima per questa impression (CPM) / click (CPC) e valuta dell'account, facoltativo (float). | | bidfloorcur | Valuta per il valore minimo dell'offerta specificato usando codici alfa ISO-4217, facoltativo (stringa) | | native | Un oggetto Native; richiesto se questa impression è offerta come opportunità pubblicitaria nativa (oggetto). | | banner | Un oggetto banner; richiesto se questa impression è offerta come opportunità pubblicitaria banner (oggetto). | | instl | Un oggetto interstitial; richiesto se questa impression è offerta come opportunità pubblicitaria interstitial o popunder (oggetto).(oggetto). | | secure | 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) | | el | Email codificata in Base64 (stringa) | ### imp.banner | Attributo | Descrizione | | --------- | ------------------------------------------------------------------------------------- | | w | Larghezza del banner in pixel (intero). | | h | Altezza del banner in pixel (intero). | | mimes | Tipi MIME supportati. Valori di esempio: image/jpg, image/png, video/mp4, image/webp. | ### imp.instl | Attributo | Descrizione | | --------- | ---------------------------------------------------------------------------------- | | instl | Flag che specifica se l'annuncio è popunder/interstitial (intero): 1=true, 0=false | ### imp.native (Native e Notifiche Push) | Attributo | Descrizione | | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | request | Payload della richiesta conforme alla Specifica dell'Annuncio Native - un **stringa codificata JSON** della richiesta Native Ads, inclusa la sua **native** oggetto di primo livello (oggetto JSON) | | ver | Versione dell'API Dynamic Native Ads a cui **request** è conforme (stringa) | ### imp.native.request | Attributo | Descrizione | | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | ver | Versione del markup Native in uso (stringa) | | context | Il contesto in cui appare l'annuncio. In questo caso è **1** (*un contesto incentrato sul contenuto, come newsfeed, articolo, galleria immagini, galleria video o simili*), facoltativo (intero) | | plcmttype | Il design/formato/layout dell'unità pubblicitaria offerta. Attualmente supportiamo **4** (*Widget di raccomandazione*) e **500** (*Notifica push*) (intero) | | plcmtcnt | Il numero di posizionamenti identici in questo layout (intero) | | assets | Un array di **Oggetti Asset**. Qualsiasi risposta all'offerta deve essere conforme all'array di elementi espresso nella richiesta di offerta (array di oggetti JSON) | | seq | 0 per il primo annuncio, 1 per il secondo annuncio, e così via. Nota che in genere NON verrebbe usato in combinazione con plcmtcnt - o stai mettendo all'asta più posizionamenti identici (nel qual caso plcmtcnt>1, seq=0) oppure stai tenendo aste separate per elementi distinti nel feed (nel qual caso plcmtcnt=1, seq=>=1) | ### imp.native.request.assets | Attributo | Descrizione | | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | id | ID univoco dell'asset, assegnato dall'exchange. Tipicamente un contatore per l'array (intero) | | richiesto | Imposta su **1** se l'asset è richiesto o **0** se l'asset è opzionale\*\* (intero) | | plcmtcnt | Il numero di posizionamenti identici in questo layout (intero) | | img | Oggetto immagine per gli asset immagine\* (oggetto JSON) | | title | Oggetto titolo per gli asset titolo\* (oggetto JSON) | | data | Oggetto dati per nome del marchio, descrizione, valutazioni, prezzi ecc.\* (oggetto JSON) | | video | Oggetto video per gli asset video. Vedi la definizione dell'oggetto richiesta Video. Nota che i video in-stream (cioè preroll, ecc.) non fanno parte del Native. Gli annunci Native possono contenere un video come creatività dell'annuncio stessa (oggetto). | \* Solo uno degli oggetti {img, title, data} dovrebbe essere presente in ogni oggetto asset \*\* Gli asset sono contrassegnati come richiesti in base alla configurazione della zona del publisher in cui il tuo annuncio potrebbe essere visualizzato ### imp.native.request.assets.img | Attributo | Descrizione | | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | type | ID del tipo di elemento immagine supportato dal publisher. Supportiamo: **1** (*Immagine icona*) (intero), **3** (*Anteprima immagine grande per l'annuncio*) (intero) | | w | Larghezza dell'immagine in pixel, facoltativo (intero) | | h | Altezza dell'immagine in pixel, facoltativo (intero) | | wmin | Larghezza minima richiesta dell'immagine in pixel (intero) | | hmin | Altezza minima richiesta dell'immagine in pixel (intero) | ### imp.native.request.assets.title | Attributo | Descrizione | | --------- | ---------------------------------------------------------- | | len | Lunghezza massima del testo nell'elemento titolo. (intero) | ### imp.native.request.assets.video | Attributo | Descrizione | | ------------- | --------------------------------------------------------------------------------------- | | mimes | Elenco dei tipi MIME supportati (array di stringhe). | | minduration | Durata minima dell'annuncio video in secondi (intero). | | maxduration | Durata massima dell'annuncio video in secondi (intero). | | protocols | Elenco dei protocolli di risposta alle offerte video supportati (array di interi). | | linearity | Indica se l'impression deve essere lineare, non lineare, ecc. (intero). | | boxingallowed | Indica se è consentito il letter-boxing di contenuti 4:3 in una finestra 16:9 (intero). | ### imp.native.request.assets.data | Attributo | Descrizione | | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | type | ID del tipo di elemento supportato dal publisher (intero). Supportiamo: **1** (*sponsored - Messaggio Sponsored By in cui la risposta dovrebbe contenere il nome del marchio dello sponsor*), **2** (*desc - Testo descrittivo associato al prodotto o servizio pubblicizzato*) | | len | Lunghezza massima del testo nella risposta dell'elemento (intero) | ### imp.video | Attributo | Descrizione | | --------- | ----------------------------------------------------------------------------------------------------------------------------------- | | mimes | Elenco dei tipi mime supportati (array di stringhe) | | protocols | Elenco dei protocolli di risposta alle offerte video supportati (array di int) | | skip | Indica se il player consentirà di saltare il video, dove 0 = no, 1 = sì | | skipafter | Numero di secondi che un video deve essere riprodotto prima che il salto sia abilitato; applicabile solo se l'annuncio è saltabile | | skipmin | I video con durata totale superiore a questo numero di secondi possono essere saltabili; applicabile solo se l'annuncio è saltabile | {% hint style="info" %} Se il publisher fornisce "skip" nella richiesta ma non "skipafter", il video sarà saltabile dopo 5 secondi. La risposta imposterà "skipoffset" a 5.\ Se il publisher fornisce "skip" ma non "skipmin", il video sarà saltabile indipendentemente dalla sua durata. {% endhint %} ## 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 a OpenRTB. | \*Questi attributi sono obbligatori per i formati Direct Link e Email Clicks. ### 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) | L'attributo idzone viene usato per identificare la fonte in ExoClick da cui proviene il traffico. ## 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 attuale dell'utente definita da un oggetto Geo. | | ip | Indirizzo IP dell'utente (stringa)\* | | ipv6 | Indirizzo IPv6 dell'utente (stringa)\* | | language | Lingua del browser usando ISO-639-1-alpha-2 (stringa) | | os | Sistema operativo (stringa) | | js | Supporto per JavaScript, dove 0 = no, 1 = sì (intero) | | ext | Segnaposto per estensioni specifiche dell'exchange a OpenRTB | \*Esattamente uno tra ip o ipv6 sarà presente nella richiesta di offerta. ### device.geo | Attributo | Descrizione | | --------- | ----------- | | country | Paese ISO3 | ### 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) | ## ext | Attributo | Obbligatorio? | Descrizione | | --------- | ------------- | ------------------------------------------------------------------------------------------------ | | sub | No | sub sarà un numero intero che rappresenta l'ID della zona da cui è stata originata la richiesta. | ## regs.ext | Attributo | Descrizione | | --------- | --------------------------------------------------------------------------- | | dsaapply | Flag per indicare se la DSA è applicata alla richiesta. 1 = Richiesto (int) | | dsa | Estensione per informazioni di trasparenza DSA (oggetto) | ### regs.ext.dsa | Attributo | Descrizione | | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | richiesto | Flag per indicare se le informazioni DSA devono essere rese disponibili. 0 = Non richiesto, 1 = Supportato, le risposte all'offerta con o senza oggetto DSA saranno accettate, 2 = Richiesto, le risposte all'offerta senza oggetto DSA non saranno accettate, 3 = Richiesto, le risposte all'offerta senza oggetto DSA non saranno accettate, il publisher è una piattaforma online (int) | | datatopub | Il publisher potrebbe aver bisogno dei dati di trasparenza per scopi di audit. 0 = non inviare dati di trasparenza, 1 = facoltativo inviare dati di trasparenza, 2 = inviare dati di trasparenza (int) | {% hint style="warning" %} Se ricevi **dsaapply: 1** e **required: 2 o 3**, è obbligatorio aggiungere nella risposta gli attributi dsa con valori, altrimenti la risposta verrà rifiutata. {% endhint %} ## Esempi Puoi trovare un elenco completo di tutti i tipi di richieste che puoi ricevere nella nostra [pagina di esempio della Richiesta Inserzionista](/rtb/it/inserzionisti/rtb-aperto/open-rtb-advertiser-code-examples.md). --- # 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.4-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.