Skip to content

更新优化目标

需要携带 Token,详情看 Token

请求地址

https://ss-api.mintegral.com/api/open/v3/offer/target_goal

请求方法

PUT

请求示例

json
PUT /api/open/v3/offer/target_goal
HTTP/1.1 Host: ss-api.mintegral.com
Content-Type: application/json
{
  "offer_id": 123,
  "target_goal": 80,
  "target_goal_by_geo": [
    {
      "geo": "CN",
      "target_goal": 81
    }
  ],
  "cold_start_price": 1.2,
  "cold_start_price_by_geo": [
    {
      "geo": "CN",
      "cold_start_price": 1.2
    }
  ]
}

请求参数

字段必填类型说明默认值例子
offer_idintOffer ID123
target_goal选填
bid_goal为Target-ROAS时必填
doubleoffer维度优化目标值,不同bid_goal取值范围如下:
Target-ROAS:该值取值范围为[1, 1000],保留两位小数,单位为百分比 ≈
45
target_goal_by_geo选填
bid_goal为Target-ROAS时必填
array<json>geo维度优化目标值。如果为空数组,则删除所有分geo优化目标[{"geo":"CN","target_goal": 81}]
geostringgeo
target_goaldouble优化目标值
cold_start_price选填
bid_goal为Target-ROAS时必传
doubleoffer维度冷启动价格,仅Target-ROAS可填,取值范围:[0.01, 200],三位小数
cold_start_price_by_geo选填
bid_goal为Target-ROAS时必传
array<json>geo维度冷启动价格。如果为空数组,则删除所有分geo冷启动价格[{"geo":"CN","cold_start_price": 1.2}]
geostring地区需要与target_goal_by_geo中的地区保持一致
cold_start_pricedouble冷启动价格

响应结果

字段类型说明
codeint200 表示成功,其他表示失败
msgstring成功返回"success",失败返回相应的错误信息
dataobject成功l返回数据,失败返回null

应答示例

json
{
  "code": 200,
  "msg": "success",
  "data": null
}