> 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/mcp/it/exoclick-mcp-tools.md). # Strumenti disponibili Una volta connesso, il tuo assistente AI avrà accesso ai seguenti strumenti. Non è necessario chiamarli direttamente: ti basta porre la tua domanda in linguaggio naturale e l'AI utilizzerà automaticamente lo strumento appropriato. ## Cosa può fare una connessione Quando colleghi un client AI, scegli un livello di accesso per ciascuna funzionalità:
LivelloSignificato
LetturaL'AI può visualizzare questi dati.
ScritturaL'AI può visualizzare questi dati e apportare modifiche.
Nessun accessoL'AI non può utilizzare affatto questa funzionalità.
Queste impostazioni limitano solo ciò che l'AI può fare. Una connessione non può mai fare più di quanto il tuo account consenta già. Le funzionalità che il tuo account non possiede e quelle che non sono ancora disponibili non vengono mostrate. Vedi [Connessione del client AI](/mcp/it/exoclick-mcp-connecting-ai-client.md) per sapere dove viene impostato. ## **Statistiche** Visualizza i dati di performance del tuo account, con filtri e raggruppamenti flessibili. Disponibile per inserzionisti ed editori, ciascuno limitato ai propri dati. **Accesso:** Lettura ### Statistiche inserzionista Interroga le statistiche del tuo inserzionista con opzioni flessibili di filtro e raggruppamento. Questo strumento ti consente di analizzare impression, clic, conversioni, ricavi, costi e altri metriche di performance in qualsiasi combinazione di dimensioni. #### Cosa puoi chiedere * Performance della campagna in un intervallo di date * Ripartizioni per paese, dispositivo, browser, sistema operativo, zona o qualsiasi altra dimensione disponibile * I migliori o i peggiori per qualsiasi metrica * Confronti tra periodi di tempo * Viste filtrate (ad es. statistiche per una campagna o una zona specifica) #### Prompt di esempio * *Dammi le campagne migliori per spesa degli ultimi 7 giorni.* * *Qual è il mio eCPA per paese questo mese?* * *Confronta le mie impression di questa settimana con quelle della scorsa settimana, raggruppate per tipo di dispositivo.* * *Quali zone hanno avuto il CR più basso ieri?* Interroga le statistiche del tuo inserzionista con opzioni flessibili di filtro e raggruppamento. Questo strumento ti consente di analizzare impression, clic, conversioni, costi e altre metriche di performance in qualsiasi combinazione di dimensioni. ### Statistiche editore Interroga le statistiche del tuo editore con opzioni flessibili di filtro e raggruppamento. Questo strumento ti consente di analizzare impression, clic, eCPM e altri metriche di performance in qualsiasi combinazione di dimensioni. #### Cosa puoi chiedere * Performance della zona in un intervallo di date * Ripartizioni per paese, dispositivo, browser, sistema operativo, zona o qualsiasi altra dimensione disponibile * I migliori o i peggiori per qualsiasi metrica * Confronti tra periodi di tempo * Viste filtrate (ad es. statistiche per una campagna o una zona specifica) #### Prompt di esempio * *Dammi le zone migliori per ricavi degli ultimi 7 giorni.* * *Qual è il mio eCPM per paese questo mese?* * *Confronta le mie impression di questa settimana con quelle della scorsa settimana, raggruppate per tipo di dispositivo.* * *Quali zone all'interno del mio multi-formato hanno ottenuto i risultati migliori ieri?* ## Campagne Visualizza la configurazione della tua campagna senza lasciare la conversazione Questo è uno strumento **solo per inserzionisti** . **Accesso:** Lettura o scrittura ### Visualizzazione #### **Cosa puoi chiedere** * Un elenco delle tue campagne, filtrato per stato (in esecuzione, in pausa) o cercato per nome * La configurazione completa di una singola campagna (se richiedi una campagna che non esiste o appartiene a un altro account, lo strumento restituisce un chiaro errore "non trovato".) * Quante campagne hai in un determinato stato * L'offerta minima per un formato e una categoria in un determinato paese * Quali opzioni di targeting può usare il tuo account Un elenco di campagne restituisce id, nome e stato per ciascuna campagna. Chiedere informazioni su una campagna restituisce la sua configurazione completa, che include: | Area | Cosa è incluso | | --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Identità | Nome, id, gruppo di campagne, tipo di campagna, data di creazione. | | Formato annuncio | Tipo di annuncio ed etichetta, dimensione del creativo. | | Prezzi | Modello di prezzo (CPM, CPC e così via), prezzo, algoritmo di ottimizzazione, bidder collegato. | | Budget e delivery | Limiti di budget totale e giornaliero, importo speso, limiti di impression, modalità di delivery, frequency capping. | | Pianificazione | Date di inizio e fine, fuso orario, suddivisione per fasce orarie. | | Targeting | Paesi e regioni, lingue, browser, sistemi operativi, dispositivi, carrier, ISP, categorie, interessi, parole chiave, intervalli IP, siti, zone, inventario RTB e liste di retargeting. Ciascuno viene restituito come elenco targetizzato e elenco bloccato. | | Regole di zona e rete | Se le zone sono targetizzate o bloccate, impostazioni della rete partner, etichette bloccate e categorie di prodotto. | | Creatività | Ogni variante con il relativo URL di destinazione, URL di visualizzazione, offerta, stato e stato di approvazione, oltre a un conteggio riepilogativo di varianti approvate, in sospeso, rifiutate e in pausa. | Quando un campo contiene un id interno, la risposta include anche il nome leggibile accanto ad esso, così l'AI può rispondere in linguaggio naturale invece che con id grezzi. #### **Prompt di esempio** * *Quante campagne attive ho?* * *Mostrami tutte le campagne in pausa.* * *Elenca le mie campagne nel gruppo 5, ordinate per nome.* * *Ho campagne che targetizzano la Germania?* I risultati sono paginati. Per account con molte campagne, l'AI gestirà automaticamente la paginazione su più richieste. ### Creazione e aggiornamento Disponibile quando alla connessione è stato concesso l'accesso in Scrittura per questa funzionalità. Senza di esso, ogni scrittura restituisce un errore di autorizzazione. Le connessioni esistenti rimangono in sola lettura finché non ti riconnetti e imposti Campagne su Scrittura. #### **Cosa puoi chiedere:** * Crea una campagna, inclusi nome, tipo di annuncio, modello di prezzo, offerta, targeting e creatività * Aggiorna le impostazioni e il targeting di una campagna, inclusi intervallo di date e suddivisione per fasce orarie * Avvia o metti in pausa una campagna * Aggiungi o aggiorna varianti creative e avviale o mettile in pausa singolarmente * Copia una campagna, rinominandola facoltativamente o cambiandone il tipo di annuncio * Aggiungi zone a una campagna o rimuovi zone da una campagna L'LLM offre solo tipi di annuncio, categorie, modelli di prezzo e opzioni di targeting disponibili per il tuo account. #### **Prompt di esempio:** * *Crea una campagna banner CPM chiamata Summer Sale, targetizzata sulla Spagna, con offerta 0,50.* * *Aggiungi una variante 300x250 alla campagna X che punta a example.com.* * *Aumenta l'offerta della campagna X a 0,80.* * *Metti in pausa le varianti della campagna X.* * *Copia la campagna X e invece targetizza le zone.* * Targetizza le Zone X e/o Blocca la Zona X Ogni modifica viene riepilogata prima di essere applicata, quindi nulla viene scritto finché non confermi. #### **Cosa aspettarsi** | Situazione | Comportamento | | ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Una nuova campagna | Creata in pausa, a meno che tu non chieda che vada online. | | Una campagna copiata | Mantiene lo stato della campagna originale. | | Creatività | Usa asset già presenti nella tua libreria multimediale, referenziati per id o per nome. Se un nome corrisponde a più di un asset, ti viene chiesto quale usare e nulla viene modificato. | | Offerte e budget | Impostati nella valuta del tuo account. Le offerte inferiori al prezzo minimo per il paese e il formato vengono rifiutate. | | Formati non disponibili per te | Non è possibile usare tipi di annuncio e impostazioni riservati agli amministratori o disabilitati sulla tua rete. | | Non ancora supportato | Caricamento di asset, campagne Smart Bid e Dynamic CPA, archiviazione, retargeting comportamentale, targeting per interessi e targeting personalizzato specifico per rete. | ## Siti e zone Esplora i tuoi siti e le tue zone pubblicitarie in modo conversazionale, elencali, filtrali e cercali, e approfondisci la configurazione di un singolo sito o zona, inclusi quali etichette e categorie di prodotto una zona blocca. Questo è uno strumento **solo per editori** . **Accesso:** Lettura o scrittura ### Visualizzazione * Un elenco dei tuoi siti o delle tue zone, filtrato per stato, tipo di sito o tipo di annuncio, oppure cercato per nome * Le zone appartenenti a un sito specifico * La configurazione completa di un singolo sito o zona * Quali delle tue zone sono attive **Chiedere informazioni su un sito restituisce:** | Area | Cosa è incluso | | --------------- | --------------------------------------------------- | | Identità | Nome, id, URL, descrizione. | | Classificazione | Tipo di sito (sito web, app e così via), categoria. | | Stato | Stato attivo e stato di approvazione. | **Chiedere informazioni su una zona restituisce una configurazione molto più completa, che include:** | Area | Cosa è incluso | | --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | | Identità | Nome, id, id e nome del sito genitore. | | Formato | Tipo di annuncio e etichetta dell'editore, dimensione, se la zona è responsive e, per le zone multi-formato, le sotto-zone e i relativi layout. | | Prezzi | CPM minimo, tipo di floor (soft o hard), modelli di prezzo. | | Controlli di delivery | Frequency capping, impression capping, frequenza di refresh dell'annuncio, restrizioni del browser, annunci di fallback. | | Aspetto | Posizione sticky, bordo e colore, colori del testo, font, impostazione della miniatura. | | Video | Impostazioni pre-roll, mid-roll e post-roll, configurazione VAST, supporto wrapper VAST, VMAP, overlay CTA, tempo di salto. | | Impostazioni pop | Metodo di attivazione, classi di attivazione, ritardo, fallback, comportamento in nuova scheda. | | Blocco | Etichette bloccate dall'editore, categorie di prodotto bloccate, regole di conformità. | | Categoria | Categoria principale e secondaria. | | Flag | Stato attivo, tracking dell'inventario, livello di certificazione, bid shading, BURL, dialogo di trasparenza dell'annuncio. | Quando un campo contiene un id interno, la risposta include anche il nome leggibile accanto ad esso, così l'AI può rispondere in linguaggio naturale invece che con id grezzi. I risultati sono paginati, quindi gli account grandi vengono restituiti in batch invece che tutti insieme. #### **Prompt di esempio** * *Quali delle mie zone sono attive?* * *Com'è la configurazione sul sito X?* * *Elenca tutte le zone del mio sito X.* * *Quali delle mie zone hanno impostato un floor CPM?* * *Mostrami le etichette bloccate sulla zona X.* * *Elenca i miei siti che sono ancora in attesa di approvazione.* ### **Creazione e aggiornamento** Disponibile quando alla connessione è stato concesso l'accesso in Scrittura per questa funzionalità. Senza di esso, ogni scrittura restituisce un errore di autorizzazione. Le connessioni autorizzate prima dell'introduzione dei livelli di accesso sono in sola lettura finché non ti riconnetti. #### **Cosa puoi chiedere:** * Crea un sito * Crea una zona di qualsiasi tipo di annuncio supportato, inclusi RTB, native widget, VAST in-video, web push, in-page push e multi-formato * Aggiorna il nome, la descrizione o la categoria di un sito * Aggiorna le impostazioni di una zona o spostala su un sito diverso #### **Prompt di esempio:** * *Crea un nuovo sito per example.com nella categoria Intrattenimento.* * *Aggiungi una zona banner, 300x250, al mio sito X.* * *Rinomina la zona 1234567 in Homepage Top.* * *Sposta la zona 1234567 nel mio altro sito.* Ogni modifica viene riepilogata prima di essere applicata, quindi nulla viene scritto finché non confermi. #### **Cosa aspettarsi** | Situazione | Comportamento | | ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------- | | Un nuovo sito | Può essere restituito come non verificato, nel qual caso la verifica viene completata nel pannello di amministrazione. | | Modificare la categoria di un sito | Riporta il sito in attesa di approvazione. | | L'URL e il tipo di un sito | Impostati alla creazione e non possono essere modificati in seguito. | | Il tipo di annuncio di una zona | Impostati alla creazione e non possono essere modificati in seguito. | | Le zone banner e mobile banner | Richiedono una dimensione. | | Zone RTB | Richiedono un partner ad exchange e non prevedono una dimensione. | | Formati non disponibili per te | I formati riservati agli amministratori o disabilitati sulla tua rete non possono essere creati. | ## **Riferimento: strumenti per funzionalità** Se il tuo client AI mostra i nomi grezzi degli strumenti, questo è l'elenco completo. | Strumento | Funzionalità | Accesso | | ----------------------------------- | --------------------------- | ------------------ | | get\_advertiser\_global\_statistics | Statistiche (inserzionista) | Lettura | | get\_publisher\_global\_statistics | Statistiche (editore) | Lettura | | get\_campaigns | Campagne | Lettura | | get\_campaign | Campagne | Lettura | | get\_campaign\_groups | Campagne | Lettura | | get\_zone\_targeting\_options | Campagne | Lettura | | get\_minimum\_prices | Campagne | Lettura | | create\_campaign | Campagne | Scrittura | | update\_campaign | Campagne | Scrittura | | copy\_campaign | Campagne | Scrittura | | add\_campaign\_variation | Campagne | Scrittura | | play\_campaign\_variations | Campagne | Scrittura | | pause\_campaign\_variations | Campagne | Scrittura | | add\_campaign\_zones | Campagne | Scrittura | | remove\_campaign\_zones | Campagne | Scrittura | | get\_sites | Siti e zone | Lettura | | get\_site | Siti e zone | Lettura | | get\_zones | Siti e zone | Lettura | | get\_zone | Siti e zone | Lettura | | create\_site | Siti e zone | Scrittura | | update\_site | Siti e zone | Scrittura | | create\_zone | Siti e zone | Scrittura | | update\_zone | Siti e zone | Scrittura | | get\_collection | Di supporto | Sempre disponibile | ## Repository pubblico di skill Insieme all'MCP Server, ExoClick ha accesso a un [**repository pubblico di skill predefinite**](https://github.com/EXADS/ai-skills), che sono prompt e workflow ottimizzati progettati per attività pubblicitarie comuni. Queste skill ti offrono un vantaggio iniziale con approcci collaudati per attività come l'analisi quotidiana delle performance, le revisioni di ottimizzazione delle campagne e il reporting. | Skill | Cosa fa | | --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- | | daily-top-campaigns | Mostra le campagne dell'inserzionista con le migliori performance per un singolo giorno. | | statistics-analysis | Analizza le performance dell'inserzionista in un intervallo di date e le confronta con una finestra precedente. | | fetch-advertiser-statistics | Recupera le statistiche dell'inserzionista per qualsiasi dimensione supportata, utilizzabile da solo o come blocco di base per altre skill. | | fetch-publisher-statistics | Recupera le statistiche dell'editore per qualsiasi dimensione supportata. | Le skill sono del tutto opzionali. L'MCP Server funziona con qualsiasi prompt o domanda scrivi tu stesso. Il repository delle skill è semplicemente lì per aiutarti a iniziare più velocemente e a beneficiare di workflow che sono stati testati e perfezionati dal team di ExoClick. --- # 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 by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.exoclick.com/mcp/it/exoclick-mcp-tools.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. 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.