添加创意


添加创意

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 ""