> 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-response.md).

# Risposta all'offerta Open RTB 2.4

La risposta a una richiesta di offerta dovrebbe avere la seguente struttura:

## Oggetto di risposta dell'offerta

| Attributo | Obbligatorio? | Descrizione                                                                           |
| --------- | ------------- | ------------------------------------------------------------------------------------- |
| id        | Sì            | ID della richiesta di offerta a cui questa è una risposta (stringa)                   |
| seatbid   | Sì            | Raccolta di offerte effettuate dall'offerente per conto di uno specifico seat (array) |

{% hint style="info" %}
**Nota:** L'id deve corrispondere a quello fornito nella richiesta
{% endhint %}

### seatbid

| Attributo | Obbligatorio? | Descrizione                                           |
| --------- | ------------- | ----------------------------------------------------- |
| bid       | Sì            | Array dell'oggetto bid relativo all'impression target |

### seatbid.bid

| Attributo | Obbligatorio? | Descrizione                                                                                         |
| --------- | ------------- | --------------------------------------------------------------------------------------------------- |
| id        | Sì            | ID dell'oggetto bid, utilizzato per il tracciamento (stringa)                                       |
| impid     | Sì            | ID dell'oggetto impression nella relativa richiesta di offerta.                                     |
| price     | Sì            | Prezzo dell'offerta in CPM o CPC (float)                                                            |
| adm       | Sì            | Markup pubblicitario XML/JSON (stringa)                                                             |
| nurl      | Sì            | URL di notifica della vincita, si consiglia di usare **HTTP** anziché HTTPS per nurl (stringa)      |
| burl      | No            | URL di notifica della fatturazione, si consiglia di usare **HTTP** anziché HTTPS per burl (stringa) |
| crid      | Consigliato   | ID della creatività per agevolare il controllo della qualità dell'annuncio (stringa)                |
| iurl      | Consigliato   | URL della creatività                                                                                |
| ext       | No            | Estensione specifica di ExoClick (oggetto)                                                          |

{% hint style="info" %}
**Note:**

* Supportiamo il video sia nei posizionamenti banner sia in quelli interstitial.
* L'impid deve corrispondere a quello fornito nella richiesta.
* L'adm deve essere fornito in JSON o XML in base al formato pubblicitario target: JSON per Native, In-Stream e Push Notification; XML per tutti gli altri formati.
* La nURL deve essere notificata per garantire il campaign capping ed evitare di ricevere sempre la stessa risposta.
* La bURL viene richiamata quando sono state erogate impression o clic, a seconda di CPM o CPC dal campo btype (predefinito CPM).
  {% endhint %}

### seatbid.bid.ext

| Attributo | Obbligatorio? | Descrizione                                                                                                                                     |
| --------- | ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| btype     | Consigliato   | Modello di prezzo. Valori: 1 = CPM, 2 = CPC. Predefinito = 1 (int). Quando la risposta è per una richiesta di zona Email Clicks, 1 = Smart CPC. |
|           |               | **Nota**: solo Push Notification, annunci Native, Direct Link ed Email Clicks possono fare offerte con il modello di prezzo CPC.                |

### seatbid.bid.ext.dsa

| Attributo | Obbligatorio? | Descrizione                                                                                                                                                                                                                   |
| --------- | ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| behalf    | Sì            | Trasparenza dell'inserzionista: stringa di testo Unicode libera con il nome per conto di chi viene mostrato l'annuncio. Massimo 100 caratteri. (stringa)                                                                      |
| paid      | Sì            | Trasparenza dell'inserzionista: stringa di testo Unicode libera di chi ha pagato per l'annuncio. Deve essere sempre inclusa anche se è la stessa indicata nell'attributo behalf. Massimo 100 caratteri (stringa)              |
| adrender  | Sì            | Flag per indicare che il buyer/inserzionista renderizzerà le proprie informazioni di trasparenza DSA all'interno della creatività. 0 = il buyer/inserzionista non renderizzerà, 1 = il buyer/inserzionista renderizzerà (int) |

### seatbid.bid.dsa.transparency

