Articoli di aiutoRiferimento API
Inizia qui
IniziareFAQPiani e prezzi
Prezzi e pianiInserzionisti
Gestire campagneEditor
Aggiungi un sito e un tag pubblicitarioDenaro
Depositi e pagamentiAccount
Sicurezza dell'accountSviluppatori
Riferimento APILegale
Termini di ServizioInformativa sulla privacyL’API REST di Adgora consente di consultare statistiche, elencare e sospendere campagne, controllare saldi ed elencare zone in modo programmatico. URL di base: https://api.adgora.net. Tutte le risposte sono in formato JSON.
Autenticazione
Crei una coppia di chiavi nel suo profilo (la chiave segreta viene mostrata una sola volta). La invii con ogni /v1 richiesta:
Authorization: Bearer {public_key}:{secret}Le richieste sono limitate a 120 al minuto per account; superato il limite, viene restituito 429 con un Retry-After header. Le chiavi hanno ambiti di autorizzazione (stats, campaigns, balance, zones); se manca un ambito richiesto, viene restituito 403.
Endpoint
| Metodo & percorso | Ambito | Risposta |
|---|---|---|
GET /v1/balance | balance | saldi in USD di inserzionisti & publisher |
GET /v1/stats?days=7 | stats | dati giornalieri (aggiunga role=publisher per la vista publisher) |
GET /v1/campaigns | campaigns | le sue campagne |
POST /v1/campaigns/{id}/pause | campaigns | sospende una campagna |
POST /v1/campaigns/{id}/resume | campaigns | riprende una campagna |
GET /v1/zones | zones | le sue zone publisher |
Esempio
curl -H "Authorization: Bearer PUBLICKEY:SECRET" \
"https://api.adgora.net/v1/stats?days=30"Postback S2S delle conversioni
Per monitorare le conversioni CPA, richiami l’URL di postback dal server dell’inserzionista quando si verifica una conversione. La {clickid} macro viene trasmessa alla pagina di destinazione tramite l’URL del clic — la acquisisca e la invii nuovamente:
https://api.adgora.net/s2s?clickid={clickid}&status=confirmed&secret=YOUR_OFFER_SECRET&order_ref=ORDER123status può essere confirmed, delivered, rejected oppure returned; order_ref è l’identificativo facoltativo del suo ordine. La chiave segreta dell’offerta si trova nella pagina dell’offerta.
Macro dell’URL di destinazione
Aggiunga queste macro all’URL di destinazione di una creatività — Adgora le sostituisce al momento del clic:
{clickid} {zoneid} {campaignid} {creativeid} {geo} {country} {device} {sub1}…{sub5}Crea una richiesta
Scegli un endpoint e parametri — il comando si aggiorna mentre procedi. Le chiavi rimangono segnaposto: non incollare mai un segreto in una pagina web.
https://api.adgora.net/v1/balancecurl -H "Authorization: Bearer PUBLICKEY:SECRET" "https://api.adgora.net/v1/balance"PUBLICKEY:SECRET è un segnaposto. Crea una chiave nel tuo profilo e conserva il segreto sul tuo server.
