Буст Маркета через API: как разделить управление ставками и кабинетом
Почему API не управляет кампаниями буста из кабинета Яндекс Маркета и как проверить передачу ставок, остановку товаров и полномочия сотрудников.
Содержание статьи
При подключении собственного биддера сначала выясните, где создана кампания буста продаж. API Яндекс Маркета управляет ставками кампании, созданной через API, но не кампаниями из кабинета. Поэтому пустой ответ интеграции ещё не доказывает отсутствие рекламы: она может читать другой контур управления.
Что создаёт первый запрос
По официальной инструкции передача SKU и ставок через PUT bids на уровне businessId создаёт единую кампанию для всех магазинов бизнес-аккаунта. Это происходит при первом использовании метода либо после удаления прежней API-кампании в кабинете. Разработчик должен учитывать такое поведение при повторном подключении: запрос не является простым редактированием произвольно выбранной кампании.
Добавление товаров, изменение и удаление ставок этой кампании выполняются через API. В кабинете остаются отдельные действия: включение и выключение кампании, изменение названия, управление ценовой стратегией. Зафиксируйте, кто отвечает за каждое действие. Иначе сотрудник может остановить кампанию в интерфейсе, пока автоматизация продолжает успешно обновлять ставки без ожидаемого продвижения.
Как подтвердить фактическое управление
Сначала получите установленные через API ставки методом bids/info. Он возвращает именно ставки, переданные через bids; данные кампаний, созданных в кабинете, туда не попадают. Сравнивайте результат с целевым набором SKU, а не с общим числом рекламируемых товаров в аккаунте.
Рекомендованные значения доступны через bids/recommendations, но рекомендация не заменяет собственное ограничение расходов. Для первоначального запуска выберите небольшой проверенный ассортимент и заранее определите допустимую ставку по экономике товара. Это редакционный подход к приёмке, а не обещание роста продаж или обязательная настройка Маркета.
Как остановить отдельный товар
Официальный способ убрать SKU из API-кампании — передать для него bid=0. Тот же метод позволяет одновременно добавить одни товары и изменить либо убрать другие. После операции повторно запросите установленные значения. Не считайте удаление позиции из локальной таблицы достаточным: отсутствие строки в вашей системе само по себе не описывает действие, выполненное на Маркете.
Сохраните журнал согласованного и отправленного набора ставок, результат запроса и итог сверки. Если управление передаётся другому подрядчику, сначала определите, какая интеграция остаётся источником обновлений. Одновременные независимые программы могут возвращать прежние значения и затруднять выяснение причин.
Завершённая приёмка показывает три вещи: выбран правильный тип кампании, фактические ставки совпали с планом, остановка выбранного SKU подтверждена чтением. Оценку рекламного результата проводите отдельно по расходам и продажам. Технически успешная синхронизация не гарантирует прибыльности продвижения.
Материал отражает сведения на указанную дату. Правила и условия работы площадок могут измениться. Редакционные принципы