> 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.4-request.md). # Richiesta di offerta Open RTB 2.4 Questa pagina spiega come effettuare richieste di 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` I seguenti oggetti devono essere inviati codificati come JSON nel corpo della richiesta: ## 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 tramite un oggetto Site sul sito web del publisher (oggetto). | | app | Sì | Dettagli tramite un oggetto App sull'app dell'editore\* (oggetto). | | device | Sì | Dettagli tramite un oggetto Device sul dispositivo dell'utente a cui verrà consegnata l'impression (oggetto). | | user | No | Dettagli tramite un oggetto User 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) | | bidfloorcur | No | Valuta per il valore minimo dell'offerta specificato usando codici alfabetici ISO-4217 (stringa) | | native | Solo per imp native e push | Un'opportunità per un oggetto Native (oggetto). | | banner | Solo per imp banner e interstitial a pagina intera | Un'opportunità per un oggetto Banner (oggetto). | | instl | Solo per imp pop, direct link, email e click interstitial a pagina intera | Un'opportunità per un oggetto Fullscreen (oggetto). | | video | Solo per video | Un'opportunità per un oggetto Video (oggetto) | | secure | Consigliato | Flag per indicare se l'impression richiede asset creativi e markup con URL HTTPS sicuro, dove 0 = non sicuro, 1 = sicuro (opzione consigliata). Se omesso, lo stato di sicurezza è sconosciuto, ma si può presumere il supporto per HTTP non sicuro (intero) | | el | No | Email codificata in Base64 (stringa) | | ext | No | Segnaposto per estensioni specifiche dell'exchange | ### imp.banner | Attributo | Obbligatorio? | Descrizione | | --------- | ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | | w | Sì | Larghezza del banner (intero) | | h | Sì | Altezza del banner (intero) | | mimes | No | Elenco dei tipi MIME supportati (array di stringhe). Supportiamo: image/jpeg, image/jpg, image/png, image/png, image/gif, image/webp, video/mp4 | | ext | No | Segnaposto per estensioni specifiche dell'exchange (oggetto) | ### imp.banner.ext | Attributo | Obbligatorio? | Descrizione | | ------------- | ------------- | ------------------------------------------------------------- | | image\_output | No | Indica il formato di output per i banner immagine\* (stringa) | | video\_output | No | Indica il formato di output per i banner video\* (stringa) | \*Definisce il formato del campo adm per il formato banner. Le opzioni sono xml o html. Il valore predefinito è xml se il campo non viene fornito. ### imp.instl | Attributo | Obbligatorio? | Descrizione | | --------- | ------------- | ------------------------------------------------------------------------- | | instl | Sì | 0 = clic su link diretto/email, 1 = popunder/interstitial a pagina intera | ### imp.native (per annunci Native e Push Notification) | Attributo | Obbligatorio? | Descrizione | | --------- | ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | request | Sì | 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 | No | Versione dell'API Dynamic Native Ads a cui **request** è conforme (stringa) | ### imp.native.request | Attributo | Obbligatorio? | Descrizione | | --------- | ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | ver | Sì | Versione del markup Native in uso (stringa) | | context | No | 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 | Sì | Il design/formato/layout dell'unità pubblicitaria offerta. Attualmente supportiamo **4** (*Widget di raccomandazione*) e **500** (*Notifica push*) (intero) | | plcmtcnt | No | Il numero di posizionamenti identici in questo Layout. Max: 10 (intero) (intero) | | assets | Sì | 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 | No | 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 | Obbligatorio? | Descrizione | | --------- | ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | | id | Sì | ID univoco dell'asset, assegnato dall'exchange. Tipicamente un contatore per l'array (intero) 1: ID asset immagine, 2: ID asset titolo, 3: ID asset descrizione | | richiesto | No | Imposta su **1** se l'asset è richiesto o **0** se l'asset è opzionale (intero) | | plcmtcnt | No | Il numero di posizionamenti identici in questo layout (intero) | | img | Sì | Oggetto Image per gli asset immagine\*\* (oggetto JSON) | | title | No | Oggetto Title per gli asset titolo\*\* (oggetto JSON) | | data | No | Oggetto dati per nome del marchio, descrizione, valutazioni, prezzi ecc.\* (oggetto JSON) | \*La quantità di offerte ricevute per la tua richiesta Native si baserà sul valore impostato in "plcmtcnt". Ad esempio, una richiesta di offerta con "plcmtcnt":3 riceverà 3 diversi oggetti offerta. Puoi trovare un esempio di questo nella [pagina di esempio della risposta](/rtb/it/editori/rtb-aperto/open-rtb-publisher-code-examples.md). \*\* In ogni oggetto asset deve essere presente solo uno degli oggetti {img, title, data} ### imp.native.request.assets.img | Attributo | Obbligatorio? | Descrizione | | --------- | ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | type | No | ID del tipo di elemento immagine supportato dal publisher. Supportiamo: **1** (*Immagine icona*) (intero), **3** (*Anteprima immagine grande per l'annuncio*) (intero) | | w | No | Larghezza dell'immagine in pixel, facoltativo (intero) | | h | No | Altezza dell'immagine in pixel, facoltativo (intero) | | wmin | Sì | Larghezza minima richiesta dell'immagine in pixel (intero) | | hmin | Sì | Altezza minima richiesta dell'immagine in pixel (intero) | \*Dimensioni dell'icona della Push Notification: 192px x 192px ### imp.native.request.assets.title | Attributo | Obbligatorio? | Descrizione | | --------- | ------------- | ---------------------------------------------------------- | | len | Sì | Lunghezza massima del testo nell'elemento titolo. (intero) | ### imp.native.request.assets.data | Attributo | Obbligatorio? | Descrizione | | --------- | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | type | Sì | 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 | No | Lunghezza massima del testo nella risposta dell'elemento (intero) | ### imp.video | Attributo | Obbligatorio? | Descrizione | | --------- | ------------- | ----------------------------------------------------------------------------------------------------------------------------------- | | mimes | No | Elenco dei tipi mime supportati (array di stringhe) | | protocols | No | Elenco dei protocolli di risposta alle offerte video supportati (array di int) | | skip | No | Indica se il player consentirà di saltare il video, dove 0 = no, 1 = sì | | skipafter | No | Numero di secondi che un video deve essere riprodotto prima che il salto sia abilitato; applicabile solo se l'annuncio è saltabile | | skipmin | No | I video con durata totale superiore a questo numero di secondi possono essere saltabili; applicabile solo se l'annuncio è saltabile | {% hint style="info" %} Se fornisci solo "skip" nella richiesta ma non "skipafter", il video sarà saltabile dopo 5 secondi. La risposta imposterà "skipoffset" a 5.\ Se fornisci "skip" ma non "skipmin", il video sarà saltabile indipendentemente dalla sua durata. {% endhint %} ### imp.ext | Attributo | Obbligatorio? | Descrizione | | ---------- | ------------- | -------------------------------------------------------------------------- | | video\_cta | No | Indica se devono essere forniti i CTA, dove 0 = no, 1 = sì (predefinito 1) | Per vedere un esempio di CTA, consulta la nostra [pagina di esempio della risposta](/rtb/it/editori/rtb-aperto/open-rtb-publisher-code-examples.md). ## site | Attributo | Obbligatorio? | Descrizione | | --------- | ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | id | Obbligatorio | ID univoco del sito (stringa) | | domain | Obbligatorio | Nome di dominio del sito (stringa) | | nome | Obbligatorio | Nome 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 devono essere una stringa di parole separate da virgole. | | ext | No | Segnaposto per estensioni specifiche dell'exchange a OpenRTB. | ### site.ext | Attributo | Obbligatorio? | Descrizione | | ----------- | ------------- | ------------------------------------------------- | | exchangecat | No | ID categoria personalizzato ExoClick (intero) | | idzone | No | ID personalizzato della Ad Zone ExoClick (intero) | ## app | Attributo | Obbligatorio? | Descrizione | | --------- | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | id | Obbligatorio | ID univoco dell'app (stringa) | | cat | No | ID categoria IAB (array di stringhe) | | keywords | No | Le parole chiave possono essere usate per garantire che le zone pubblicitarie ricevano il giusto tipo di pubblicità. Le parole chiave devono essere una stringa di parole separate da virgole (stringa) | | editore | No | Dettagli sull'editore (oggetto) | ### app.publisher | Attributo | Obbligatorio? | Descrizione | | --------- | ------------- | ---------------------------------------------------------------------------- | | domain | Consigliato | Dominio di livello più alto dell'editore (ad es., "publisher.com") (stringa) | ## device | Attributo | Obbligatorio? | Descrizione | | --------- | ------------- | ------------------------------------------------------------------------------------------------ | | ua | Sì | User agent del browser (stringa) | | geo | No | Posizione del dispositivo assunta come posizione attuale dell'utente definita da un oggetto Geo. | | ip | Sì | Indirizzo IP dell'utente (stringa)\* | | ipv6 | Consigliato | Indirizzo IPv6 dell'utente (stringa)\* | | language | Consigliato | Lingua del browser usando ISO-639-1-alpha-2 (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 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) | ## user | Attributo | Obbligatorio? | Descrizione | | --------- | ------------- | --------------------------- | | id | Sì | ID utente univoco (stringa) | {% hint style="info" %} Se non puoi generare una stringa ID utente, puoi lasciarla vuota (""). La richiesta riceverà una risposta purché l'oggetto "user" sia incluso nella richiesta. {% endhint %} ## ext | Attributo | Obbligatorio? | Descrizione | | --------- | ------------- | ------------------------------------------------------------------------------------------------------ | | sub | No | Il Sub ID. Deve essere un numero compreso tra una e dieci cifre: non usare zeri all'inizio dei Sub ID. | | esporta | No | Il tipo di risposta può essere "json" o "xml" (stringa). Il valore predefinito è "json". | ## Esempi Puoi trovare un elenco dettagliato di esempi di richiesta nella nostra [pagina di esempio](/rtb/it/editori/rtb-aperto/open-rtb-publisher-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/editori/rtb-aperto/pub-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.