批量新增创意


HTTP请求方式

POST

请求地址

https://api.e.360.cn/display/banner/add

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

results matching ""

    No results matching ""