批量新增创意
HTTP请求方式
POST
请求地址
Headers 请求参数
字段 | 类型 | 必须 | 描述 |
---|---|---|---|
Content-Type | string | yes | application/json |
apiKey | string | yes | 注册时分配到的api key,该参数作为HTTP HEAD字段传递。 |
accessToken | string | yes | 访问token |
Body 请求参数
以推广组维度进行创意添加,请求参数通过JSON array传参,一次操作对象数量不超过10个,任意层级同object的重复key以最后一个为准
字段 | 类型 | 必须 | 描述 |
---|---|---|---|
solutionId | int | yes | 推广组ID |
titles | []string | yes | 标题数组,创意标题长度范围:[15字符:60字符] |
memo | string | yes | 创意描述长度范围:[15字符:120字符] |
links | []string | yes | 落地页数组,单个落地页不超过1024个字符 |
alt | string | yes | 推广网站,不超过12个字符 |
width | int | yes | 物料宽度,尺寸枚举值见下方表格 |
height | int | yes | 物料高度,尺寸枚举值见下方表格 |
url | string | yes | 物料上传接口返回的url地址 |
cover | string | no | 视频封面,不传表示自动获取视频首帧;封面不能等比例,需要和视频尺寸完全一致,填写要求见下方表格 |
buttonName | string | no | 16:9和9:16视频创意下必传,为引导按钮文案,转化组件默认<互动引导>,长度范围:[2字符:16字符] |
图片尺寸/视频比例 | 图片/视频格式及大小 |
---|---|
1920x1080 | 格式GIF/JPEG/JPG/PNG;大小:静图1000K以内,动图3000K以内;最多10张,投放时系统将为您智能选择投放 |
320x402 | 格式GIF/JPEG/JPG/PNG;大小:静图300K以内,动图600K以内;最多10张,为了能够覆盖更多流量,至少需要1张静图;投放时系统将为您智能选择投放 |
660x220 | 格式GIF/JPEG/JPG/PNG;大小:静图300K以内,动图600K以内;最多10张,投放时系统将为您智能选择投放 |
180x100 | 格式GIF/JPEG/JPG/PNG;大小:静图50K以内,动图300K以内;最多10张,投放时系统将为您智能选择投放 |
500x500 | 格式GIF/JPEG/JPG/PNG;大小:静图300K以内,动图600K以内;最多10张,投放时系统将为您智能选择投放 |
640x360 | 格式GIF/JPEG/JPG/PNG;大小:静图300K以内,动图600K以内;最多10张,投放时系统将为您智能选择投放 |
1904x360 | 格式PNG;大小300K以内;最多10张,投放时系统将为您智能选择投放 |
1180x150 | 格式GIF/JPEG/JPG/PNG;大小:静图300K以内,动图600K以内;最多10张,投放时系统将为您智能选择投放 |
300x150 | 格式GIF/JPEG/JPG/PNG;大小:静图300K以内,动图600K以内;最多10张,投放时系统将为您智能选择投放 |
16:9 | 视频:宽高比16:9-推荐分辨率1920x1080px,格式MP4,大小30M以内,时长5~60s,最多10个; 封面:推荐尺寸1920x1080;格式JPEG/JPG/PNG/GIF;大小:静图1000K以内,动图3000K以内,视频尾帧弹层会展示封面图 |
9:16 | 视频:宽高比9:16-推荐分辨率720x1280px,格式MP4,大小30M以内,时长5~60s,最多10个; 封面:推荐尺寸720x1280;格式JPEG/JPG/PNG/GIF;大小:静图300K以内,动图600K以内,视频尾帧弹层会展示封面图 |
3:1 | 视频:宽高比3:1-推荐分辨率660x220px,格式MP4,大小30M以内,时长5~60s,最多10个; 封面:推荐尺寸660x220;格式JPEG/JPG/PNG/GIF;大小:静图300K以内,动图600K以内,视频尾帧弹层会展示封面图 |
1:1 | 视频:宽高比1:1-推荐分辨率500x500px,格式MP4,大小30M以内,时长5~60s,最多10个; 封面:推荐尺寸500x500;格式JPEG/JPG/PNG/GIF;大小:静图300K以内,动图600K以内,视频尾帧弹层会展示封面图 |
请求示例
curl --location --request POST 'https://api.e.360.cn/display/banner/add' \
--header 'apiKey:APIKEY' \
--header 'accessToken:ACCESSTOKEN' \
--header 'Content-Type: application/json' \
--data-raw '[{
"solutionId": 33885894,
"imageView": {
"titles": ["图文创意的创意标题1", "图文创意的创意标题2"],
"memo": "图文创意的创意描述",
"links": ["https://sxwo2-762.njianzhan.com?impression_id={impression_id}&exchange_id={exchange_id}&mvosr={source_id}&bannerid={bannerid}&creativeid={creativeid}&vn=1&qhclickid={clickid}&q={query}&keywordid={keywordid}&qaid={qaid}"],
"alt": "360",
"sizeImages": [{
"width": 1180,
"height": 150,
"imageDetails": [{"url": "https://s3m.mediav.com/test/2f0e50bcedf73e4e2e6ffec55af49bb9.jpg"}]
}]
},
"videoView": {
"titles": ["视频创意的创意标题1", "视频创意的创意标题2"],
"memo": "视频创意的创意描述",
"links": ["https://sxwo2-762.njianzhan.com?impression_id={impression_id}&exchange_id={exchange_id}&mvosr={source_id}&bannerid={bannerid}&creativeid={creativeid}&vn=1&qhclickid={clickid}&q={query}&keywordid={keywordid}&qaid={qaid}"],
"alt": "360",
"sizeVideos": [{
"width": 1920,
"height": 1080,
"videoDetails": [{"url":"http://live-s3m.mediav.com/test/0429779c74ad970f839141e4a305b72c.mp4", "cover":"https://s3m.mediav.com/test/7eb30d31237cc909d52eacfe030d68e4.jpg"}]
}],
"buttonName":"引导文案"
}
}]'
返回结果
{
"data": [
{
"solutionId": 33885815,
"errno": 2000000,
"message": "成功"
},
{
"solutionId": 33885815,
"errno": 2000003,
"message": "请上传标题内容"
}
],
"errmsg": "OK",
"errno": 0
}
返回结果说明
字段 | 类型 | 描述 |
---|---|---|
errno | int | 错误码参见errorCode.md |
solutionId | int | 推广组ID |