• 接口说明

    • 通过该接口更新修改广告计划。

  • 请求接口

    • /ati/openApi/updateAdvertPlan

  • 请求参数

参数名 类型 是否必填 说明
appid String 是 平台应用appid
sign String 是 签名字符串
data obj 是 请求参数json字符串 具体的修改字段说明可以查看新增计划
-timestamp Long 是 当前时间戳
-advertPlanNo Long 是 广告计划编号
-advertPlanName Long 是 广告计划名称

  • 请求示例

{
    "appId": "ymcb75a59c65eb4521",
    "sign": "dd4b4367e8d13d4244f46b1deed4a79b",
    "data": {
        "advertPlanNo":"PLAN1749628407191925",
        "timestamp": "1749613664",
        "advertPlanName": "测试广告计划",
        "advertWeight": "100",
        "advertBusinessNo": "BUSI1749455172054478",
        "restrictNum": "100",
        "exposureNum": "50",
        "cycleType": "00",
        "advertProduct": "测试",
        "remark": "测试",
        "skipType": "10",
        "isSkip": "00",
        "isRestrict": "10",
        "dropAddrList": ["11", "110100"],
        "positionNo": "POSI1749461056822834",
        "operatorType": ["10", "20"],
        "deviceType": ["2"],
        "planStartTime": "2025-06-11 00:00:00",
        "planEndTime": "2025-07-15 00:59:59"
    }
}

  • 响应参数

参数名 类型 说明
code String 响应码 0：成功；其他失败
msg String 消息描述
data obj 响应体信息
-advertBusinessNo String 计划广告主
-createdBy String 创建人
-createdTime String 创建时间
-updatedBy String 更新人
-updatedTime String 更新时间
-advertPlanId String 计划id
-advertPlanNo String 计划编号
-advertPlanName String 计划名称
-launchType String ——————
-dropAddrList List 地区省份黑名单,详情见 （地区-基础数据）
-areaBlackList String ——————
-deviceType String 设备类型1:安卓,2:ios
-operatorType List 运营商 所属运营商10移动,20联通,30电信,40广电,50其他
-cycleType String 循环投放:类型00每天
-positionNo String 广告位编号
-positionName String 广告位名称
-content String 广告位文本
-fileInfo obj 广告位文件资源
-advertTypeNo String 广告类型编号
-isSkip String 是否跳转 00否，10是
-advertWeight String 广告位权重(多个计划同时使用一个广告位时，权重为占比)
-skipWxAppId String 跳转小程序appid
-skipType String 跳转类型 10:H5和20:小程序
-skipAddr String 跳转地址
-planStartTime String 计划开始时间
-planEndTime String 计划结束时间
-remark String 备注
-status String 是否发布00未发布，10已发布
-projectNo String 所属应用编号
-projectName String 所属应用名称
-isRestrict String 是否限量00不限量，10限量
-restrictNum String 访问量数量
-exposureNum String 曝光量数量
-extData String 附加参数
-advertProduct String 广告品类

  • 响应示例

{
    "msg": "操作成功",
    "code": 0,
    "data": {
        "advertBusinessNo": "BUSI1749455066498586",
        "createdBy": "zwt002",
        "createdTime": "2025-06-09 17:37:13",
        "updatedBy": "zwt123",
        "updatedTime": "2025-06-10 19:20:00",
        "advertPlanId": 71,
        "advertPlanNo": "PLAN1749461833541521",
        "advertPlanName": "邹文韬流量主-得物广告计划",
        "launchType": null,
        "dropAddrList": [],
        "areaBlackList": null,
        "deviceType": [
            "2",
            "1"
        ],
        "operatorType": [
            "10",
            "20",
            "30",
            "40",
            "50"
        ],
        "operatorTypes": null,
        "cycleType": null,
        "positionNo": "POSI1749461056822834",
        "content": "",
        "positionConfigDto": null,
        "fileInfo": {
            "planNo": null,
            "uid": "1749461051676",
            "name": null,
            "url": "https://cdn-ad-oss.szymzh.com/upgrade/2025-06-09/1744966980827_7f51a0bc28b56db4b38c03ffc60eb6ce.png"
        },
        "advertTypeNo": "CONF1735958846022809",
        "isSkip": "10",
        "advertWeight": 100,
        "skipWxAppId": null,
        "skipType": "10",
        "skipAddr": "www.baidu.com",
        "planStartTime": "2025-06-09 00:00:00",
        "planEndTime": "2025-06-30 00:59:59",
        "remark": null,
        "status": "10",
        "deptId": 588,
        "advertFileUrl": null,
        "projectNo": "PROJECT1735957158960944",
        "projectName": "云盟互联-WX小程序",
        "projectConfigs": null,
        "advertPositionName": "邹文韬流量主广告位02",
        "isRestrict": "10",
        "restrictNum": 500000,
        "exposureNum": 500000,
        "extData": null,
        "advertProduct": "得物"
    }
}
作者：邹文韬  创建时间：2025-06-07 15:15
最后编辑：吴勇  更新时间：2025-06-20 15:49