Статьи помощиСправочник API
Начало
С чего начатьЧастые вопросыТарифы
ТарифыРекламодателям
Запуск кампанийПаблишерам
Сайт и рекламный тегДеньги
Депозиты и выплатыАккаунт
Безопасность аккаунтаРазработчикам
Справочник APIПравовое
Условия использованияПолитика конфиденциальностиСправочник API
REST API v1: аутентификация, статистика, кампании, баланс и зоны, а также S2S-постбеки конверсий и макросы.
REST API Adgora позволяет программно читать статистику, получать и ставить на паузу кампании, проверять балансы и получать список зон. Базовый URL: https://api.adgora.net. Все ответы — в формате JSON.
Аутентификация
Создайте пару ключей в профиле (секрет показывается один раз). Передавайте её в каждом запросе /v1:
Authorization: Bearer {public_key}:{secret}Лимит запросов — 120 в минуту на аккаунт; при превышении возвращается 429 с заголовком Retry-After. У ключей есть скоупы (stats, campaigns, balance, zones); при отсутствии нужного — 403.
Эндпоинты
| Метод и путь | Скоуп | Возвращает |
|---|---|---|
GET /v1/balance | balance | балансы рекламодателя и паблишера в USD |
GET /v1/stats?days=7 | stats | строки по дням (добавьте role=publisher для вида паблишера) |
GET /v1/campaigns | campaigns | ваши кампании |
POST /v1/campaigns/{id}/pause | campaigns | ставит кампанию на паузу |
POST /v1/campaigns/{id}/resume | campaigns | возобновляет кампанию |
GET /v1/zones | zones | ваши зоны паблишера |
Пример
curl -H "Authorization: Bearer PUBLICKEY:SECRET" \
"https://api.adgora.net/v1/stats?days=30"S2S-постбек конверсий
Чтобы трекать CPA-конверсии, вызывайте URL постбека с сервера рекламодателя в момент конверсии. Макрос {clickid} передаётся на ваш лендинг в URL клика — сохраните его и отправьте обратно:
https://api.adgora.net/s2s?clickid={clickid}&status=confirmed&secret=YOUR_OFFER_SECRET&order_ref=ORDER123status: confirmed, delivered, rejected или returned; order_ref — ваш необязательный ID заказа. Секрет оффера — на странице оффера.
Макросы URL лендинга
Добавьте их в URL лендинга креатива — Adgora подставит значения при клике:
{clickid} {zoneid} {campaignid} {creativeid} {geo} {country} {device} {sub1}…{sub5}Соберите запрос
Выберите эндпоинт и параметры — команда обновляется сразу. Ключи остаются заглушками: не вставляйте секрет на веб-страницы.
curl -H "Authorization: Bearer PUBLICKEY:SECRET" "https://api.adgora.net/v1/balance"