Skip to content

API статистики ​

Каждый запрос должен быть авторизован через Header:

http
Authorization: Bearer {apiToken}

{apiToken} — API-ключ, который вы создаёте в кабинете паблишера: Аккаунт → API keys, со скоупом widgets:read. Он показывается только один раз. Подробнее: API-ключи.

Статистика плейсмента ​

http
GET https://api.adexium.io/api/v1/widget/stats/{widgetId}?startDate=YYYY-MM-DD&endDate=YYYY-MM-DD&viewBy=country
ПараметрОбязательныйОписание
{widgetId}даЧисловой ID плейсмента, виден на странице плейсментов
startDateдаПервый день, YYYY-MM-DD, включительно
endDateдаПоследний день, YYYY-MM-DD, включительно
viewByдаРазбивка строк — см. таблицу ниже
widgetIds[]нетНесколько ваших плейсментов в одном запросе, например widgetIds[]=64352&widgetIds[]=64353. Если задан, фильтрует вместо {widgetId}

Дни — календарные, по UTC.

Значения viewBy ​

ЗначениеОдна строка на
countryСтрану (ISO 3166-1 alpha-2)
languageЯзык пользователя
dateДень
hourЧас
platformПлатформу
deviceTypeТип устройства
premiumTelegram Premium: Yes / No
tonConnectedПодключён TON-кошелёк: Yes / No
sourceИсточник трафика
placementПодисточник (плейсмент)
widgetПлейсмент — в строке есть также widgetId и widgetName

Значение, которое не удалось определить, приходит как N/A.

Валидный пример запроса:

http
GET https://api.adexium.io/api/v1/widget/stats/64352?startDate=2025-03-01&endDate=2025-03-01&viewBy=country

Пример ответа:

json
[
  {
    "id": "US",
    "value": "US",
    "clicks": 0,
    "revenue": 0.0319,
    "impressions": 13,
    "ctr": 0,
    "cpm": 2.5,
    "requests": 40
  },
  {
    "id": "PL",
    "value": "PL",
    "clicks": 3,
    "revenue": 0.0088,
    "impressions": 4,
    "ctr": 75,
    "cpm": 2.2,
    "requests": 9
  }
]
ПолеЗначение
id, valueЗначение разбивки viewBy (например, код страны)
requestsЗапросы рекламы с вашего плейсмента
impressionsПоказы
clicksКлики
ctrКлики на показ, %
revenueВаш доход, USD
cpmВаш доход за 1000 показов, USD
widgetId, widgetNameТолько при viewBy=widget

У плейсмента Direct Link каждый переход считается и показом, и кликом.