Рекомендованные ставки для заданных товаров

Info

Console

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

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

Если товар только добавлен в каталог, но пока не продается, рекомендованной ставки для него не будет.

В одном запросе может быть максимум 1500 товаров.

⚙️ Лимит: 1000 запросов в минуту

Request

POST

https://api.partner.market.yandex.ru/businesses/{businessId}/bids/recommendations

Path parameters

Name

Description

businessId*

Type: integer<int64>

Идентификатор кабинета. Чтобы узнать идентификатор, воспользуйтесь запросом GET campaigns.

ℹ️ Что такое кабинет и магазин на Маркете

Min value: 1

Body

application/json

{
    "skus": [
        "string"
    ]
}

Name

Description

skus*

Type: string[]

Список товаров, для которых нужно получить рекомендации по ставкам.
Ваш SKU — идентификатор товара в вашей системе.

Правила использования SKU:

У каждого товара SKU должен быть свой.
SKU товара нельзя менять — можно только удалить товар и добавить заново с новым SKU.
Уже заданный SKU нельзя освободить и использовать заново для другого товара. Каждый товар должен получать новый идентификатор, до того никогда не использовавшийся в вашем каталоге.

Что такое SKU и как его назначать

Min length: 1

Max length: 255

Pattern: ^(?=.*\S.*)[^\x00-\x08\x0A-\x1f\x7f]{1,255}$

Max items: 1500

Min items: 1

Unique items: true

Responses

200 OK

Рекомендованные ставки для заданных товаров.

Body

application/json

{
    "status": "OK",
    "result": {
        "recommendations": [
            {
                "sku": "string",
                "bid": 570,
                "bidRecommendations": [
                    {
                        "bid": 570,
                        "showPercent": 0,
                        "benefits": [
                            "BESTS"
                        ]
                    }
                ],
                "priceRecommendations": [
                    {
                        "campaignId": 0,
                        "price": 0
                    }
                ]
            }
        ]
    }
}

Name

Description

result

Type: GetBidsRecommendationsResponseDTO

Список товаров с рекомендованными ставками.

status

Type: ApiResponseStatusType

Тип ответа.

Enum: OK, ERROR

GetBidsRecommendationsResponseDTO

Список товаров с рекомендованными ставками.

Name

Description

recommendations*

Type: SkuBidRecommendationItemDTO[]

Список товаров с рекомендованными ставками.
Список товаров с рекомендованными ставками.

ApiResponseStatusType

Тип ответа.

Type	Description
ApiResponseStatusType	Enum: `OK`, `ERROR`

SkuBidRecommendationItemDTO

Список товаров с рекомендованными ставками.

Name	Description
bid*	Type: integer<int32> Значение рекомендованной ставки для товара из параметра `sku`, от 50 до 9999. Указывается в процентах от стоимости товара и умножается на 100. Например, ставка 5% обозначается как 500. В ответе присутствует не пустой `bidRecommendations` Не обращайте внимания на это поле. Example: `570` Min value: `0` Max value: `9999`
sku*	Type: string SKU товара, которому соответствует ставка из параметра `bid`. Min length: `1` Max length: `255` Pattern: `^(?=.\S.)[^\x00-\x08\x0A-\x1f\x7f]{1,255}$`
bidRecommendations	Type: BidRecommendationItemDTO[] Список рекомендованных ставок с соответствующими долями показов и доступными дополнительными инструментами продвижения. Чем больше ставка, тем большую долю показов она помогает получить. Рекомендованная ставка, возможная доля показов и доступные дополнительные инструменты продвижения.
priceRecommendations	Type: PriceRecommendationItemDTO[] Рекомендованные цены. Рекомендованная цена.

BidRecommendationItemDTO

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

Name	Description
bid*	Type: integer<int32> Значение рекомендованной ставки для товара из параметра `sku`, от 50 до 9999. Указывается в процентах от стоимости товара и умножается на 100. Например, ставка 5% обозначается как 500. Example: `570` Min value: `0` Max value: `9999`
showPercent*	Type: integer<int64> Доля показов. Min value: `0` Max value: `100`
benefits	Type: BenefitType[] Список доступных субсидий. Типы дополнительных инструментов продвижения: `BESTS` - участие в акции Бестселлеры. `SPLIT_0_0_4` - возможность оплаты в Сплит сроком на 4 месяца. `SPLIT_0_0_6` - возможность оплаты в Сплит сроком на 6 месяцев. `SPLIT_0_0_12` - возможность оплаты в Сплит сроком на 12 месяцев. `MARKET_SUBSIDY_1_4` - скидка от Маркета от 1 до 4%. `MARKET_SUBSIDY_5_9` - скидка от Маркета от 5 до 9%. `MARKET_SUBSIDY_10` - скидка от Маркета от 10%. Enum: `BESTS`, `SPLIT_0_0_4`, `SPLIT_0_0_6`, `SPLIT_0_0_12`, `MARKET_SUBSIDY_1_4`, `MARKET_SUBSIDY_5_9`, `MARKET_SUBSIDY_10` Min items: `1` Unique items: `true`

PriceRecommendationItemDTO

Рекомендованная цена.

Name

Description

campaignId*

Type: integer<int64>

Идентификатор кампании.

price*

Type: number<decimal>

Рекомендованная цена на товар. Чтобы продвижение хорошо работало, цена на товар должна быть не выше этого значения. Подробно о рекомендованных ценах

Min value: 1

BenefitType

Типы дополнительных инструментов продвижения:

BESTS - участие в акции Бестселлеры.
SPLIT_0_0_4 - возможность оплаты в Сплит сроком на 4 месяца.
SPLIT_0_0_6 - возможность оплаты в Сплит сроком на 6 месяцев.
SPLIT_0_0_12 - возможность оплаты в Сплит сроком на 12 месяцев.
MARKET_SUBSIDY_1_4 - скидка от Маркета от 1 до 4%.
MARKET_SUBSIDY_5_9 - скидка от Маркета от 5 до 9%.
MARKET_SUBSIDY_10 - скидка от Маркета от 10%.

Type	Description
BenefitType	Enum: `BESTS`, `SPLIT_0_0_4`, `SPLIT_0_0_6`, `SPLIT_0_0_12`, `MARKET_SUBSIDY_1_4`, `MARKET_SUBSIDY_5_9`, `MARKET_SUBSIDY_10`

400 Bad Request

Запрос содержит неправильные данные.

Body

application/json

{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name

Description

errors

Type: ApiErrorDTO[]

Список ошибок.
Общий формат ошибки.

status

Type: ApiResponseStatusType

Тип ответа.

application/json

{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name

Description

errors

Type: ApiErrorDTO[]

Список ошибок.
Общий формат ошибки.

status

Type: ApiResponseStatusType

Тип ответа.

Enum: OK, ERROR

Была ли статья полезна?

Установленные ставки

Индекс качества магазинов