修改广告推广意向

POST https://api.4pyun.com/gate/1.0/adverting/advertising/demand/intention

接口说明

修改推广需求下属关联的所有投放广告的曝光定向

请求参数

字段名称 字段说明 类型 必填 示例
app_id 平台分配的接入应用ID string Y op1234567723122
demand_id 平台提供的推广需求ID string Y 77896521112
intention 业务参数 Array Y 参见intention参数示例

​ intention

字段名称 字段说明 类型 必填 示例
key 定向KEY string Y 参见intention.key-value参数值说明
value 定向值 string Y 参见intention.key-value参数值说明
reverse 类型 int Y 0:选中 1:过滤

​ intention.key-value参数值说明

key key值说明 value value值说明
ip_location IP归属地 广东省:440000
广东省深圳市:440000,440300
广东省深圳市南山区:440000,440300,440305
省市区行政编码(省市区之间用 , 分隔)

请求示例

​ 广告定向投放IP归属地: 广东省深圳市南山区和广西省

{"app_id":"op1234567723122","demand_id":77896521112,"intention":[{"key":"area_code","value":"440000,440300,440305","reverse":0},{"key":"area_code","value":"450000","reverse":0}]}

​ 广告定向过滤IP归属地: 广西省

{"app_id":"op1234567723122","demand_id":77896521112,"intention":[{"key":"area_code","value":"450000","reverse":1}]}

请求返回结果参数说明

字段名称 字段说明 类型 必填 备注
code 请求状态码 string Y 1001-成功
其它-读取message
message 返回描述 string N 返回描述
hint 返回错误说明 string N 返回具体错误描述指导
seqno 服务器日志标示 string Y 服务器日志标示编码

请求返回结果示例:

​ 请求成功

{
    "code": "1001",
    "seqno": "64369191506987127961410787347922",
    "data_node": "CN-South/DEV-3",
    "time_cost": 61
}

​ 请求失败

{
    "code": "400",
    "message": "请求参数错误",
    "hint": "检查请求参数`app_id`!",
    "seqno": "84735261540785178817961040998334",
    "data_node": "CN-South/DEV-3",
    "path": "POST /gate/1.0/adverting/advertising/demand/intention"
}
© 2025 Shenzhen ChinaRoad Technology Co., Ltd. © All Rights Reserved            UPDATED 2025/03/27 21:58:13

results matching ""

    No results matching ""