促进销售并设定出价

Info

Console

方法适用于所有模式.

目前不适用于卖家Market Yandex Go.

如果您使用API-Key令牌，调用该方法时需要具备列表中可用权限之一

pricing — 价格管理
promotion — 商品推广
all-methods — 全面管理账户

推动销售 — 创建并激活广告系列，向其添加产品并为其分配出价。

通过API创建的活动在仪表板中是什么样子的?

首次使用查询时，市场：为所有商业帐户商店创建一个单一的活动，向其中添加具有指定费率的产品，包括它们的定价策略，并启动促销。重复使用查询将允许您更新此广告活动中产品的出价或添加新的出价。阅读更多有关定价策略的资料燕基科斯.对卖家的市场帮助.

如果产品与指定 SKU 不，它将被忽略。如果将来目录中有产品与此 SKU 它将自动添加到活动与指定的出价.

该请求始终适用于通过API创建的相同广告系列。如果您在您的帐户中删除它，市场将创建一个新的下一次您提出请求。您将无法通过API管理其他活动。通过API创建的广告系列始终具有高于其他广告系列的最高优先级。 — 它不能改变。

查询执行包括广告系列和定价策略（如果已禁用）。

您可以对通过仪表板中的API创建的活动进行其他更改:

禁用或启用营销活动。
更改其名称。
禁用或启用定价策略。

要停止单个产品的推广并将其从广告系列中移除，请在参数中为其传递零出价 bid.

阅读更多关于销售促进如何在燕基科斯.对卖家的市场帮助.

您可以通过提出请求来了解销售提升的成本 POST v2/campaigns/{campaignId}/stats/orders. 量包含在字段中 bidFee.

数据不会立即更新

最多需要几分钟。

⚙️ 限制: 每分钟1,000个请求

Request

PUT

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

Path parameters

Name

Description

businessId*

Type: integer<int64>

内阁ID。要找到答案，请使用请求 GET v2/campaigns.

ℹ️ 什么是市场上的橱柜和商店？

Min value: 1

Body

application/json

{
    "bids": [
        {
            "sku": "string",
            "bid": 570
        }
    ]
}

Name

Description

bids*

Type: SkuBidItemDTO[]

一份产品清单和要对其进行推广的投标。
产品列表和对它们的投标。

Min items: 1

Max items: 1500

SkuBidItemDTO

产品列表和对它们的投标。

Name

Description

bid*

Type: integer<int32>

Значение ставки для товара из параметра sku, от 50 до 9999.

Указывается в процентах от стоимости товара и умножается на 100. Например, ставка 5% обозначается как 500.

Example: 570

Min value: 0

Max value: 9999

sku*

Type: string

你的 SKU — 系统中的产品ID。

使用规则 SKU:

对于每个产品 SKU 一定有一个。
已经设置 SKU 它不能被释放并重新用于另一个产品。每个产品都应该收到一个以前从未在目录中使用过的新标识符。

SKU 产品可以在市场上的卖方帐户中更改。阅读有关如何做到这一点。在市场对卖家的帮助.

什么是 SKU 以及如何分配它

Min length: 1

Max length: 255

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

Responses

200 OK

一切都解决了：出价被设定或更新。如有必要，已添加新产品并启动活动。

Body

application/json

{
    "status": "OK"
}

Name

Description

status*

Type: ApiResponseStatusType

响应的类型。可能的值:

OK — 没有错误。
ERROR — 处理请求时出错。

Enum: OK, ERROR

ApiResponseStatusType

响应的类型。可能的值:

OK — 没有错误。
ERROR — 处理请求时出错。

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

400 Bad Request

请求包含不正确的数据。有关错误的更多信息

Body

application/json

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

Name

Description

errors

Type: ApiErrorDTO[]

错误列表。
一般错误格式。

Min items: 1

status

Type: ApiResponseStatusType

响应的类型。可能的值:

OK — 没有错误。
ERROR — 处理请求时出错。

Enum: OK, ERROR

ApiErrorDTO

一般错误格式。

Name

Description

code*

Type: string

的错误代码。

message

Type: string

错误的描述。

401 Unauthorized

请求中未指定授权数据。有关错误的更多信息

Body

application/json

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

Name

Description

errors

Type: ApiErrorDTO[]

错误列表。
一般错误格式。

Min items: 1

status

Type: ApiResponseStatusType

响应的类型。可能的值:

OK — 没有错误。
ERROR — 处理请求时出错。

Enum: OK, ERROR

403 Forbidden

授权数据不正确或禁止访问资源。有关错误的更多信息

Body

application/json

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

Name

Description

errors

Type: ApiErrorDTO[]

错误列表。
一般错误格式。

Min items: 1

status

Type: ApiResponseStatusType

响应的类型。可能的值:

OK — 没有错误。
ERROR — 处理请求时出错。

Enum: OK, ERROR

404 Not Found

找不到请求的资源。有关错误的更多信息

Body

application/json

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

Name

Description

errors

Type: ApiErrorDTO[]

错误列表。
一般错误格式。

Min items: 1

status

Type: ApiResponseStatusType

响应的类型。可能的值:

OK — 没有错误。
ERROR — 处理请求时出错。

Enum: OK, ERROR

420 Method Failure

已超出资源访问限制。有关错误的更多信息

Body

application/json

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

Name

Description

errors

Type: ApiErrorDTO[]

错误列表。
一般错误格式。

Min items: 1

status

Type: ApiResponseStatusType

响应的类型。可能的值:

OK — 没有错误。
ERROR — 处理请求时出错。

Enum: OK, ERROR

500 Internal Server Error

市场的内部错误。有关错误的更多信息

Body

application/json

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

Name

Description

errors

Type: ApiErrorDTO[]

错误列表。
一般错误格式。

Min items: 1

status

Type: ApiResponseStatusType

响应的类型。可能的值:

OK — 没有错误。
ERROR — 处理请求时出错。

Enum: OK, ERROR

这篇文章是否有用？

删除注释

设定税率