菜单

更新流量投放状态

需要携带 Token，详情看Token

通过此接口可用于控制流量（即，mtgid）在广告单元中的跑量状态。另外，该操作受权限管控，若权限不足，接口会返"Permission denied"，请联系 AM 授权后再试操作。

请求地址

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

请求方法

PUT

请求示例

json 复制代码

PUT /api/open/v1/offer/target
HTTP/1.1 Host: ss-api.mintegral.com
Content-Type: application/json
{ 
  "offer_id": 1234, 
  "option": "ENABLE", 
  "mtgid":  "mtg1127838375" 
}

请求参数

字段	类型	说明	默认值	例子
offer_id	int	广告单元 ID	—	`1234`
option	string	广告单元下需要优化的流量的 mtgid 的新状态。可选值：`"ENABLE"` 、`"DISABLE"` 、`"ALLOW_ALL"`。 ENABLE ：表示将某个 mtgid 从黑名单剔除 DISABLE ：表示将某个 mtgid 添加进黑名单。 ALLOW_ALL：表示恢复所有 App 的投放状态，取消黑名单的设置。广告单元里需要优化的流量 mtgid。如果 mtgid 传空，则清空黑名单。多个用,号分隔，最多 3000 个。	—	`"DISABLE"`
mtgid	string	广告单元里需要优化的流量 mtgid。仅option 传 `"ALLOW_ALL"` 时，mtgid 可传空，如果 mtgid 传空，则清空黑名单。多个用,号分隔，最多 3000 个。注：该接口采取全量更新方式，请提交完整的黑名单设置。	—	`"mtg1127838375"`

响应结果

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

应答示例

json 复制代码

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

上一个

更新广告单元状态

下一个

更新 Tracking Url

最近修改: 2025-08-22

大纲