添加凤舞创意
上传自定义凤舞创意接口,支持PC类型的凤舞橱窗、凤舞导航、凤舞长子链、凤舞列表、短子链、短导航、游戏直达创意、凤舞视频,以及移动的凤舞橱窗、导航、长子链、短子链创意;同一推广组下,一个设备类型的同一种凤舞创意只能存在一个,上传时,key的格式为"创意类型-设备类型",每种类型的具体限制请参照点睛平台。
HTTP请求方式
POST
请求地址
Headers请求参数
字段 | 类型 | 必须 | 描述 |
---|---|---|---|
apiKey | String | Yes | 注册时分配到的api key,该参数作为HTTP HEAD字段传递。 |
accessToken | String | Yes | 身份认证通过后平台分配的临时token,作为操作对应广告账户的凭证,10小时有效。参数获取方式见接口clientLogin。 |
Body请求参数
字段 | 类型 | 必须 | 描述 |
---|---|---|---|
groupIdList | String | Yes | JSON格式的推广组id数组 |
windows-computer | String | No | PC凤舞橱窗创意,JSON 格式的创意对象数组。每组创意包含4个凤舞商品橱窗,每个凤舞橱窗包含4个属性:title、description、url、image,均为必填项,商品名不能重复,图片不能重复。请求参数值示例 |
windows-mobile | String | No | 移动凤舞橱窗创意,JSON 格式的创意对象数组。每组创意包含3-8个凤舞商品橱窗,每个凤舞橱窗包含4个属性:title(必填)、description(选填)、url(必填)、image(必填),商品名不能重复,图片不能重复。请求参数值示例 |
guides-computer | String | No | PC凤舞导航创意,JSON 格式的创意对象数组。每组创意3个凤舞导航,每个导航包含1个标签名和3-10个子链。每个子链包含2个属性:text、url,均为必填项,链接文字不能重复,标签名不能重复。 请求参数值示例 |
guides-mobile | String | No | 移动凤舞导航创意,JSON 格式的创意对象数组。每组创意包含2-6凤舞导航,每个导航包含1个标签名和2-10个子链。每个子链包含2个属性:text、url,均为必填项,链接文字不能重复,标签名不能重复。 请求参数值示例 |
links-computer | String | No | PC凤舞长子链创意,JSON 格式的创意对象数组。每组创意包含2-10个凤舞长子链,每个长子链包含三个属性:dece、text、url,均为必填项。 请求参数值示例 |
links-mobile | String | No | 移动凤舞长子链创意,JSON 格式的创意对象数组。每组创意包含3-10个凤舞长子链,每个长子链包含三个属性:dece、text、url,均为必填项。 请求参数值示例 |
lists-computer | String | No | PC凤舞列表创意,JSON 格式的创意对象数组。每组创意包含4~6个凤舞列表,每个列表包含5个属性:其中title、text、clicktitle(可填写值:点击查看、点击报名、点击购买、点击进入、点击预订、点击注册、点击咨询)、url为必填项, description为非必填(但是否要填写,所有凤舞列表必须保持一致)。请求参数值示例 |
sublinks-computer | String | No | PC凤舞短子链创意,JSON 格式的创意对象数组。每组创意包含4-10个凤舞短子链,每个短子链包含两个属性:text、url,均为必填项。请求参数值示例 |
sublinks-mobile | String | No | 移动凤舞短子链创意,JSON 格式的创意对象数组。每组创意包含2-10个凤舞短子链,每个短子链包含两个属性:text、url,均为必填项。请求参数值示例 |
short_guides-computer | String | No | PC凤舞短导航创意,JSON 格式的创意对象数组。每组创意2个或4个凤舞短导航,每个短导航包含1个标签名和2-4个子链。每个子链包含2个属性:text、url,均为必填项,链接文字不能重复,标签名不能重复。请求参数值示例 |
yx_direct-computer | String | No | 游戏直达创意,JSON 格式的创意对象数组。每组创意包含1-3个游戏创意,每个游戏创意包含6个属性(游戏名称和图片不能重复):title:游戏名称,必填;tags:属性,必填,至少填写两种属性;(key:类型;value:角色扮演、模拟经营、休闲竞技、战争策略、儿童养成、其他)(key:玩法;value:即时、半回合、回合、其他)(key:题材;value:体育、奇幻、军事、武侠、三国、西游、仙侠、星战、动漫、战斗、魔幻、科幻、其他)dece:游戏描述,必填;button:点击标签,必填(支持填写:点击查看、点击注册、开始游戏、立即试玩);image:宽高不能低于121x75px,不高于363x225,不超过100K支持JPG、JPEG、PNG格式,必填;url:链接网址,必填;请求参数值示例 |
video-computer | String | No | PC凤舞视频,JSON 格式的创意对象数组。凤舞视频创意包含3个属性:url:链接网址,必填;cover_img:视频封面图片base64(图片格式jpg、png、jpeg,大小2M以内,宽高比16:9,比例区间为[1.69:1, 1.81:1],建议尺寸225×126),必填;video_url:视频链接网址(请先使用视频上传上传视频,视频格式MP4,大小20M以内,宽高比16:9,比例区间为[1.69:1, 1.81:1], 时长6-60s,建议分辨率1280×720),必填;请求参数值示例 |
status | String | No | 凤舞启用/暂停状态,enable/pause,默认为启用 |
请求示例
curl -X POST \
--header 'apiKey:APIKEY' \
--header 'accessToken:ACCESSTOKEN' \
--data 'groupIdList=&windows-computer=&guides-computer=&links-computer=&lists-computer=&sublinks-computer=' \
'https://api.e.360.cn/dianjing/fengwu/add'
返回结果
{
"success": [
{
"id": 8166548775,
"type": "guides",
"device": "computer",
"groupId": 4125566033
}
],
"failures": []
}
返回结果说明
字段 | 类型 | 描述 |
---|---|---|
id | string | 新增的凤舞创意id,如果某个创意插入失败,对应的id为0 |
type | string | 凤舞创意类型,和添加时的类型相对应 |
groupid | string | 凤舞创意所属推广组id |
device | string | 设备类型 |
请求参数值示例
PC/移动凤舞橱窗示例
[
{
"title": "凤舞橱窗1",
"description": "凤舞橱窗描述1",
"url": "http://www.djtest.ren",
"image": "图片base64编码"
},
{
"title": "凤舞橱窗2",
"description": "凤舞橱窗描述2",
"url": "http://www.djtest.ren",
"image": "图片base64编码"
},
{
"title": "凤舞橱窗3",
"description": "凤舞橱窗描述3",
"url": "http://www.djtest.ren",
"image": "图片base64编码"
},
{
"title": "凤舞橱窗4",
"description": "凤舞橱窗描述4",
"url": "http://www.djtest.ren",
"image": "图片base64编码"
}
]
PC/移动凤舞导航(短导航)示例
[{
"title": "导航一",
"links": [{
"text": "链接文字1",
"url": "http://www.djtest.ren"
},
{
"text": "链接文字2",
"url": "http://www.djtest.ren"
},
{
"text": "链接文字3",
"url": "http://www.djtest.ren"
}
]
},
{
"title": "导航二",
"links": [{
"text": "链接文字1",
"url": "http://www.djtest.ren"
},
{
"text": "链接文字2",
"url": "http://www.djtest.ren"
},
{
"text": "链接文字3",
"url": "http://www.djtest.ren"
}
]
},
{
"title": "导航三",
"links": [{
"text": "链接文字1",
"url": "http://www.djtest.ren"
},
{
"text": "链接文字2",
"url": "http://www.djtest.ren"
},
{
"text": "链接文字3",
"url": "http://www.djtest.ren"
}
]
}
]
PC/移动凤舞长子链示例
[
{
"dece": "标签1",
"text": "凤舞长子链文字1",
"url": "http://www.djtest.ren"
},
{
"dece": "标签2",
"text": "凤舞长子链文字2",
"url": "http://www.djtest.ren"
}
]
PC凤舞列表示例
[
{
"title": "凤舞列表商品名称1",
"description": "商品描述1",
"text": "描述1",
"clicktitle": "点击查看",
"url": "http://www.djtest.ren"
},
{
"title": "凤舞列表商品名称2",
"description": "商品描述2",
"text": "描述2",
"clicktitle": "点击查看",
"url": "http://www.djtest.ren"
},
{
"title": "凤舞列表商品名称3",
"description": "商品描述3",
"text": "描述3",
"clicktitle": "点击查看",
"url": "http://www.djtest.ren"
},
{
"title": "凤舞列表商品名称4",
"description": "商品描述4",
"text": "描述4",
"clicktitle": "点击查看",
"url": "http://www.djtest.ren"
}
]
PC/移动凤舞短子链示例
[
{
"text": "凤舞短子链文字1",
"url": "http://www.djtest.ren"
},
{
"text": "凤舞短子链文字2",
"url": "http://www.djtest.ren"
},
{
"text": "凤舞短子链文字3",
"url": "http://www.djtest.ren"
},
{
"text": "凤舞短子链文字4",
"url": "http://www.djtest.ren"
}
]
凤舞游戏直达示例
[{
"title": "游戏名称",
"dece": "游戏描述信息",
"button": "点击查看",
"image": "图片base64编码",
"tags": [{
"key": "类型",
"value": "休闲竞技"
}, {
"key": "题材",
"value": "武侠"
}],
"url": "http://djtest.cn"
}]
PC凤舞视频
[{
"url": "http://djtest.cn",
"cover_img":"图片base64编码",
"video_url": "https://cicd-up2.e.360.cn/video/get-url?key=H264_20240521140359_869.mp4"
}]