添加创意

添加创意

HTTP请求方式

POST

请求地址

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

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示例

[{
        "campaign_id": 607119656,
        "solution_id":608520262,
        "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":"",
        "creative_type":"native",
        "content_imgs":"[\"https:\/\/mdsp8.qhimg.com\/t01cfd19ceda5ecaa9e.jpg\",\"https:\/\/mdsp4.qhimg.com\/t0147dae78cb2726ee2.jpg\"]",
        "view_monitor":"",
        "click_monitor":"",
        "package_name":"ddd"
    },
    {
        "campaign_id": 607119656,
        "solution_id":608520262,
        "name": "openapi创建创意标题2",
        "title": "openapi创意描述1-1",
        "ext_text": "第二行创意",
        "btn_text": "按钮名称",
        "logo":"https://mdsp6.qhimg.com/t01ddf8e07953f05e8f.jpg",
        "link":"http://111.sowa.com",
        "deep_link":"",
        "creative_type":"native",
        "content_imgs":"[\"https:\/\/mdsp8.qhimg.com\/t01cfd19ceda5ecaa9e.jpg\",\"https:\/\/mdsp4.qhimg.com\/t0147dae78cb2726ee2.jpg\"]",
        "view_monitor":"",
        "click_monitor":"",
        "package_name":"ddd"
    }
]

字段说明

字段	类型	必须	描述
campaign_id	int	Yes	计划id
solution_id	int	Yes	组id
name	string	Yes	创意名称，不大于60个字符
title	string	Yes	创意标题，不大于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链接打开指定页面 [选填] 推广目的是"应用激活"： [必填] 推广目的是"移动网站推广"：[不填]
creative_type	string	Yes	创意素材的类型：单图native、多图multiimage
content_imgs	string	Yes	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=[{"campaign_id":607119656,"solution_id":608520262,"name":"openapi创建创意标题1","title":"openapi创意描述1-1","ext_text":"第二行创意","desc":"wfwefwef","btn_text":"按钮名称","logo":"https://mdsp6.qhimg.com/t01ddf8e07953f05e8f.jpg","link":"http://111.sowa.com","deep_link":"","creative_type":"native","content_imgs":"[\"https:\/\/mdsp8.qhimg.com\/t01cfd19ceda5ecaa9e.jpg\",\"https:\/\/mdsp4.qhimg.com\/t0147dae78cb2726ee2.jpg\"]","view_monitor":"","click_monitor":""},{"campaign_id":607119656,"solution_id":608520262,"name":"openapi创建创意标题1","title":"openapi创意描述1-1","ext_text":"第二行创意","desc":"wfwefwef","btn_text":"按钮名称","logo":"https://mdsp6.qhimg.com/t01ddf8e07953f05e8f.jpg","link":"http://111.sowa.com","deep_link":"","creative_type":"native","content_imgs":"[\"https:\/\/mdsp8.qhimg.com\/t01cfd19ceda5ecaa9e.jpg\",\"https:\/\/mdsp4.qhimg.com\/t0147dae78cb2726ee2.jpg\"]","view_monitor":"","click_monitor":""}]' \ 
'https://api.e.360.cn/mobile/advert/Add'

返回结果

{
    "advertIdList": [
        [
            4301664332,
            4301664333
        ]
    ],
    "failures": [
        {}
    ]
}

返回结果说明

字段	类型	描述
advertIdList	String	新增的创意id数组，如果某个创意插入失败，对应的id为空[]
failures	String	与传参adverts中json的顺序一致，如果插入失败，则返回对应的错误信息，如果成功，则返回空{}

results matching ""

No results matching ""