添加凤舞创意

上传自定义凤舞创意接口，支持PC类型的凤舞橱窗、凤舞导航、凤舞长子链、凤舞列表、短子链、短导航、游戏直达创意，以及移动的凤舞橱窗、导航、长子链、短子链创意；同一推广组下，一个设备类型的同一种凤舞创意只能存在一个，上传时，key的格式为"创意类型-设备类型"，每种类型的具体限制请参照点睛平台。

HTTP请求方式

POST

请求地址

https://api.e.360.cn/dianjing/fengwu/add

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：链接网址,必填；请求参数值示例
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"
}]

results matching ""

No results matching ""