Работа с бустом продаж

Через API можно запускать буст продаж — создать и включить единую на все магазины бизнес-аккаунта кампанию, добавить в нее товары и назначить на них ставки. Управлять такой кампанией — добавлять, обновлять, удалять и получать ставки на товары — можно только через API.

Внести другие изменения в созданную через API кампанию можно в кабинете:

  • Выключить или включить кампанию.
  • Изменить ее название.
  • Выключить или включить ценовую стратегию. Подробнее о ценовой стратегии читайте в Справке Маркета для продавцов.

Кампаниями, которые вы создали в кабинете, управлять через API не получится.

Как получить рекомендованные ставки

Чтобы узнать значения рекомендованных ставок, выполните запрос POST businesses/{businessId}/bids/recommendations.

Как создать кампанию

Передайте информацию о товарах (SKU) и их ставках с помощью запроса PUT businesses/{businessId}/bids. Новая кампания создается при первом использовании запроса или при повторном, если в кабинете вы удалили ранее созданную через API кампанию.

Как получить установленные ставки

Чтобы узнать значения установленных через API ставок, выполните запрос POST businesses/{businessId}/bids/info.

В ответе возвращаются значения только тех ставок, которые вы установили через запрос PUT businesses/{businessId}/bids. Получить информацию по кампаниям, созданным в кабинете, не получится.

Как изменить данные в кампании

Обновить ставки, добавить или удалить товары из созданной через API кампании можно с помощью запроса PUT businesses/{businessId}/bids. В одном запросе вы можете выполнить несколько действий — например, добавить в кампанию новые товары и удалить старые.

Обновить ставки

Чтобы обновить ставки на товары в созданной кампании, выполните запрос PUT businesses/{businessId}/bids, где передайте новые значения ставок.

Добавить в кампанию новые товары

Чтобы добавить в кампанию новые товары, выполните запрос PUT businesses/{businessId}/bids, где передайте информацию о новых товарах (SKU) и их ставках.

Удалить товары из кампании

Чтобы остановить продвижение отдельных товаров, выполните запрос PUT businesses/{businessId}/bids, где передайте нулевую ставку в поле bid для тех товаров, которые нужно удалить из кампании.

Как получить отчет по бусту продаж

Генерация отчета занимает время, поэтому получение происходит в два этапа: вначале нужно сделать запрос на генерацию, а потом запрос на готовый отчет.

  1. Сделайте запрос POST reports/boost-consolidated/generate. В запросе задайте настройки и фильтры, а также укажите формат, в котором вы хотите получить отчет.
  2. Чтобы узнать, готов ли отчет, выполните запрос GET reports/info/{reportId}. Вы получите статус генерации отчета и примерное время, оставшееся до завершения генерации.
  3. После того как время на генерацию закончится, повторите запрос GET reports/info/{reportId}. Если сгенерировать отчет удалось, вы получите ссылку на его скачивание.