| Attributo | Obbligatorio? | Descrizione                                                                                                                                                                                                                                    |
| --------- | ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| domain    | Sì            | Dominio dell'entità che ha applicato i parametri utente (stringa)                                                                                                                                                                              |
| params    | Sì            | Array del targeting dei parametri utente applicati dal buy-side (usando l'elenco fornito dalla DSA Transparency Taskforce). Includere il supporto per più vendor che possono aggiungere i propri parametri di targeting utente. (array di int) |

## Nessuna risposta all'offerta

Per rispondere a una richiesta di offerta senza effettuare una vera offerta, deve essere inviato il codice di risposta HTTP 204 "No Content".

## URL di notifica della vincita e della fatturazione

Se sia **nURL** o **bURL** sono nella risposta bid e sono URL validi, la piattaforma ExoClick invierà una richiesta GET a essi.\
Questi URL possono contenere alcuni token da sostituire con ExoClick prima di eseguire la GET:

```
${AUCTION_ID} - ID della richiesta di offerta; dall'attributo "Bid Request Object -> id".
${AUCTION_BID_ID} - ID dell'offerta; dall'attributo "Bid Response Object -> bidid".
${AUCTION_IMP_ID} - ID dell'impression appena vinta; dall'attributo "Bid Request Object -> Impression Object -> id".
${AUCTION_SEAT_ID} - ID del seat dell'offerente per cui è stata effettuata l'offerta; dall'attributo "Bid Response Object -> Seat Bid Object -> Bid Object -> id".
${AUCTION_AD_ID} - ID del markup pubblicitario che l'offerente desidera servire; dall'attributo "Bid Response Object -> Seat Bid Object -> Bid Object -> adid".
${AUCTION_PRICE} - Prezzo di regolamento usando la stessa valuta e le stesse unità dell'account; dall'attributo "Bid Response Object -> Seat Bid Object -> Bid Object -> price".
${AUCTION_CURRENCY} - La valuta usata nell'offerta (esplicita o implicita); solo a scopo di conferma.
```

Esempio:

```
https://mysite.com/my_notification_url?id=${AUCTION_ID}&bidid=${AUCTION_BID_ID}&price=${AUCTION_PRICE}&currency=${AUCTION_CURRENCY}
```

Se stai usando sia **nURL** e **bURL**, ExoClick effettuerà una chiamata a entrambi.

## Struttura dell'ADM

A seconda del formato dell'annuncio, il **adm** parametro può contenere un frammento di XML o JSON. Puoi trovare esempi dettagliati delle strutture adm nella nostra [**pagina degli esempi**](/rtb/it/inserzionisti/rtb-aperto/open-rtb-advertiser-code-examples.md)

Quando crei l'ADM, tieni presente quanto segue:

* **markup iFrame** (Banner, Fullpage Interstitial) devono essere abilitati nel tuo account ExoClick per poterli utilizzare.
* **In-Stream, Native** e **annunci Push Notification** devono contenere una stringa codificata in JSON nell'adm.
* Il parametro adm di **In-Stream** può seguire una delle due strutture: **Remote VAST** o **Local VAST**. In Remote VAST, devi semplicemente dichiarare l'URL in cui si trova il VAST Wrapper, mentre in Local VAST devi dichiarare qualsiasi **"trackingEvents"** che desideri tracciare oltre a "videoURL" e "clickURL".

Attualmente supportiamo **impression**, **progress** e **complete** eventi. Gli eventi impression e progress sono **obbligatori**, mentre complete può essere aggiunto solo se utilizzi Local VAST.

L'ADM **deve** seguire la stessa struttura mostrata nel nostro [esempio](/rtb/it/inserzionisti/rtb-aperto/open-rtb-advertiser-code-examples.md) sopra.

* Come parametro opzionale, puoi includere **crop\_anchor\_point** nella stringa JSON dell'adm delle **Native Ads** per determinare dove si trova il punto di ancoraggio della tua immagine native. I valori disponibili sono:
  * MIDDLE\_CENTER = 0,
  * TOP\_LEFT = 1,
  * TOP\_CENTER = 2,
  * TOP\_RIGHT = 3,
  * MIDDLE\_LEFT = 4,
  * MIDDLE\_RIGHT = 5,
  * BOTTOM\_LEFT = 6,
  * BOTTOM\_CENTER = 7,
  * BOTTOM\_RIGHT= 8

Ecco una visualizzazione dei punti di ancoraggio disponibili:

![punto di ancoraggio del crop](/files/2107d16519370b667efea5a5c015edb87d3c7fe1)

* Inoltre, per quanto riguarda **Native Ads**, assicurati di aggiungere i tuoi **eventtrackers** secondo la [più recente specifica native](https://www.iab.com/wp-content/uploads/2018/03/OpenRTB-Native-Ads-Specification-Final-1.2.pdf)

Nota che, sebbene consentiamo anche **gli imptrackers** nelle Native Ads, raccomandiamo vivamente di usare **eventtrackers** invece.

* **Push Notification** gli annunci consentono solo un asset immagine per notifica. La larghezza e l'altezza dipendono da ciò che arriva dalla richiesta, che può essere 192x192 o 720x480. Nota che l'adm deve anche essere una stringa codificata in JSON, poiché la richiesta proverrà da un oggetto Native.
* Infine, **Push Notification** gli annunci consentono solo un **URL "imptracker"**

## Esempi

Puoi trovare esempi dettagliati delle risposte bid e delle strutture ADM nella nostra [pagina di esempio delle risposte dell'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-response.md?ask=<question>&goal=<endgoal>
```

`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.