TD API 2.0 - Getting campaign info
Просмотр информации о кампании
Адрес для отправки запросов:https://tdm4.adcloud.org/api/v2/?method=MethodName
В качестве get-параметра необходимо передавать название метода, что позволит динамически определить метод через URL-строку.
За предоставлением доступа к методам работы с кампаниями обратитесь к администратору.
Просмотр кампании
"method": "Campaign.getInfo" позволяет пользователю получить информацию о параметрах и настройках кампании по его хэшу. Для этого необходимо выполнить запрос, указав в качестве параметра "xxhash" - xxhash кампании, которой был получен при создании.
Пример запроса:
{
"jsonrpc": "2.0",
"method": "Campaign.getInfo",
"params": {
"xxhash": "9BKB882E1SA45"
},
"id": 1
}
Пример ответа:
{
"jsonrpc": "2.0",
"result": {
"date_start": {
"date": "2025-06-17 00:00:00.000000",
"timezone_type": 3,
"timezone": "Europe/Moscow"
},
"date_end": {
"date": "2025-06-30 00:00:00.000000",
"timezone_type": 3,
"timezone": "Europe/Moscow"
},
"date_create": {
"date": "2025-06-19 12:10:41.000000",
"timezone_type": 3,
"timezone": "Europe/Moscow"
},
"date_edit": {
"date": "2025-06-20 14:59:50.000000",
"timezone_type": 3,
"timezone": "Europe/Moscow"
},
"limits": {
"click": {
"total": 0,
"hour": 0,
"day": 0
},
"click_per_user": {
"total": 0,
"hour": 0,
"day": 0
},
"show": {
"total": 0,
"hour": 0,
"day": 0
},
"show_per_user": {
"total": 3,
"hour": 0,
"day": 0
},
"budget_raw": {
"total": 0,
"hour": 0,
"day": 0
},
"budget": {
"total": 25000,
"hour": 500,
"day": 2100
},
"budget_per_user": {
"total": 0,
"hour": 0,
"day": 0
},
"use_adriver_frequency_cap": false,
"traffic_distribution": "accelerated"
},
"tags": [
""
],
"title": "Баннеры / Июнь / 2025",
"xxhash": "9BKB882E1SA45",
"internal_id": "tdm#1234.2",
"status": "STOPPED",
"advertiser_name": "",
"optimization": {
"type": "cpm",
"value": 0,
"statistic_field": ""
}
},
"id": 1
}
Метод возвращает в секции результатов данные по запрашиваемой кампании, содержащие следующие параметры:
Поле | Описание | Тип | Пример значения |
---|---|---|---|
title | Заголовок кампании | объект | Баннеры / Июнь / 2025 |
xxhash | ID кампании | строка | 9BKB882E1SA45 |
internal_id | Внутренний ID | строка | tdm#1234.2 |
status | Статус кампании | строка | Возможные значения: "STOPPED", "LAUNCHED", "DELETED", "ARCHIVE" |
advertiser_name | Имя рекламодателя. Не используется | строка | Mediasniper |
optimization | Оптимизация кампании. Не используется | объект | "type": "cpm", "value": 0,"statistic_field": "" |
date_start | Дата старта кампании | объект | "date": "2025-06-17 00:00:00.000000", "timezone_type": 3,"timezone": "Europe/Moscow" |
date_end | Дата завершения кампании | объект | "date": "2025-06-17 00:00:00.000000", "timezone_type": 3,"timezone": "Europe/Moscow" |
date_create | Дата создания кампании | объект | "date": "2025-06-19 12:10:41.000000", "timezone_type": 3,"timezone": "Europe/Moscow" |
date_edit | Дата последнего редактирования | объект | "date": "2025-06-20 14:59:50.000000", "timezone_type": 3,"timezone": "Europe/Moscow" |
limits | Лимиты | объект | см. в примере |
tags | Теги | массив строк | ["tags#1","tags#2"] |
Limits
Лимиты кампании, содержащие следующие параметры
Поле | Описание | Тип |
---|---|---|
click | Лимит на клики | объект |
click_per_user | Лимит на клики пользователя (не работает) | объект |
show | Лимит на показы | объект |
show_per_user | Частота на показ пользователю | объект |
budget_raw | Лимит бюджета без наценок. | объект |
budget | Лимит на клиентский бюджет | объект |
budget_per_user | Лимит на бюджет пользователя (не работает) | объект |
use_adriver_frequency_cap | Ограничение частоты показа Adriver | bool |
traffic_distribution | Методы распределения трафика | строка |
Каждый элемент кроме use_adriver_frequency_cap
содержит в себе элементарный объект лимитов:
- total - всего
- hour - на час
- day - на день
Updated 9 days ago