Artykuły pomocyDokumentacja API
Zacznij tutaj
RozpoczęcieFAQPlany i ceny
Cenniki i planyReklamodawcy
Prowadzenie kampaniiWydawcy
Dodaj stronę i tag reklamowyPieniądze
Depozyty i wypłatyKonto
Bezpieczeństwo kontaDeweloperzy
Dokumentacja APIPrawo
Warunki korzystania z usługiPolityka prywatnościAPI REST Adgora umożliwia programowe odczytywanie statystyk, wyświetlanie i wstrzymywanie kampanii, sprawdzanie sald oraz wyświetlanie stref. Bazowy URL: https://api.adgora.net. Wszystkie odpowiedzi są w formacie JSON.
Uwierzytelnianie
Utwórz parę kluczy w swoim profilu (klucz tajny jest wyświetlany tylko raz). Wysyłaj ją z każdym /v1 żądaniem:
Authorization: Bearer {public_key}:{secret}Limit żądań wynosi 120 na minutę na konto; po przekroczeniu limitu zwracany jest kod 429 z nagłówkiem Retry-After w odpowiedzi. Klucze mają zakresy uprawnień (stats, campaigns, balance, zones); brak wymaganego zakresu powoduje zwrócenie kodu 403.
Punkty końcowe
| Metoda & ścieżka | Zakres | Odpowiedź |
|---|---|---|
GET /v1/balance | balance | salda w USD reklamodawców & wydawców |
GET /v1/stats?days=7 | stats | dane dzienne (dodaj role=publisher aby wyświetlić widok wydawcy) |
GET /v1/campaigns | campaigns | Twoje kampanie |
POST /v1/campaigns/{id}/pause | campaigns | wstrzymuje kampanię |
POST /v1/campaigns/{id}/resume | campaigns | wznawia kampanię |
GET /v1/zones | zones | Twoje strefy wydawcy |
Przykład
curl -H "Authorization: Bearer PUBLICKEY:SECRET" \
"https://api.adgora.net/v1/stats?days=30"Postback S2S konwersji
Aby śledzić konwersje CPA, wywołaj URL postbacku z serwera reklamodawcy, gdy nastąpi konwersja. Następujące {clickid} makro jest przekazywane na stronę docelową w URL kliknięcia — zapisz je i odeślij:
https://api.adgora.net/s2s?clickid={clickid}&status=confirmed&secret=YOUR_OFFER_SECRET&order_ref=ORDER123status może mieć wartość confirmed, delivered, rejected lub returned; order_ref to opcjonalny identyfikator Twojego zamówienia. Klucz tajny oferty znajdziesz na stronie oferty.
Makra URL strony docelowej
Dodaj te makra do URL strony docelowej kreacji — Adgora zastępuje je w momencie kliknięcia:
{clickid} {zoneid} {campaignid} {creativeid} {geo} {country} {device} {sub1}…{sub5}Zbuduj zapytanie
Wybierz punkt końcowy i parametry — polecenie aktualizuje się na bieżąco. Klucze pozostają jako miejsca: nigdy nie wklejaj sekretu na stronę internetową.
https://api.adgora.net/v1/balancecurl -H "Authorization: Bearer PUBLICKEY:SECRET" "https://api.adgora.net/v1/balance"PUBLICKEY:SECRET to miejsce na klucz. Utwórz klucz w swoim profilu i przechowuj sekret na swoim serwerze.
