Маркетинг и продвижение · promotion

Операций модуля promotion — 43.

Документация спецификации ↗ · Все модули

Узнать больше о маркетинге и продвижении можно в справочном центре

Методы маркетинга и продвижения позволяют:

1. Получать информацию о кампаниях продвижения и медиакампаниях
2. Создавать и управлять кампаниями
3. Управлять финансами кампаний
4. Выгружать статистику кампаний продвижения и медиакампаний
5. Работать с календарём акций Данные синхронизируются с базой раз в 3 минуты. Статусы кампаний меняются раз в минуту. Ставки кампаний меняются раз в 30 секунд.

Кампании

Метод	Путь	Операция
GET	/adv/v1/promotion/count	Списки кампаний
GET	/api/advert/v3/adverts	Информация о кампаниях
GET	/api/advert/v2/adverts	Информация о кампаниях

Создание кампаний

Метод	Путь	Операция
POST	/api/advert/v1/bids/min	Минимальные ставки для карточек товаров
POST	/adv/v2/seacat/save-ad	Создать кампанию
GET	/adv/v1/supplier/subjects	Предметы для кампаний
POST	/adv/v2/supplier/nms	Карточки товаров для кампаний

Управление кампаниями

Метод	Путь	Операция
GET	/adv/v0/delete	Удаление кампании
POST	/adv/v0/rename	Переименование кампании
GET	/adv/v0/start	Запуск кампании
GET	/adv/v0/pause	Пауза кампании
GET	/adv/v0/stop	Завершение кампании
PUT	/adv/v0/auction/placements	Изменение мест размещения в кампаниях с ручной ставкой
PATCH	/api/advert/v1/bids	Изменение ставок в кампаниях
PATCH	/adv/v0/auction/nms	Изменение списка карточек товаров в кампаниях
GET	/api/advert/v0/bids/recommendations	Рекомендуемые ставки для карточек товаров и поисковых кластеров
GET	/api/advert/v1/config	Конфигурационные значения продвижения
GET	/api/advert/v0/daily-limits	Получить настройки дневных лимитов кампаний
PUT	/api/advert/v0/daily-limits	Настройка дневных лимитов кампаний

Финансы

Метод	Путь	Операция
GET	/adv/v1/balance	Баланс
POST	/api/advert/v2/budget	Остатки бюджетов кампаний
GET	/adv/v1/budget	Бюджет кампании
POST	/adv/v1/budget/deposit	Пополнение бюджета кампании
GET	/adv/v1/upd	Получение истории затрат
GET	/adv/v1/payments	Получение истории пополнений счёта

Статистика

Метод	Путь	Операция
POST	/adv/v0/normquery/stats	Статистика поисковых кластеров
GET	/adv/v3/fullstats	Статистика кампаний
POST	/adv/v1/stats	Статистика медиакампаний
POST	/adv/v1/normquery/stats	Статистика по поисковым кластерам с детализацией по дням

Поисковые кластеры

Метод	Путь	Операция
POST	/adv/v0/normquery/get-bids	Список ставок поисковых кластеров
POST	/api/advert/v1/normquery/bids	Установить ставки для поисковых кластеров в валюте профиля продавца
POST	/adv/v0/normquery/bids	Установить ставки для поисковых кластеров
DELETE	/adv/v0/normquery/bids	Удалить ставки поисковых кластеров
POST	/adv/v0/normquery/get-minus	Список минус-фраз кампаний
POST	/adv/v0/normquery/set-minus	Установка и удаление минус-фраз
POST	/adv/v0/normquery/list	Списки активных и неактивных поисковых кластеров

Медиа

Метод	Путь	Операция
GET	/adv/v1/count	Количество медиакампаний
GET	/adv/v1/adverts	Список медиакампаний
GET	/adv/v1/advert	Информация о медиакампании

Календарь акций

Метод	Путь	Операция
GET	/api/v1/calendar/promotions	Список акций
GET	/api/v1/calendar/promotions/details	Детальная информация об акциях
GET	/api/v1/calendar/promotions/nomenclatures	Список товаров для участия в акции
POST	/api/v1/calendar/promotions/upload	Добавить товар в акцию