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