请输入
菜单

更新出价

需要携带 Token，详情看Token

该接口用于更新广告单元出价，支持分地区、分渠道出价。

请求地址

https://ss-api.mintegral.com/api/open/v1/offer/bid_rate

请求方法

PUT

请求示例

json 复制代码 
PUT /api/open/v1/offer/bid_rate
HTTP/1.1 Host: ss-api.mintegral.com
Content-Type: application/json
// 正常出价（不分地区，不分mtgid）
{
  "offer_id": 123, 
  "bid_rate":3.2
}
// 分地区出价：
{
  "offer_id": 123, 
  "bid_rate":3.2, 
  "bid_rate_by_location": [
    {"country_code":"CN,AE","bid_rate":0.5},
    {"country_code":"CN","bid_rate":0.6}
  ]
}
// 分mtgid出价：
{
  "offer_id": 123, 
  "bid_rate":3.2, 
  "bid_rate_by_mtgid": [
    {"country_code":"CN,AE","bid_rate":0.5,"mtgid":"mtg123456"},
    {"country_code":"CN","bid_rate":0.6,"mtgid":"mtg654321"}
  ]
}

请求参数

字段 类型 说明 默认值 例子
offer_id int 广告单元 ID — 123
bid_rate 选填 float 所有地区的兜底价格，针对没有单独出价的地区或者流量，则默认按照此数值出价 — 5.22
bid_rate_by_location 选填 array<json> 分地区设置价格。注：请提交所有需要出价的地区，不在请求里的地区将置为默认出价 — 注：需要清空时传
bid_rate_by_location = []
country_code string 当前出价的应用地区，该地区必须为广告单元定向地区的子集 — "CN,US"
bid_rate float 该地区的价格 — 3.21
bid_rate_by_mtgid 选填 array 针对特定地区里的特定流量的出价。注：1. 分渠道出价为高级功能，受权限管控，若权限不足，接口会返回"Permission denied"，请联系 AM 授权后再试操作；2. 请提交所有需要出价的流量，不在请求里的流量将置为默认出价 — 注：需要清空时传 bid_rate_by_mtgid = []
country_code float 当前出价的应用地区，该地区必须为广告单元定向地区的子集 — "CN"
bid_rate float 该地区的价格 — 3.21
mtgid float 特定地区里的特定流量 — "mtg123456"

注：

1、bid_rate 精度为 3 位小数，即 0.001。

2、Bid rate 最小值和出价类型 bid_type 关联。当 bid_type 为 CPI/CPE/CPM 时，bid_rate 最小值为 0.01，当 bid_type 为 CPC 时，bid_rate 最小值为 0.001。

3、如果要修改广告单元的默认投放价格，修改 bid_rate 即可

4、如果要修改分地区价格，修改 bid_rate_by_location 即可

5、如果要删除分地区价格，则需要额外设置 bid_rate_by_location = []。

6、如果要删除分地区分渠道价格，则需要额外设置 bid_rate_by_mtgid = []。

7、该接口采取全量更新方式，在提交分地区或者渠道出价时，请提交所有的设置。

响应结果

字段 类型 说明
code int 200 表示成功，其他表示失败
msg string 成功，返回"success"，失败返回相应的错误信息
data json 如果失败，返回具体的错误信息

应答示例

json 复制代码 
{
  "msg": "success",
  "code": 200,
  "data": {
    "id": 123
  }
}
上一个
更新广告单元
下一个
更新预算
最近修改: 2025-06-20