> 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/api/it/api-pubblica-di-exoclick/api-per-sviluppatori.md).
# API per sviluppatori
Con l'API della piattaforma è possibile automatizzare tutte le funzionalità presenti nel pannello di amministrazione.
1. Cosa possono automatizzare gli inserzionisti?
* Campagne/gruppi, varianti, offerte e formati pubblicitari
* Targeting/blocco delle opzioni di targeting, categorie
* Obiettivi
* Recupera le statistiche, inclusi i dati degli utenti con adblock
* Budget giornaliero, ricarica del conto, tipi di pagamento
* Nome della landing page, URL e algoritmo di ripartizione del traffico
2. Cosa possono automatizzare i publisher?
* Formati pubblicitari e zone pubblicitarie
* Siti, verifiche degli URL
* Blocca tipi di annunci e categorie di prodotto
* Recupera tutte le statistiche, inclusi i dati degli utenti con adblock
* Prezzi di offerta per formato pubblicitario/GEO, modelli di prezzo
* Tipi di pagamento
3. Come usare l'API
* L'interfaccia dell'API è veloce e facile da usare
* Seleziona semplicemente un parametro e premi il **Provalo** pulsante per generare automaticamente il codice
4. Scarica la documentazione tecnica
* [Client PHP](https://github.com/exads/exads-api-client-php)
## Come usare l'API della piattaforma
Abbiamo appena aggiornato la nostra API della piattaforma alla versione 2. Quest'ultima versione ti consente di automatizzare ogni singola funzionalità all'interno del pannello di amministrazione. Puoi utilizzare l'API per processi semplici, come l'automazione di attività ripetitive per risparmiare tempo, fino a progetti più complessi, come la modifica al volo delle creatività dei banner.
### Funzionalità
Sia i publisher sia gli inserzionisti hanno a disposizione una vasta gamma di funzionalità. Ecco un riepilogo di ciò che può essere automatizzato:
#### Inserzionisti
* Campagne individuali/di gruppo, varianti, offerte, formati pubblicitari.
* Targeting/blocco delle opzioni di targeting, categorie, fasce orarie.
* Obiettivi.
* Recupera le statistiche, inclusi i dati degli utenti con adblock.
* Budget giornaliero, ricarica del conto, tipi di pagamento.
* Nome della landing page, URL e algoritmo di ripartizione del traffico.
#### Editori
* Formati pubblicitari e zone pubblicitarie.
* Siti, verifiche degli URL.
* Blocca tipi di annunci e categorie di prodotto.
* Recupera tutte le statistiche, inclusi i dati degli utenti con adblock.
* Prezzi di offerta per formato pubblicitario/GEO, modelli di prezzo.
* Tipi di pagamento.
**Prima di iniziare**
L'interfaccia dell'API mostra un elenco di titoli di gruppi. Fai clic su un gruppo e tutte le opzioni disponibili verranno visualizzate in un menu a discesa.
### Verbi HTTP
L'API supporta il seguente sottoinsieme di verbi HTTP. Nota che non tutte le funzionalità supporteranno tutti i verbi.
Iniziamo!
### Configurazione
Per accedere alle richieste API con restrizioni, deve essere impostato un token di sessione. Per impostare un token, devi avere un account valido.
La creazione del token API è disponibile sotto il tuo **Il mio profilo** menu. Seleziona Token API.
Fai clic su **Nuovo token API**.
Digita il nome del token; per questo tutorial abbiamo chiamato il nostro ‘testToken’, poi fai clic su **Salva**.
L'ID del token viene creato.
### Accesso all'API
Nell'interfaccia dell'API, fai clic sul **Accedi** pulsante in alto a destra dello schermo e inserisci nome utente e password oppure fornisci un token API. Fai clic su **Invia** e verrà inviata all'API una richiesta di accesso per recuperare un token di sessione valido. Questo token verrà quindi utilizzato per convalidare tutte le richieste API che desideri effettuare durante la sessione.
### Come effettuare una richiesta all'API
Usiamo l'esempio del gruppo Campaigns, fai clic su di esso e il gruppo si espanderà per elencare le richieste disponibili:
Fai clic sulla richiesta che desideri automatizzare; in questo esempio richiederemo i dati per il CID 1923724 usando:
Fai clic su **Ottieni campagna** che espande la finestra. Inserisci il numero ID della campagna nel campo:
Quindi fai clic sul **Provalo ora** pulsante. Il corpo della risposta genererà automaticamente il codice.
Un codice di risposta 200 significa che va bene da usare.
### Come mettere in pausa una campagna
Ecco un altro esempio. Per prima cosa seleziona la funzione corretta dal gruppo Campaigns:
Fai clic su **Pausa** per una o più campagne. Una volta aperto, fai clic su Valore di esempio, poi fai clic sulla casella gialla: questo incollerà automaticamente la struttura JSON nella casella del corpo.
Ora il valore corrente è zero, quindi cambia lo zero con il CID che desideri mettere in pausa. Quindi fai clic sul **Provalo** pulsante per generare il codice necessario.
### Come aggiornare il prezzo di una campagna
Seleziona la funzione corretta:
Fai clic su **Aggiorna una campagna**, per aprire la finestra. Aggiungi il CID nel campo ID campagna, quindi fai clic su Valore di esempio e sulla casella gialla, che copierà la struttura JSON nella casella del corpo.
Questo codice contiene alcune funzioni diverse, ma ci interessa il codice del prezzo della campagna, quindi elimina la parte di codice non necessaria lasciando nella casella il codice del prezzo della campagna, come sotto:
Ora dobbiamo cambiare due cose nella casella del corpo, il modello (qui sotto c'è un elenco dei valori relativi al modello di prezzo).
```
CampaignPricing {
model (integer, optional): modello di prezzo della campagna (1: CPC, 2: CPM, 3: CPA, 4: Smart CPM, 5: CPV) = ['1', '2', '3', '4', '5'],
price (number, optional): prezzo della campagna
}
```
Restiamo su CPC, quindi lasceremo il modello a 1
Ora dobbiamo cambiare il prezzo da zero al prezzo desiderato. Lo cambieremo a 200, il che significa che il nuovo prezzo sarà di 200 centesimi, cioè due euro.
Quindi fai semplicemente clic sul **Provalo** pulsante per generare il codice. Facile!
Come puoi vedere, l'API è ricca di funzionalità da automatizzare; l'unico limite è la tua immaginazione per sbloccare il potere dell'automazione.
Infine, assicurati di iscriverti alla nostra newsletter dell'API, che trovi in fondo all'interfaccia dell'API, così potrai ricevere le ultime novità e gli aggiornamenti.
---
# 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/api/it/api-pubblica-di-exoclick/api-per-sviluppatori.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.