更新出价
需要携带 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
}
}