API интеграция

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

Authorization: Bearer {apiToken}

{apiToken} можно получить на странице аккаунта

Статистика по странам/источникам

API Endpoint

https://api.tg-ads.co/api/v1/campaign/stats/{campaignId}/?startDate=YYYY-MM-DD&endDate=YYYY-MM-DD&viewBy={viewBy}

Доступные параметры: {campaignId} - ID кампании, можно найти на странице Campaign Page.
{viewBy} - показать статистика по итсочнику или стране - source/country startDate - формат YYYY-MM-DD - пример - 2025-03-01
endDate - формат YYYY-MM-DD - пример - 2025-03-01

Пример запроса статистики по странам: https://api.tg-ads.co/api/v1/campaign/stats/64352/?startDate=2025-03-01&endDate=2025-03-01&viewBy=country

Response example:

[
  {
    "id": "BD",
    "value": "BD",
    "clicks": 18122,
    "spend": 283.23,
    "impressions": 117704,
    "conversions": 0,
    "cvr": 0,
    "ctr": 15.4,
    "cpc": 0.02,
    "cpm": 2.41,
    "cpa": 0
  },
  {
    "id": "NG",
    "value": "NG",
    "clicks": 8396,
    "spend": 157.08,
    "impressions": 66336,
    "conversions": 0,
    "cvr": 0,
    "ctr": 12.66,
    "cpc": 0.02,
    "cpm": 2.37,
    "cpa": 0
  }
]

Пример запроса статистики по источникам: https://api.tg-ads.co/api/v1/campaign/stats/64352/?startDate=2025-03-01&endDate=2025-03-01&viewBy=source

Response example:

[
  {
    "id": "QQ789X",
    "value": "QQ789X",
    "clicks": 3696,
    "spend": 86.42,
    "impressions": 36108,
    "conversions": 0,
    "cvr": 0,
    "ctr": 10.24,
    "cpc": 0.02,
    "cpm": 2.39,
    "cpa": 0
  },
  {
    "id": "QQ7L3Y",
    "value": "QQ7L3Y",
    "clicks": 2222,
    "spend": 34.98,
    "impressions": 14229,
    "conversions": 0,
    "cvr": 0,
    "ctr": 15.62,
    "cpc": 0.02,
    "cpm": 2.46,
    "cpa": 0
  }
]