更新创意

更新创意

HTTP请求方式

POST

请求地址

https://api.e.360.cn/mobile/advert/Update

Headers 请求参数

字段	类型	必须	描述
Content-Type	string	yes	application/x-www-form-urlencoded
apiKey	string	yes	注册时分配到的api key，该参数作为HTTP HEAD字段传递。
accessToken	string	yes	访问token

Body 请求参数

字段	类型	必须	描述
adverts	string	yes	JSON 格式的创意对象数组，单次请求提交数量最多 100 个

adverts示例

[
    {
        "id":4301674883,
        "name": "openapi创建创意标题1",
        "title": "openapi创意描述1-1",
        "ext_text": "第二行创意",
        "btn_text": "按钮名称",
        "logo":"https://mdsp6.qhimg.com/t01ddf8e07953f05e8f.jpg",
        "link":"http://111.sowa.com",
        "deep_link":""
    },
    {
        "id": 43016748369,
        "name": "openapi创建创意标题1",
        "title": "openapi创意描述1-1",
        "ext_text": "第二行创意",
        "btn_text": "按钮名称",
        "logo":"https://mdsp6.qhimg.com/t01ddf8e07953f05e8f.jpg",
        "link":"http://111.sowa.com",
        "deep_link":""
    }
]

字段说明

字段	类型	必须	描述
id	int	Yes	创意id
disabled	int	No	创意状态：0启用, 1暂停，2删除
name	string	No	创意名称，不大于60个字符
title	string	No	创意标题，不大于105个字符可包含通配符（倒计时按天或按小时，只能二选一） {地域} {手机品牌} {星期} {时段} {倒计时(天)} {倒计时(小时)}
ext_text	string	No	子标题，不大于48个字符 [计划投放类型为移动网站推广时可修改，否则不能修改] 可包含通配符（倒计时按天或按小时，只能二选一） {地域} {手机品牌} {星期} {时段} {倒计时(天)} {倒计时(小时)}
cdd_start_time	string	No	通配符倒计时的开始时间，格式2020-07-06，开始、结束时间相隔要小于90天
cdd_end_time	string	No	通配符倒计时的结束时间，格式2020-08-06，开始、结束时间相隔要小于90天
lastday_sign	string	No	通配符含"按天倒计时"时，最后一天是否使用分小时倒计时，0否、1是
cdh_start_hour	string	No	通配符倒计时的开始时段，格式0-23的整数
cdh_end_hour	string	No	通配符倒计时的结束时段，格式1-24的整数
btn_text	string	No	按钮名称，不大于12个字符 [非移动网站推广时可修改，否则不能修改]
package_name	string	No	APP名称，不大于48个字符 [计划投放类型非移动网站推广且操作系统定向为IOS时可修改，否则不能修改]
logo	string	No	logo图标地址，类型支持jpg、png 推广目的为"应用下载"且定向操作系统为安卓 [不能修改] 推广目的为"应用激活"且定向操作系统为安卓 [不能修改] 其它场景 [可修改]
link	string	No	链接推广目的是"应用下载"且定向操作系统为安卓时：下载URL（默认使用360手机助手APP下载地址） [不能修改] 推广目的是"应用下载"且定向操作系统为IOS时：下载URL [可修改] 推广目的是"应用激活"：H5链接（请输入与注册域名一致的H5链接，定向os为ios时，链接请使用https协议） [可修改] 推广目的是"移动网站推广"：H5链接(如使用360建站工具，请选择与推广组绑定的转化目标一致的移动建站站点投放，如无满足条件的站点，请前往“移动建站”添加相应的站点组件) [可修改] 操作系统定向为IOS时，必须是https协议
deep_link	string	No	deepLink链接推广目的是"应用下载"：若填写该项，则用户安装完成APP后，通过该deeplink链接打开指定页面 [可修改] 推广目的是"应用激活"： [可修改] 推广目的是"移动网站推广"：[不能修改]
content_imgs	string	No	json格式，例：[\"https:\/\/mdsp8.qhimg.com\/t01cfd19ceda5ecaa9e.jpg\",\"https:\/\/mdsp4.qhimg.com\/t0147dae78cb2726ee2.jpg\"] 注意：类型支持jpg、png
view_monitor	string	No	第三方展现监测链接（仅广告模式为PMP时可设置）
click_monitor	string	No	第三方点击监测链接（仅广告模式为PMP时可设置）

请求示例

curl -X POST \ 
--header 'apiKey:APIKEY' \ 
--header 'accessToken:ACCESSTOKEN' \ 
--data 'adverts=[{"id":4301674883,"name":"openapi创建创意标题1","title":"openapi创意描述1-1","ext_text":"第二行创意","btn_text":"按钮名称","logo":"https://mdsp6.qhimg.com/t01ddf8e07953f05e8f.jpg","link":"http://111.sowa.com","deep_link":""},{"id":43016748369,"name":"openapi创建创意标题1","title":"openapi创意描述1-1","ext_text":"第二行创意","btn_text":"按钮名称","logo":"https://mdsp6.qhimg.com/t01ddf8e07953f05e8f.jpg","link":"http://111.sowa.com","deep_link":""}]' \ 
'https://api.e.360.cn/mobile/advert/Update'

返回结果

{
    "affectedRecords": 0,
    "failAdvertIds": [
        4301674883,
        43016748369
    ],
    "failures": [
        {
            "code": 1002005,
            "description": "",
            "message": "推广目的为非移动网站推广，且定向操作系统为安卓时，不需要填logo"
        },
        {
            "code": 1002005,
            "description": "",
            "message": "创意ID非法"
        }
    ]
}

返回结果说明

字段	类型	描述
affectedRecords	int	更新成功的创意个数
failAdvertIds	array	更新失败的创意ID
failures	array	更新失败的错误信息，与failAdvertIds中的id顺序一一对应

results matching ""

No results matching ""