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 |
ctr | ctr в % (кликабельность) | 0.176 |
spent | Расход в текущей валюте | 382.995 |
Updated 9 days ago