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Ограничение частоты показа Adriverbool
traffic_distributionМетоды распределения трафикастрока

Каждый элемент кроме use_adriver_frequency_cap содержит в себе элементарный объект лимитов:

  • total - всего
  • hour - на час
  • day - на день