Skip to content

更新出价

需要携带 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_idint广告单元 ID123
bid_rate 选填float所有地区的兜底价格,针对没有单独出价的地区或者流量,则默认按照此数值出价5.22
bid_rate_by_location 选填array<json>分地区设置价格。注:请提交所有需要出价的地区,不在请求里的地区将置为默认出价注:需要清空时传
bid_rate_by_location = []
country_codestring当前出价的应用地区,该地区必须为广告单元定向地区的子集"CN,US"
bid_ratefloat该地区的价格3.21
bid_rate_by_mtgid 选填array针对特定地区里的特定流量的出价。注:1. 分渠道出价为高级功能,受权限管控,若权限不足,接口会返回"Permission denied",请联系 AM 授权后再试操作;2. 请提交所有需要出价的流量,不在请求里的流量将置为默认出价注:需要清空时传 bid_rate_by_mtgid = []
country_codefloat当前出价的应用地区,该地区必须为广告单元定向地区的子集"CN"
bid_ratefloat该地区的价格3.21
mtgidfloat特定地区里的特定流量"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、该接口采取全量更新方式,在提交分地区或者渠道出价时,请提交所有的设置。

响应结果

字段类型说明
codeint200 表示成功,其他表示失败
msgstring成功,返回"success",失败返回相应的错误信息
datajson如果失败,返回具体的错误信息

应答示例

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