更新出价

需要携带 Token，详情看 Token

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

请求地址

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

请求方法

PUT

请求示例

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	如果失败，返回具体的错误信息

应答示例

{
  "msg": "success",
  "code": 200,
  "data": {
    "id": 123
  }
}