Синхронизация данных из базы данных происходит раз в 3 минуты.
Изменение статуса происходит раз в 1 минуту. Внутри этого интервала будет сохранено последнее действие по изменению статуса.
Изменение ставки происходит раз в 30 секунд. Внутри этого интервала будет сохранено последнее действие по изменению ставки.
Создают автоматическую кампанию.
Максимум 1 запрос в 20 секунд.
| type | integer
|
| name | string Название кампании (max. 128 символов) |
| subjectId | integer ID предмета, для которого создается кампания.
|
| sum | integer Сумма пополнения |
| btype | integer
|
| on_pause | boolean
|
| nms | Array of integers Массив артикулов WB. |
| cpm | integer Ставка. |
ID созданной кампании
{- "type": 8,
- "name": "Парашюты",
- "subjectId": 270,
- "sum": 500,
- "btype": 1,
- "on_pause": true,
- "nms": [
- 9178363,
- 9178364
], - "cpm": 10
}"9008917"Создаёт кампанию Аукцион.
Максимум 5 запросов в минуту
| campaignName | string Название кампании |
| nms | Array of integers Номенклатуры для кампании. Доступные номенклатуры можно получить с помощью метода Номенклатуры для кампаний. Максимум 50 товаров ( |
ID кампании
{- "name": "Телефоны",
- "nms": [
- 146168367,
- 200425104
]
}1234567Метод позволяет удалять кампании в статусе 4 - готова к запуску.
Допускается 5 запросов в секунду.
После удаления кампания некоторое время будет находиться в -1 статусе.
Полное удаление кампании занимает от 3 до 10 минут.
| id required | integer ID кампании |
Некорректный идентификатор кампании
{- "error": "Некорректный идентификатор кампании"
}Метод позволяет переименовать кампанию.
Допускается 5 запросов в секунду.
| advertId required | integer Идентификатор кампании, у которой меняется название |
| name required | string Новое название (максимум 100 символов) |
{- "advertId": 2233344,
- "name": "newnmame"
}"Некорректный идентификатор РК"Метод позволяет получать списки кампаний, сгруппированных по типу и статусу, с информацией о дате последнего изменения кампании.
Допускается 5 запросов в секунду.
Array of objects or null Данные по кампаниям | |
| all | integer Общее количество кампаний всех статусов и типов |
{- "adverts": [
- {
- "type": 4,
- "status": 8,
- "count": 3,
- "advert_list": [
- {
- "advertId": 6485174,
- "changeTime": "2023-05-10T12:12:52.676254+03:00"
}, - {
- "advertId": 6500443,
- "changeTime": "2023-05-10T17:08:46.370656+03:00"
}, - {
- "advertId": 7936341,
- "changeTime": "2023-07-12T15:51:08.367478+03:00"
}
]
}
], - "all": 3
}Метод позволяет получать информацию о кампаниях по query параметрам, либо по списку ID кампаний.
Допускается 5 запросов в секунду.
| status | integer Enum: -1 4 7 8 9 11
|
| type | integer Enum: 4 5 6 7 8 9
|
| order | string Enum: "create" "change" "id"
|
| direction | string Enum: "desc" "asc"
Например: /adv/v1/promotion/adverts?type=6&order=change&direction=asc
|
Список ID кампаний. Максимум 50.
Получить id кампаний можно методом Списки кампаний.
| endTime | string Дата завершения кампании |
| createTime | string Время создания кампании |
| changeTime | string Время последнего изменения кампании |
| startTime | string Дата последнего запуска кампании |
| name | string Название кампании |
Array of objects Параметры кампании | |
| dailyBudget | integer Дневной бюджет, если не установлен, то 0 |
| advertId | integer Идентификатор кампании |
| status | integer
|
| type | integer
|
| paymentType | string Модель оплаты:
|
| searchPluseState | boolean Активность фиксированных фраз:
|
[- 1234567,
- 63453471
][- {
- "endTime": "2100-01-01 00:00:00+03:00",
- "createTime": "2023-05-31 16:57:42.654141+03:00",
- "changeTime": "2023-06-21 22:10:43.074183+03:00",
- "startTime": "2023-07-21 21:17:42.872376+03:00",
- "name": "Носки_Шерстяные",
- "params": [
- {
- "intervals": [
- {
- "begin": 3,
- "end": 5
}
], - "price": 400,
- "subjectId": 201,
- "subjectName": "Носки",
- "nms": [
- {
- "nm": 11111111,
- "active": true
}
], - "active": false
}
], - "dailyBudget": 0,
- "advertId": 12345,
- "status": 9,
- "type": 6,
- "paymentType": "cpm",
- "searchPluseState": false
}
]Изменение ставки у кампании.
Измененная ставка отобразится в информации о кампании в течение трех минут.
Допускается 5 запросов в секунду.
Важно! Если устанавливаемая ставка имеет размер меньше допустимого, то в ответ Вы получите статус-код 422 (Размер ставки не изменён).
Информация об изменении минимального размера ставки публикуется в разделе Новости, на портале продавцов.
Важно! Принцип заполнения параметров type, instrument, param при изменении ставки для кампании с типом 9 (Аукцион):
Для type указывается значение 9 (всегда).
Для instrument указывается значение 6 (устаревший тип кампании).
Для param всегда указывается значение поля id из структуры subject ответа метода "Информация о кампании".
| advertId required | integer Идентификатор кампании, где меняется ставка |
| type required | integer Enum: 5 6 7 8 9
|
| cpm required | integer Новое значение ставки |
| param required | integer Параметр, для которого будет внесено изменение. Является значением |
| instrument | integer тип кампании для изменения ставки в 4 - каталог (устаревший тип), 6 - поиск (устаревший тип) |
{- "advertId": 789,
- "type": 5,
- "cpm": 456,
- "param": 23,
- "instrument": 4
}"Некорректное значение параметра param"Метод позволяет запускать кампании находящиеся в статусах 4 - готова к запуску или 11 - кампания на паузе.
Допускается 5 запросов в секунду.
Для запуска кампании со статусом 11 необходимо наличие у неё пополненного бюджета.
| id required | integer Example: id=1234 Идентификатор кампании |
"Некорректный идентификатор РК"Кампании в статусе "9 - идут показы" - можно поставить на паузу, сделав GET на /adv/v0/pause?id=***.
Допускается 5 запросов в секунду.
| id required | integer Example: id=1234 Идентификатор кампании |
"Некорректный идентификатор РК"Метод позволяет завершить кампанию, находящуюся в статусе 9 или 11 или 4.
Допускается 5 запросов в секунду.
| id required | integer Example: id=1234 Идентификатор кампании |
"Некорректный идентификатор РК"Метод позволяет получать информацию о счёте, балансе и бонусах продавца.
Допускается 1 запрос в секунду.
| balance | integer Счёт, рублей |
| net | integer Баланс, рублей |
| bonus | integer Бонусы, рублей |
{- "balance": 11083,
- "net": 0,
- "bonus": 15187
}Метод позволяет получать информацию о бюджете кампании.
Допускается 4 запроса в секунду.
| id required | integer Example: id=1 Идентификатор кампании |
| cash | integer Поле не используется. Значение всегда 0. |
| netting | integer Поле не используется. Значение всегда 0. |
| total | integer Бюджет кампании, ₽ |
{- "cash": 0,
- "netting": 0,
- "total": 500
}Метод позволяет пополнять бюджет кампании.
Допускается 1 запрос в секунду.
| id required | integer Example: id=1234567 Идентификатор кампании |
| sum | integer Сумма пополнения (min. 500 ₽) |
| type | integer
|
| return | boolean Флаг возврата ответа ( |
| total | integer Размер обновлённого бюджета |
{- "sum": 500,
- "type": 1,
- "return": true
}Ответ при return=true
{- "total": 500
}Метод позволяет получать историю затрат.
Допускается 1 запрос в секунду.
| from required | string <date> Example: from=2023-07-31 Начало интервала |
| to required | string <date> Example: to=2023-08-02 Конец интервала. |
| updNum | integer Номер выставленного документа (при наличии) |
| updTime | string <time-date> Время списания |
| updSum | integer Выставленная сумма |
| advertId | integer Идентификатор кампании |
| campName | string Название кампании |
| advertType | integer Тип кампании |
| paymentType | string
|
| advertStatus | integer
|
[- {
- "updNum": 0,
- "updTime": "2023-07-31T12:12:54.060536+03:00",
- "updSum": 24,
- "advertId": 3355881,
- "campName": "лук лучок",
- "advertType": 6,
- "paymentType": "Баланс",
- "advertStatus": 9
}, - {
- "updNum": 0,
- "updTime": null,
- "updSum": 107,
- "advertId": 3366882,
- "campName": "золотая луковица",
- "advertType": 8,
- "paymentType": "Счет",
- "advertStatus": 11
}
]Метод позволяет получать историю пополнений счёта.
Допускается 1 запрос в секунду.
| from | string <date> Example: from=2023-07-31 Начало интервала |
| to | string <date> Example: to=2023-08-02 Конец интервала. |
| id | integer Идентификатор платежа |
| date | string <time-date> Дата платежа |
| sum | integer Сумма платежа |
| type | integer
|
| statusId | integer
|
| cardStatus | string
|
[- {
- "id": 1036666,
- "date": "2022-02-04T09:06:47.985843Z",
- "sum": 600,
- "type": 0,
- "statusId": 1,
- "cardStatus": ""
}, - {
- "id": 55261296,
- "date": "2023-04-13T10:07:42",
- "sum": 1500,
- "type": 3,
- "statusId": 1,
- "cardStatus": "succeeded"
}
]Изменяет активность фиксированных фраз. Только для кампаний типа Аукцион.
Максимум 1 запрос в 500 миллисекунд.
| id required | integer Example: id=1234567 Идентификатор кампании |
| fixed | boolean Новое состояние ( |
"Некорректный запрос"Устанавливает и удаляет фиксированные фразы. Только для кампаний типа Аукцион.
Отправка пустого массива удаляет все фиксированные фразы и отключает активность фиксированных фраз в кампании. Максимум 1 запрос в 500 миллисекунд.
| id required | integer Example: id=1234567 Идентификатор кампании |
| pluse | Array of strings Список фиксированных фраз (max. 100) |
{- "pluse": [
- "Фраза 1",
- "Фраза 2"
]
}[- "Фраза 1",
- "Фраза 2"
]Устанавливает и удаляет минус-фразы фразового соответствия. Только для кампаний типа Аукцион.
Максимально допустимое количество минус-фраз в кампании - 1000 шт.
Отправка пустого массива удаляет все минус-фразы фразового соответствия из кампании.
Максимум 2 запроса в секунду.
| id required | integer Example: id=1234567 Идентификатор кампании |
| phrase | Array of strings Минус-фразы (макс. 1000 шт.) |
{- "phrase": [
- "сло",
- "гу"
]
}"Некорректный запрос"Устанавливает и удаляет минус-фразы точного соответствия. Только для кампаний типа Аукцион.
Максимально допустимое количество минус-фраз в кампании - 1000 шт.
Отправка пустого массива удаляет все минус-фразы точного соответствия из кампании.
Максимум 2 запроса в секунду.
| id required | integer Example: id=1234567 Идентификатор кампании |
| strong | Array of strings Минус-фразы (макс. 1000 шт.) |
{- "strong": [
- "стоять",
- "лопата"
]
}"Некорректный запрос"Устанавливает и удаляет минус-фразы из поиска. Только для кампаний типа Аукцион.
Максимально допустимое количество минус-фраз в кампании - 1000 шт.
Отправка пустого массива удаляет все минус-фразы из поиска из кампании.
Максимум 2 запроса в секунду.
| id required | integer Example: id=1234567 Идентификатор кампании |
| excluded | Array of strings Минус-фразы (макс. 1000 шт.) |
{- "excluded": [
- "что-то синее",
- "картошечка"
]
}"Некорректный запрос"Метод позволяет получать список номенклатур, доступных для добавления в кампанию.
Допускается 1 запрос в секунду.
| id required | integer Example: id=1 Идентификатор кампании |
[- 1111111111,
- 2222222222,
- 3333333333,
- 4444444444
]Метод позволяет добавлять и удалять номенклатуры.
Допускается 1 запрос в секунду.
Важно: Добавить можно только те номенклатуры, которые вернутся в ответе метода "Список номенклатур для автоматической кампании".
Удалить единственную номенклатуру из кампании нельзя.
Проверки по параметру delete не предусмотрено.
Если пришел ответ со статус-кодом 200, а изменений не произошло, то проверьте запрос на соответствие документации.
| id required | integer Example: id=1 Идентификатор кампании |
| add | Array of integers Номенклатуры, которые необходимо добавить. |
| delete | Array of integers Номенклатуры, которые необходимо удалить. |
{- "add": [
- 11111111,
- 44444444
], - "delete": [
- 55555555
]
}{- "error": "кампания не найдена"
}Метод позволяет устанавливать или удалять минус фразы.
Допускается 1 запрос в 6 секунд.
Отправка пустого массива удаляет все минус-фразы из кампании.
| id required | integer Example: id=1234567 Идентификатор кампании |
| excluded | Array of strings Список фраз (макс. 1000 шт.) |
Установка минус-фраз
{- "excluded": [
- "первая фраза",
- "вторая фраза"
]
}"Некорректный запрос"Для получения информации по карточкам товара используйте методы контента Список номенклатур (НМ) и Список НМ, находящихся в корзине, они доступны по токену c опцией Продвижение.
Возвращает предметы, номенклатуры из которых можно добавить в кампании. Максимум 1 запрос в 12 секунд.
| id | integer ID предмета |
| name | string Предмет |
| count | integer Количество Артикулов Wildberries ( |
[- {
- "name": "3D очки",
- "id": 2560,
- "count": 1899
}
]Возвращает номенклатуры, которые можно добавить в кампании.
Максимум 5 запросов в минуту
ID предметов, для которых нужно получить номенклатуры
| title | string Название товара |
| nm | integer Артикул Wildberries ( |
| subjectId | integer ID предмета |
[- 123,
- 456,
- 765,
- 321
][- {
- "title": "Плед",
- "nm": 146168367,
- "subjectId": 765
}
]Возвращает статистику кампаний.
Максимум 1 запрос в минуту.
Данные вернутся для кампаний в статусе 7, 9 и 11.
Важно. В запросе можно передавать либо параметр dates либо параметр interval, но не оба.
Можно отправить запрос только с ID кампании. При этом вернутся данные за последние сутки, но не за весь период существования кампании.
| id | integer ID кампании |
| dates | Array of strings <date> [ items <date > ] Даты, за которые необходимо выдать информацию. |
| dates | Array of strings <date> [ items <date > ] Даты, за которые необходимо выдать информацию. |
| views | integer Количество просмотров. |
| clicks | integer Количество кликов. |
| ctr | number Показатель кликабельности. |
| cpc | number Средняя стоимость клика, ₽. |
| sum | number Затраты, ₽. |
| atbs | integer Количество добавлений товаров в корзину. |
| orders | integer Количество заказов. |
| cr | integer CR(conversion rate) — это отношение количества заказов к общему количеству посещений кампании. |
| shks | integer Количество заказанных товаров, шт. |
| sum_price | number Заказов на сумму, ₽ |
Array of objects (Days) Статистка по дням | |
Array of objects (BoosterStats) Статистика по средней позиции товара на страницах поисковой выдачи и каталога (для автоматических кампаний). | |
| advertId | integer ID кампании |
Запрос с датами
[- {
- "id": 8960367,
- "dates": [
- "2023-10-07",
- "2023-10-06"
]
}, - {
- "id": 9876543,
- "dates": [
- "2023-10-07",
- "2023-12-06"
]
}
]Ответ при запросе с полем date
[- {
- "views": 1052,
- "clicks": 2,
- "ctr": 0.19,
- "cpc": 0.09,
- "sum": 177.7,
- "atbs": 0,
- "orders": 0,
- "cr": 0,
- "shks": 0,
- "sum_price": 0,
- "dates": [
- "2023-10-07",
- "2023-10-06"
], - "days": [
- {
- "date": "2023-10-06T03:00:00+03:00",
- "views": 414,
- "clicks": 1,
- "ctr": 0.24,
- "cpc": 70,
- "sum": 70,
- "atbs": 0,
- "orders": 0,
- "cr": 0,
- "shks": 0,
- "sum_price": 0,
- "apps": [
- {
- "views": 228,
- "clicks": 0,
- "ctr": 0,
- "cpc": 0,
- "sum": 38.71,
- "atbs": 0,
- "orders": 0,
- "cr": 0,
- "shks": 0,
- "sum_price": 0,
- "nm": [
- {
- "views": 25,
- "clicks": 0,
- "ctr": 0,
- "cpc": 0,
- "sum": 4,
- "atbs": 0,
- "orders": 0,
- "cr": 0,
- "shks": 0,
- "sum_price": 0,
- "name": "Тапочки",
- "nmId": 111111111111
}
], - "appType": 1
}
]
}
], - "boosterStats": [
- {
- "date": "2023-10-07T00:00:00Z",
- "nm": 170095908,
- "avg_position": 348
}
], - "advertId": 10524818
}
]Возвращает кластеры ключевых фраз (наборы похожих), по которым показывались товары в кампании, и количество показов по ним. В ответ метода попадают только те фразы, по которым товары показывались хотя бы один раз.
Информация обновляется раз в 15 минут.
Максимум — 4 запроса секунду.
| id required | integer Example: id=1234 Идентификатор кампании |
| excluded | Array of strings Исключения (минус-фразы) для товаров из кампании. Это фразы, которые вы задали с помощью метода Установка/удаление минус-фраз или в личном кабинете, в настройках кампании |
Array of objects Кластеры ключевых фраз |
{- "excluded": [
- "Samsung",
- "Xiaomi"
], - "clusters": [
- {
- "cluster": "Телефон",
- "count": 100,
- "keywords": [
- "Телефон",
- "Мобильный телефон"
]
}
]
}Метод позволяет получать статистику поисковой кампании по ключевым фразам.
Допускается максимум 4 запроса в секунду.
Информация обновляется примерно каждые полчаса.
| id required | integer Example: id=1 Идентификатор кампании |
object Блок информации по ключевым фразам | |
Array of objects Массив информации по статистике. |
{- "words": {
- "phrase": [ ],
- "strong": [ ],
- "excluded": [ ],
- "pluse": [
- "детское постельное белье для мальчика 1.5"
], - "keywords": [
- {
- "keyword": "постельное белье 1.5",
- "count": 772
}
], - "fixed": true
}, - "stat": [
- {
- "advertId": 7703570,
- "keyword": "Всего по кампании",
- "advertName": "",
- "campaignName": "Бельё",
- "begin": "2023-07-03T15:15:38.287441+03:00",
- "end": "2023-07-03T15:15:38.287441+03:00",
- "views": 1846,
- "clicks": 73,
- "frq": 1.03,
- "ctr": 3.95,
- "cpc": 7.88,
- "duration": 769159,
- "sum": 575.6
}, - {
- "advertId": 7703570,
- "keyword": "постельное белье 1.5 детское",
- "advertName": "",
- "campaignName": "Бельё",
- "begin": "2023-07-03T15:15:38.287441+03:00",
- "end": "2023-07-03T15:15:38.287441+03:00",
- "views": 1846,
- "clicks": 73,
- "frq": 1.03,
- "ctr": 3.95,
- "cpc": 7.88,
- "duration": 769159,
- "sum": 575.6
}
]
}Возвращает статистику по ключевым фразам за каждый день, когда кампания была активна.
Можно получить данные максимум за 7 дней.
Информация обновляется раз в час.
Максимум 4 запроса секунду
| advert_id required | integer Example: advert_id=123456789 ID кампании |
| from required | string <date> Example: from=2024-08-10 Начало периода |
| to required | string <date> Example: to=2024-08-12 Конец периода |
required | Array of objects (V0KeywordsStatistics) |
{- "keywords": [
- {
- "date": "2024-08-12",
- "stats": [
- {
- "clicks": 68,
- "ctr": 3.73,
- "keyword": "светильники",
- "sum": 565.75,
- "views": 1825
}
]
}
]
}Метод позволяет получить количество медиакампаний продавца
| all | integer Общее количество медиакампаний всех статусов и типов |
object |
{- "all": 6,
- "adverts": [
- {
- "type": 2,
- "status": 7,
- "count": 2
}, - {
- "type": 2,
- "status": 8,
- "count": 4
}
]
}Метод позволяет получить список медиакампаний продавца
| status | integer Example: status=1
|
| type | integer Example: type=1
|
| limit | integer Example: limit=1 Количество кампаний в ответе |
| offset | integer Example: offset=1 Смещение относительно первой медиакампании |
| order | string Example: order=id
|
| direction | string Example: direction=desc
|
| advertId | integer Идентификатор медиакампании |
| name | string Название медиакампании |
| brand | string Название бренда |
| type | integer
|
| status | integer
|
| createTime | string <date-time> Время создания медиакампании |
| endTime | string <date-time> Время завершения медиакампании (при наличии) |
[- {
- "advertId": 123456,
- "name": "тост",
- "brand": "goosb",
- "type": 2,
- "status": 8,
- "createTime": "2023-03-25T20:35:57.116943+03:00"
}, - {
- "advertId": 54321,
- "name": "тест",
- "brand": "bobr",
- "type": 1,
- "status": 7,
- "createTime": "2023-07-24T16:48:20.935599+03:00",
- "endTime": "2023-07-25T20:35:50.104978Z"
}
]Метод позволяет получить информацию об одной медиакампании
| id required | integer Example: id=23569 Идентификатор медиакампании |
| advertId | integer Идентификатор медиакампании |
| name | string Название медиакампании |
| brand | string Название бренда |
| type | integer
|
| status | integer
|
| createTime | string <date-time> Время создания медиакампании |
object | |
Array of objects Информация о баннере.
|
{- "advertId": 23569,
- "name": "Реклама денег принеси",
- "brand": "Plank",
- "type": 2,
- "status": 11,
- "createTime": "2023-07-19T11:13:41.195138+03:00",
- "extended": {
- "reason": "Для возобновления показов пополните бюджет медиакампании",
- "expenses": 10000,
- "from": "2023-07-19T12:05:35.847348Z",
- "to": "2123-07-20T08:14:13.079176+03:00",
- "updated_at": "2023-07-21T13:25:31.129766+03:00",
- "price": 0,
- "budget": 0,
- "operation": 1,
- "contract_id": 0
}, - "items": [
- {
- "id": 68080,
- "name": "Унисон",
- "status": 7,
- "place": 2,
- "budget": 650000,
- "daily_limit": 500,
- "category_name": "Главная",
- "cpm": 351,
- "advert_type": 1,
- "created_at": "2023-11-01T15:40:46.86165+03:00",
- "updated_at": "2023-11-08T23:44:33.248229+03:00",
- "date_from": "2023-11-01T16:05:22.286002Z",
- "date_to": "2023-11-09T17:27:32.745869+03:00",
- "nms": [
- 123456,
- 11111111
], - "bottomText1": "string",
- "bottomText2": "string",
- "message": "string",
- "additionalSettings": 1,
- "receiversCount": 1,
- "subject_id": 6945,
- "subject_name": "Бельё",
- "action_name": "Распродажа! Создай себе домашний уют!",
- "show_hours": [
- {
- "From": 7,
- "To": 8
}
], - "Erid": "string"
}
]
}Метод завершает медиакампанию - переводит её в статус 7.
Допускается максимум 10 запросов в минуту.
1 - черновик3 - отклонено (с возможностью вернуть на модерацию)4 - одобрено5 - запланировано6 - на показах8 - отказался9 - приостановлена продавцом10 - пауза по дневному лимиту11 - пауза по расходу бюджета| advert_id required | integer ID медиакампании |
| reason | string Описание причины завершения |
{- "advert_id": 123456,
- "reason": "Описание причины завершения"
}"Перевод в новый статус невозможен"Метод позволяет приостанавливать медиакампании.
Переводит приостанавливаемую медиакампанию в статус 9.
Допускается максимум 10 запросов в минуту.
Важно: приостановить медиакампанию можно не больше 10 раз в сутки. Сутки отсчитываются с полуночи по Московскому времени.
4 — одобрено5 — запланировано6 — на показах10 — пауза по дневному лимиту11 — пауза по расходу бюджета| advert_id required | integer ID медиакампании |
| reason | string Описание причины приостановки |
{- "advert_id": 123456,
- "reason": "Описание причины приостановки"
}{- "title": "unauthorized",
- "detail": "token problem; token is malformed: could not base64 decode signature: illegal base64 data at input byte 84",
- "code": "07e4668e--a53a3d31f8b0-[UK-oWaVDUqNrKG]; 03bce=277; 84bd353bf-75",
- "requestId": "7b80742415072fe8b6b7f7761f1d1211",
- "origin": "s2s-api-auth-catalog",
- "status": 401,
- "statusText": "Unauthorized",
- "timestamp": "2024-09-30T06:52:38Z"
}Метод позволяет запускать приостановленные медиакампании.
После запуска кампания в течение 2-5 минут будет находиться в статусе 4, после чего статус будет изменён на актуальный, в зависимости от конфигурации медиакампании.
Допускается максимум 10 запросов в минуту.
9 - приостановлена продавцом11 - пауза по расходу бюджета| advert_id required | integer ID медиакампании |
| reason | string Описание причины запуска |
{- "advert_id": 123456,
- "reason": "Причина запуска"
}"Кампания не найдена"Метод позволяет получать статистику медиакампаний.
| id | integer ID кампании |
| dates | Array of strings <date> [ items <date > ] Даты, за которые необходимо выдать информацию. |
object Запрошенный временной диапазон. | |
Array of objects (StatsBlok1) Блок статистики |
Запрос с датами
[- {
- "id": 8960367,
- "dates": [
- "2023-10-07",
- "2023-10-06"
]
}, - {
- "id": 9876543,
- "dates": [
- "2023-10-07",
- "2023-12-06"
]
}
]Ответ при запросе с интервалами
[- {
- "interval": {
- "begin": "2023-10-21",
- "end": "2023-10-25"
}, - "stats": [
- {
- "item_id": 62237,
- "item_name": "Gloria Jeans",
- "category_name": "Детям",
- "advert_type": 1,
- "place": 2,
- "views": 11849,
- "clicks": 209,
- "cr": 0.48,
- "ctr": 1.76,
- "date_from": "2023-10-21T00:00:00+03:00",
- "date_to": "2023-10-27T23:59:59+03:00",
- "subject_name": "Одежда",
- "atbs": 4,
- "orders": 1,
- "price": 175000,
- "cpc": 837.32,
- "status": 6,
- "daily_stats": [
- {
- "date": "2023-10-21T00:00:00+03:00",
- "app_type_stats": [
- {
- "app_type": 1,
- "stats": [
- {
- "views": 2017,
- "clicks": 27,
- "atbs": 1,
- "ctr": 1.34
}
]
}
]
}
], - "expenses": 175000,
- "cr1": 1.91,
- "cr2": 25
}
]
}
]Метод позволяет изменять ставку баннера в структуре items.
Изменение возможно только для кампаний в одном из статусов: 4, 5, 6, 9, 10, 11.
Допускается максимум 10 запросов в минуту.
| advert_id required | integer ID медиакампании |
| item_id required | integer ID баннера |
| cpm required | string Новая ставка |
{- "advert_id": 80474,
- "item_id": 41573,
- "cpm": 300
}"\"Ошибка получения айтемов: {x}\", Детали ошибки"