促进销售并设定出价
方法适用于所有模式.
目前不适用于卖家Market Yandex Go.
推动销售 — 创建并激活广告系列，向其添加产品并为其分配出价。
通过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 内阁ID。 要找到答案，请使用请求 GET v2/campaigns. Min value: |
Body
application/json
{
"bids": [
{
"sku": "example",
"bid": 570
}
]
}
|
Name |
Description |
||||
|
bids |
Type: object[]
一份产品清单和要对其进行推广的投标。 Min items: Max items: Example |
Responses
200 OK
一切都解决了：出价被设定或更新。 如有必要，已添加新产品并启动活动。
Body
application/json
{
"status": "OK"
}
Type: object
500 Internal Server Error
Yandex中的内部错误。 市场。 有关错误的更多信息
Body
application/json
{
"status": "OK"
}
Type: object
pathParams:
- description: "内阁ID。 要找到答案，请使用请求 [GET\_v2/campaigns](../../reference/campaigns/getCampaigns.md).\n\nℹ️ [什么是市场上的橱柜和商店？](https://yandex.ru/support/marketplace/account/introduction.html)\n"
name: businessId
in: path
required: true
schema:
type: integer
format: int64
minimum: 1
searchParams: []
headers: []
body: |-
{
"bids": [
{
"sku": "example",
"bid": 570
}
]
}
schema:
description: 描述。
type: object
required:
- bids
properties:
bids:
description: 一份产品清单和要对其进行推广的投标。
type: array
minItems: 1
maxItems: 1500
items:
description: 产品列表和对它们的投标。
type: object
required:
- sku
- bid
properties:
sku:
description: "你的 SKU —\_系统中的产品ID。\n\n使用规则 SKU:\n\n* 对于每个产品 SKU 一定有一个。\n\n* 已经设置 SKU 它不能被释放并重新用于另一个产品。 每个产品都应该收到一个以前从未在目录中使用过的新标识符。\n\nSKU 产品可以在市场上的卖方帐户中更改。 阅读有关如何做到这一点。 [在市场对卖家的帮助](https://yandex.ru/support2/marketplace/ru/assortment/operations/edit-sku).\n\n{% note warning %}\n\n值开头和结尾的空格会自动删除。 例如, `\" SKU123 \"` 和 `\"SKU123\"` 它们将被视为相同的值。\n\n{% endnote %}\n\n[什么是 SKU 以及如何分配它](https://yandex.ru/support/marketplace/assortment/add/index.html#fields)\n"
type: string
pattern: ^(?=.*\S.*)[^\x00-\x08\x0A-\x1f\x7f]{1,255}$
x-transform: trim
minLength: 1
maxLength: 255
bid:
description: 出价的价值。
type: integer
format: int32
minimum: 0
maximum: 9999
example: 570
bodyType: application/json
method: put
security:
- type: apiKey
name: 'Api-Key'
in: header
- type: oauth2
x-inline: true
flows:
implicit:
authorizationUrl: https://oauth.yandex.ru/authorize
scopes:
market:partner-api: API Яндекс.Маркета / Поиска по товарам для партнеров
path: v2/businesses/{businessId}/bids
host: https://api.partner.market.yandex.ru
No longer supported, please use an alternative and newer version.