HilfeartikelAPI-Referenz
Hier anfangen
Erste SchritteFAQPläne & Preise
Preise & PläneWerbetreibende
Kampagnen durchführenPublisher
Eine Website & Anzeigetag hinzufügenGeld
Einzahlungen & AuszahlungenKonto
KontosicherheitEntwickler
API-ReferenzRechtliches
NutzungsbedingungenDatenschutzrichtlinieMit der Adgora REST API können Sie Statistiken abrufen, Kampagnen auflisten und pausieren, Kontostände prüfen und Zonen programmatisch auflisten. Basis-URL: https://api.adgora.net. Alle Antworten sind JSON.
Authentifizierung
Erstellen Sie ein Schlüsselpaar in Ihrem Profil (das Geheimnis wird nur einmal angezeigt). Senden Sie es bei jeder /v1 Anfrage mit:
Authorization: Bearer {public_key}:{secret}Anfragen sind begrenzt auf 120 pro Minute und Konto; bei Überschreitung erhalten Sie 429 mit einem Retry-After Header. Schlüssel haben Berechtigungsbereiche (stats, campaigns, balance, zones); fehlt eine erforderliche Berechtigung, erhalten Sie 403.
Endpunkte
| Methode & Pfad | Berechtigung | Rückgabe |
|---|---|---|
GET /v1/balance | balance | USD-Guthaben von Werbetreibenden & Publishern |
GET /v1/stats?days=7 | stats | Tageswerte (fügen Sie role=publisher für die Publisher-Ansicht hinzu) |
GET /v1/campaigns | campaigns | Ihre Kampagnen |
POST /v1/campaigns/{id}/pause | campaigns | pausiert eine Kampagne |
POST /v1/campaigns/{id}/resume | campaigns | setzt eine Kampagne fort |
GET /v1/zones | zones | Ihre Publisher-Zonen |
Beispiel
curl -H "Authorization: Bearer PUBLICKEY:SECRET" \
"https://api.adgora.net/v1/stats?days=30"S2S-Postback für Conversions
Um CPA-Conversions zu erfassen, rufen Sie bei einer Conversion die Postback-URL vom Server des Werbetreibenden auf. Das {clickid} Makro wird über die Klick-URL an Ihre Landingpage übergeben — erfassen Sie es und senden Sie es zurück:
https://api.adgora.net/s2s?clickid={clickid}&status=confirmed&secret=YOUR_OFFER_SECRET&order_ref=ORDER123status kann folgende Werte haben confirmed, delivered, rejected oder returned; order_ref ist Ihre optionale Bestell-ID. Das Angebotsgeheimnis finden Sie auf der Angebotsseite.
Makros für die Landing-URL
Fügen Sie diese zur Landing-URL eines Werbemittels hinzu — Adgora ersetzt sie beim Klick:
{clickid} {zoneid} {campaignid} {creativeid} {geo} {country} {device} {sub1}…{sub5}Eine Anfrage erstellen
Wählen Sie einen Endpunkt und Parameter – der Befehl aktualisiert sich, während Sie fortfahren. Schlüssel bleiben Platzhalter: niemals ein Geheimnis in eine Webseite einfügen.
https://api.adgora.net/v1/balancecurl -H "Authorization: Bearer PUBLICKEY:SECRET" "https://api.adgora.net/v1/balance"PUBLICKEY:SECRET ist ein Platzhalter. Erstellen Sie einen Schlüssel in Ihrem Profil und bewahren Sie das Geheimnis auf Ihrem Server auf.
