TD API 2.0 - Getting campaign statistics

Для получения статистики в ТД существует несколько методов API.

📘

Адрес для отправки запросов:

https://tdm4.adcloud.org/api/v2/?method=MethodName

В качестве get-параметра необходимо передавать название метода, что позволит динамически определить метод через URL-строку.

Получение статистики РК

"method": "Statistic.getPeriod" позволяет пользователю получить статистику РК. Для этого необходимо выполнить запрос, указав в качестве параметров список hash-кампаний, а также период времени, за который необходимы статистические данные. Обратите внимание, параметры необязательные.
Если не указывать период, то в ответе вернется суммарная статистика за всё время существования РК. Если не указывать список hash-кампаний, то в ответе вернется статистика по всем доступным кампаниям.

Параметры:

ПараметрТипОбязательныйОписание
xxhash_listМассив строкНетСписок hash-кампаний
periodОбъектНетОбъект даты { "from": "2025-07-13","to": "2025-07-13" }

Пример запроса:

{
  "jsonrpc": "2.0",
  "method": "Statistic.getPeriod",
  "params": {
    "xxhash_list": [
      "1A57C463E5D1AAA7"
    ],
    "period": {
      "from": "2023-06-21",
      "to": "2023-07-05"
    }
  },
  "id": 1
}

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

{
  "jsonrpc": "2.0",
  "result": {
    "1A57C463E5D1AAA7": {
      "show": 382995,
      "click": 674,
      "cpc": 0.568,
      "cpm": 1,
      "ctr": 0.176,
      "spent": 382.995
    },
    "total": {
      "show": 382995,
      "click": 674,
      "cpc": 0.568,
      "cpm": 1,
      "ctr": 0.176,
      "spent": 382.995
    }
  },
  "id": 1
}

Метод возвращает в секции результатов для каждой РК суммарную статистику за указанный в запросе период времени. В статистику входят следующие данные

ПолеОписаниеПример значения
showКоличество показов382995
clickКоличество кликов674
cpcРассчитанный cpc (стоимость одного клика)0.568
cpmРассчитанный cpm (стоимость 1000 показов)1
ctrctr в % (кликабельность)0.176
spentРасход в текущей валюте382.995