Управление ставками

Ресурсы управления ставками предоставляют возможность устанавливать и удалять ставки на предложения на Яндекс.Маркете.

Позиция, на которой окажется ваше предложение, зависит от ставки. Предложения с большей ставкой показываются выше.

Ставки действуют на следующих местах размещения предложений:

Запрос

Краткое описание

Ограничения

POST /campaigns/{campaignId}/auction/bids

Возвращает информацию об установленных ставках на предложения магазина.

Индивидуальное количество запросов в сутки, 500 рекомендаций за запрос.

PUT /campaigns/{campaignId}/auction/bids

Устанавливает или удаляет ставки на предложения.

Индивидуальное количество запросов в сутки, 500 ставок на запрос.

POST /campaigns/{campaignId}/auction/recommendations/bids:

Возвращает рекомендованные значения ставок на предложения для размещения этих предложений на соответствующих местах.

Индивидуальное количество запросов в сутки, 500 рекомендаций за запрос.

POST /campaigns/{campaignId}/bids/recommended/top/market-search

Возвращает список популярных запросов в поиске Яндекс.Маркета, рекомендованных для предложения, и значения ставок. Рекомендации возвращаются для размещения среди первых 12 предложений магазинов в поиске Яндекс.Маркета.

Индивидуальное количество запросов в сутки, 500 рекомендаций за запрос.

PUT /campaigns/{campaignId}/auction/recommendations/bids

Устанавливает рекомендованные значения ставок на товарные предложения.

Индивидуальное количество запросов в сутки, 500 ставок на запрос.

GET /campaigns/{campaignId}/bids/settings

Возвращает информацию о настройках установленных ставок для магазина.

Индивидуальное количество запросов в сутки.

Для запросов PUT /campaigns/{campaignId}/auction/bids, POST /campaigns/{campaignId}/auction/recommendations/bids, POST /campaigns/{campaignId}/bids/recommended/top/market-search и PUT /campaigns/{campaignId}/auction/recommendations/bids действует групповое ресурсное ограничение.

Настройки в личном кабинете

Чтобы назначать ставки с помощью партнерского API, необходимо в личном кабинете в качестве источника информации о ставках выбрать вариант «Личный кабинет и API». Для этого в личном кабинете перейдите на страницу Ставки → Управление ставками и нажмите на ссылку Настройки. Откроется форма выбора источника информации о ставках.

Вы можете также выбрать способ идентификации предложения:

  • по названию — работа со ставками происходит по названию предложения, указанного в прайс-листе. Если у двух или более товаров указано одинаковое название, ставка будет устанавливаться одновременно для всех этих товаров.

  • по ID — работа со ставками происходит по идентификатору предложения. Все идентификаторы предложений в рамках одного прайс-листа должны быть уникальными.

    Внимание. При выборе типа идентификации по ID возможность управлять ставками через личный кабинет отсутствует, также недоступны рекомендации по ставкам.

Частота обновления ставок на Яндекс.Маркете

  • Если выбрана идентификация товаров по названию, то ставки применяются во время общего обновления данных на Яндекс.Маркете. Обновление происходит примерно раз в 3–6 часов.

  • Если выбрана идентификация товаров по ID, то ставки обновляются в течение 30 минут.

Устаревшие запросы

Следующие запросы для управления ставками не рекомендуются к использованию начиная с версии 2.44 партнерского API и прекратят работу с 30 октября 2018 года: