> 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/exoclick-rtb/bid-response.md). # Risposta all'offerta RTB di ExoClick La risposta all'offerta RTB di ExoClick può essere realizzata utilizzando JSON e XML. La risposta a una richiesta di offerta deve avere la seguente struttura: ## Oggetto della risposta all'offerta | Attributo | Descrizione | | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------- | | id | ID dell'oggetto impressione a cui si applica questa offerta (stringa) | | imgUrl | URL dell'immagine (solo per il tipo banner) | | iconUrl | URL dell'icona (solo per il tipo push\_notification e deve avere le dimensioni richieste) | | clickUrl | URL di inoltro quando la campagna viene cliccata (per il tipo banner o push\_notification) | | url | URL di inoltro quando la campagna viene cliccata (solo per il tipo popunder) | | title | Titolo dell'annuncio (solo per il tipo push\_notification) | | description | Descrizione dell'annuncio (solo per il tipo push\_notification) | | value | Prezzo dell'offerta in CPM o CPC (float) | | imptrackers | Tracker delle impressioni, opzionali (solo per il tipo push\_notification) | | btype | Modello di prezzo. Valori: 1 = CPM, 2 = CPC. Predefinito = 1 (int). Quando la risposta è per una richiesta di una zona Email Clicks, 1 = Smart CPC. | | bUrl | URL di notifica di fatturazione, si consiglia di usare HTTP invece di HTTPS per bUrl | **Note:** * **"id"** l'attributo deve corrispondere all' **"id" ricevuto nella richiesta**. * **Push Notification** il formato dell'annuncio può ricevere offerte con il modello di prezzo CPC. **Direct Link** il formato può anche, quando utilizzato per **Email Click** richieste di zona. * Inoltre, quando si eseguono annunci Push Notification, è consentito solo un URL **imptracker** URL. * **bURL** viene chiamato quando l'impressione o il clic è stato consegnato, a seconda di CPM o CPC dal campo btype (CPM predefinito) ## Nessuna risposta di offerta Per rispondere a una richiesta di offerta senza effettuare un'offerta reale, deve essere inviato un codice di risposta HTTP 204 "No Content". ## Aggiungi token dinamici al tuo endpoint Oltre alle informazioni che ricevi tramite la richiesta, puoi anche aggiungere **token dinamici** al tuo endpoint. Questo ti permetterà di rilevare rapidamente l'origine della richiesta quando esamini le richieste ricevute. Qui troverai i token più comuni usati da ExoClick: * **{site\_id}**: Il numero ID del sito in cui viene mostrato l'annuncio. * **{zone\_id}**: L'ID della zona pubblicitaria in cui viene mostrato l'annuncio. * **{src\_hostname}**: Il nome del sito che il Publisher ha inviato per la visualizzazione degli annunci, senza includere il protocollo HTTP all'inizio (ad es. examplesite.com). * **{url}**: L'URL completo del sito che il Publisher ha inviato al Pannello di amministrazione per la visualizzazione degli annunci, incluso il protocollo HTTP (ad es. ). Nota: questo token non mostrerà l'URL in cui l'annuncio è stato mostrato all'utente; solo l'URL registrato nella nostra piattaforma. * **{tags}**: L'elenco delle parole chiave che sono state identificate per quella impressione dell'annuncio. * **{keyword}**: La parola chiave che è stata corrisposta nel caso di campagne che puntano a parole chiave specifiche. Questo sarà vuoto se non c'è alcuna corrispondenza. * **{language}**: La lingua del visitatore. * **{\&empty=204}**: Aggiungilo all'endpoint ogni volta che restituisci una risposta No Bid. * **{imp\_id}**: Aggiungilo per ricevere l'ID dell'impressione nell'endpoint. Se hai bisogno di altri token o devi tracciare dettagli aggiuntivi, contatta il tuo account manager. ## Esempi Puoi trovare esempi dettagliati della risposta all'offerta nella nostra [pagina di esempio della risposta dell'inserzionista](/rtb/it/inserzionisti/exoclick-rtb/exoclick-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/exoclick-rtb/bid-response.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.