百度信息流推广API

    闪投创意模块

    闪投创意对象

    闪投创意对象定义了创意的所有属性,闪投创意模块的多个接口均引用了其定义,请参考各接口的说明使用。

    字段名称 类型 描述
    campaignFeedId number 所属推广计划ID
    adgroupFeedId number 推广单元ID
    creativeFeedId number 创意ID
    materialstyle number 样式
    说明:同一单元下可同时存在多种样式的创意(注:仅支持单元所属流量下的样式)
    creativeFeedName string 创意名称
    material string 物料内容。
    此物料内容仅在保存闪投创意时返回预览使用。参考闪投物料内容对象
    template object 闪投创意物料模板。
    各种创意样式所需的物料字段有所不同,请参考闪投创意模板对象闪投创意样式列表
    pause boolean 是否暂停推广
    status number 创意状态
    此字段仅用于查询,新增/修改创意时参数中传此字段无效。
    取值范围如下:
    0:有效
    1:暂停推广
    2:审核中
    3:审核未通过
    4:无效(因与所属推广单元所选的投放版位不匹配而无法投放,推广单元修改投放版位后将自动重置此状态。请参考创意样式列表的说明。)
    refusereason string 审核拒绝理由
    原因可能有多个,该字段为string形式的json数组,数组元素为string类型,每个元素是一个原因。
    示例: "["原因A","原因B"]"

    闪投创意模板对象

    该数据对象定义了创意模板相关信息

    字段名称 类型 描述
    title string 创意标题
    可使用商品库字段,标题实际显示会根据屏幕适配截断。
    示例:
    大多数人不知道,这里买${name}更便宜
    subtitle string 副标题
    targetUrl string 推广链接
    可使用商品库字段,如${targetUrl}
    monitorUrl string 监控链接
    仅在选取应用下载类型闪投计划时可用(IOS或Andriod),支持选填.可使用商品库字段,如${monitorUrl}
    exposureUrl string 曝光监测URL。统一要求url长度不超过1024个字符。
    注意:仅推广单元中选择的优化目标为曝光或转化时支持曝光监测。
    userPortrait string 用户头像链接
    naUrl string 调起链接
    仅在选取网站链接类型闪投计划时可用。填写deeplink,如判断用户安装了app,可直接从浏览器调起app,否则跳转至点击跳转url(目前仅支持手机百度首页,如投放了其他流量,将直接跳转至点击跳转url)
    pictures array(object) 主尺寸图片列表。对应于尺寸列表内的第一个尺寸
    非单选百青藤流量时必填,单选百青藤流量时选填
    根据样式所需的图片个数填写相应个数的元素,多图片样式部分图片自提时,对应的图片填写为相应的图片url
    示例(单品三图):
    [{"url":"${image}"},{"url":"http://example.com/example.jpg"},{"url":"${image}"}],请参考闪投图片模板对象
    extraPictures array(object) 多尺寸图片列表(选填),可填写当前样式支持的更多尺寸
    仅在优选流量,或自定义流量包含百青藤流量时可用
    百青藤流量创意(开屏样式)图片所有尺寸自提应均使用extraPictures字段,pictures字段不传
    示例(单品大图):
    [{"pictures":[{"image":"http://www.sample.jpg"}],"width":960,"height":640}]
    示例(单品三图):
    [{"pictures":[{"image":"http://www.sample1.jpg"},{"image":"http://www.sample2.jpg"},{"image":"http://www.sample3.jpg"}],"width":600,"height":300}]
    请参考闪投多尺寸图片对象
    poster string 视频封面
    仅视频样式使用
    可使用商品库字段
    横版视频未填写时,将复用pictures内第一个元素(图片物料)的url
    竖版视频未填写时,将使用商品库字段verticalPoster
    videoId number 视频id
    仅视频样式使用
    使用商品库字段时不填写,视频自提时必填
    自提视频ID可以通过相关接口,或信息流推广Web端的“视频库”中获取
    duration string 视频时长
    仅视频样式使用
    可使用商品库字段,视频自提时必须填写数字
    横版视频未填写时,将使用商品库字段videoDuration
    竖版视频未填写时,将使用商品库字段verticalVideoDuration
    自提视频时长可以通过相关接口获取
    videoUrl string 视频地址
    仅视频样式使用
    可使用商品库字段,视频自提时必须填写视频地址
    横版视频未填写时,将使用商品库字段videoUrl
    竖版视频未填写时,将使用商品库字段verticalVideoUrl
    自提视频地址可以通过相关接口获取
    miniProgramSchema string 小程序链接地址

    闪投图片模板对象

    该数据对象定义了创意图片相关信息

    字段名称 类型 描述
    url string 图片链接
    使用商品库字段时固定填写${image}
    使用自提图片时,创意图片必须先使用ImageService的相关接口上传,使用接口返回的URL进行投放。
    橱窗样式不支持自提图片
    targetUrl string 跳转链接
    naUrl string 调起链接
    desc1 string 图片描述1,仅橱窗样式可用
    desc2 string 图片描述2,仅橱窗样式可用

    闪投多尺寸图片对象

    该数据对象定义了创意多尺寸图片相关信息,可填写当前创意样式支持的更多尺寸图片。一个创意的extraPictures内可以填写多个多尺寸图片对象,一个多尺寸图片对象包含了单个尺寸下的图片列表。

    字段名称 类型 描述
    pictures array(object) 图片链接列表。元素个数应为创意样式所需图片个数。不支持商品通配符。
    示例(单品大图):
    [{"image":"http://www.sample.jpg"}]
    示例(单品三图):
    [{"image":"http://www.sample1.jpg"},{"image":"http://www.sample2.jpg"},{"image":"http://www.sample3.jpg"}]
    width number 宽度
    height number 高度

    闪投预览物料内容对象

    该数据对象定义了创意预览物料内容相关信息

    字段名称 类型 描述
    url string 推广链接
    title string 创意标题
    subtitle string 副标题
    brand string 品牌名
    userPortrait string 用户头像链接
    monitorUrl string 监控链接
    naUrl string 调起链接
    pictures array(object) 创意图片。
    创意图片必须先使用ImageService的相关接口上传,使用接口返回的URL进行投放。
    创意图片字段值为object数组,元素中的image字段表示图片URL地址。
    示例(三图):[{"image":"http://example.com/example.jpg"},{"image":"http://example.com/example.jpg"},{"image":"http://example.com/example.jpg"}]
    template string 创意模板json。
    videoid number 视频ID。仅视频样式支持。
    商品库视频的视频id为0。
    poster string 视频默认帧图片。仅视频样式支持。

    闪投用户、监控通配符对象

    该数据对象定义了创意物料中可以插入的用户、监控通配符相关信息

    字段名称 类型 描述
    value string 通配符名
    例:U_CITY
    label string 标签
    例:城市
    dimension string 维度
    例:空间维度
    description string 描述
    例:奥迪A6大降价,仅限#{U__CITY}!

    查询闪投创意

    接口描述

    查询闪投创意信息

    接口URL

    http://sem.baidubce.com/v1/feed/cloud/DpaCreativeFeedService/getCreativeFeed

    请求参数说明

    字段名称 类型 描述
    creativeFeedFields array(string) 需要查询的创意属性。属性名称即闪投创意对象的字段名称。
    idType number 查询条件ids字段的类型,1表示计划ID,2表示单元ID,3表示创意ID。
    ids array(number) 需要查询的计划ID/单元ID/创意ID数组,最多填100个ID。
    creativeFeedFilter object 查询创意的筛选条件,定义见下。

    查询创意的筛选条件(creativeFeedFilter字段)用于更精细地筛选查询的创意。目前仅支持按照创意状态筛选。字段如下:

    字段名称 类型 描述
    status array(number) 需要筛选的创意状态。取值请参考闪投创意对象的status字段说明。

    响应参数说明

    响应内容为闪投创意对象数组,请参考其定义。

    请求示例

    POST /v1/feed/cloud/DpaCreativeFeedService/getCreativeFeed HTTP/1.1
    Accept-encoding: 'gzip, deflate'
    Host: sem.baidubce.com
    ContentType: application/json
    Authorization: bce-auth-v1/b406c344bb764e00aff7d3b80d9bd87a/2019-06-05T07:34:31Z/1800/host/bb0f820e4499b8b44548388b37a7afed970e965a7a59f79ebac47a99c315a97b(签名有效时间为30分钟,需要替换成自己生成的签名)
    Accept: '*/*'
    {
    	"header": {
    		"opUsername": "example",
    		"tgUsername": "example",
    		"bceUser": "example",
    		"opPassword": "example",
    		"tgPassword": "example"
    	},
    	"body": {
    		"ids": [
    			"54320498743"
    		],
            "idType": 3,
    		"creativeFeedFields": [
    			"creativeFeedId",
    			"creativeFeedName",
    			"materialstyle",
    			"material",
                "template",
                "pause",
                "status",
                "refuseReason"
    		],
            "creativeFeedFilter": {
                "status": [0]
            }
    	}
    }

    响应示例

    {
    	"body": {
    		"data": [
    			{
                    "creativeFeedId": 54320498743,
                    "campaignFeedId": null,
                    "adgroupFeedId": 3739952204,
                    "materialstyle": 502,
                    "creativeFeedName": "单品单图",
                    "material": "{\"title\":\"上海用户都在看!国内知名律师\",\"brand\":\"search\",\"url\":\"http://www.china3561.com\",\"userPortrait\":\"http://fc-feed.cdn.bcebos.com/0/pic/befa1b8e1015787136eb48d55638a24d.jpg\",\"pictures\":[{\"image\":\"http://fc-feed.cdn.bcebos.com/0/pic/8562166e1a1a9cff2a5f6d52940c4068.png\"},{\"image\":\"http://fc-feed.cdn.bcebos.com/0/pic/2ce3baae695113387fb56cf22924b7d3.png\"},{\"image\":\"http://fc-feed.cdn.bcebos.com/0/pic/08670eea4af547a8bffbb3b981e69989.png\"}],\"monitorUrl\":\"\",\"sku\":[],\"template\":\"{\\\"content\\\":{\\\"fields\\\":[{\\\"image\\\":{\\\"key\\\":\\\"imgUrl_1\\\",\\\"value\\\":\\\"http://fc-feed.cdn.bcebos.com/0/pic/8562166e1a1a9cff2a5f6d52940c4068.png\\\"}},{\\\"image\\\":{\\\"key\\\":\\\"imgUrl_3\\\",\\\"value\\\":\\\"http://fc-feed.cdn.bcebos.com/0/pic/08670eea4af547a8bffbb3b981e69989.png\\\"}},{\\\"image\\\":{\\\"key\\\":\\\"userPortrait\\\",\\\"value\\\":\\\"http://fc-feed.cdn.bcebos.com/0/pic/befa1b8e1015787136eb48d55638a24d.jpg\\\"}},{\\\"text\\\":{\\\"key\\\":\\\"title\\\",\\\"value\\\":\\\"#{U__CITY}用户都在看!国内知名律师\\\"}},{\\\"image\\\":{\\\"key\\\":\\\"imgUrl_2\\\",\\\"value\\\":\\\"http://fc-feed.cdn.bcebos.com/0/pic/2ce3baae695113387fb56cf22924b7d3.png\\\"}},{\\\"url\\\":{\\\"key\\\":\\\"targetUrl\\\",\\\"value\\\":\\\"http://www.china3561.com\\\"}},{\\\"url\\\":{\\\"key\\\":\\\"naUrl\\\",\\\"value\\\":\\\"\\\"}},{\\\"url\\\":{\\\"key\\\":\\\"monitorUrl\\\",\\\"value\\\":\\\"\\\"}},{\\\"text\\\":{\\\"key\\\":\\\"brand\\\",\\\"value\\\":\\\"search\\\"}}],\\\"product_count\\\":0,\\\"huitu_id\\\":0,\\\"image_type\\\":0},\\\"requirement\\\":{\\\"fields\\\":[]}}\",\"pictureWidth\":370,\"pictureHeight\":245}",
                    "template": {
                        "title": "#{U__CITY}用户都在看!国内知名律师",
                        "targetUrl": "http://www.china3561.com",
                        "monitorUrl": "",
                        "userPortrait": "http://fc-feed.cdn.bcebos.com/0/pic/befa1b8e1015787136eb48d55638a24d.jpg",
                        "naUrl": "",
                        "brand": "search",
                        "pictures": [
                            {
                                "url": "${image}",
                                "targetUrl": null,
                                "naUrl": null,
                                "desc1": null,
                                "desc2": null
                            }
                        ],
                        "extraPictures": []
                    },
                    "pause": false,
                    "status": 0,
                    "refusereason": null
                }
    		]
    	},
    	"header": {
    		"oprs": 1,
    		"failures": [],
    		"succ": 1,
    		"oprtime": 0,
    		"desc": "success",
    		"status": 0
    	}
    }

    新增闪投创意

    接口描述

    新增闪投创意

    接口URL

    http://sem.baidubce.com/v1/feed/cloud/DpaCreativeFeedService/addCreativeFeed

    请求参数说明

    字段名称 类型 描述
    creativeFeedTypes array(object) 闪投创意对象数组,请参考其定义。

    响应参数说明

    响应为闪投创意对象数组,请参考其定义。 响应结果中的创意对象与请求参数中一一对应(其中失败的不会包含在data中,但会在error中提供错误信息),且会包含新增成功的创意ID信息。

    请求示例

    POST /v1/feed/cloud/DpaCreativeFeedService/addCreativeFeed HTTP/1.1
    Accept-encoding: 'gzip, deflate'
    Host: sem.baidubce.com
    ContentType: application/json
    Authorization: bce-auth-v1/b406c344bb764e00aff7d3b80d9bd87a/2019-06-05T07:34:31Z/1800/host/bb0f820e4499b8b44548388b37a7afed970e965a7a59f79ebac47a99c315a97b(签名有效时间为30分钟,需要替换成自己生成的签名)
    Accept: '*/*'
    {
    	"header": {
    		"opUsername": "example",
    		"tgUsername": "example",
    		"bceUser": "example",
    		"opPassword": "example",
    		"tgPassword": "example"
    	},
    	"body": {
            "creativeFeedTypes":[
                {
                    "adgroupFeedId": 3739952204,
                    "template": {
                        "title": "#{U__CITY}用户都在看!国内知名律师",
                        "targetUrl": "http://www.china3561.com",
                        "monitorUrl": "",
                        "userPortrait": "http://fc-feed.cdn.bcebos.com/0/pic/befa1b8e1015787136eb48d55638a24d.jpg",
                        "naUrl": "",
                        "brand": "search",
                        "pictures": [
                            {
                                "url": "${image}",
                                "targetUrl": null,
                                "naUrl": null,
                                "desc1": null,
                                "desc2": null
                            }
                        ],
                        "extraPictures": []
                    },
                    "materialstyle": 501,
                    "creativeFeedName": "单品单图2",
                    "pause": false
                }
            ]
        }
    }

    响应示例

    {
    	"body": {
    		"data": [
    			{
                    "creativeFeedId": 112288828471,
                    "campaignFeedId": null,
                    "adgroupFeedId": 3739952204,
                    "materialstyle": 501,
                    "creativeFeedName": "单品单图2",
                    "material": "{\"title\":\"上海用户都在看!国内知名律师\",\"brand\":\"search\",\"url\":\"http://www.china3561.com\",\"userPortrait\":\"http://fc-feed.cdn.bcebos.com/0/pic/befa1b8e1015787136eb48d55638a24d.jpg\",\"pictures\":[{\"image\":\"http://fc-feed.cdn.bcebos.com/0/pic/90e89b1bcc649cd2f53aaf534cb56ded.jpg\"}],\"monitorUrl\":\"\",\"sku\":[],\"template\":\"{\\\"content\\\":{\\\"fields\\\":[{\\\"url\\\":{\\\"key\\\":\\\"targetUrl\\\",\\\"value\\\":\\\"http://www.china3561.com\\\"}},{\\\"image\\\":{\\\"key\\\":\\\"imgUrl\\\",\\\"value\\\":\\\"${attributes.pcImage_1}\\\"}},{\\\"image\\\":{\\\"key\\\":\\\"userPortrait\\\",\\\"value\\\":\\\"http://fc-feed.cdn.bcebos.com/0/pic/befa1b8e1015787136eb48d55638a24d.jpg\\\"}},{\\\"url\\\":{\\\"key\\\":\\\"naUrl\\\",\\\"value\\\":\\\"\\\"}},{\\\"url\\\":{\\\"key\\\":\\\"monitorUrl\\\",\\\"value\\\":\\\"\\\"}},{\\\"text\\\":{\\\"key\\\":\\\"brand\\\",\\\"value\\\":\\\"search\\\"}},{\\\"text\\\":{\\\"key\\\":\\\"title\\\",\\\"value\\\":\\\"#{U__CITY}用户都在看!国内知名律师\\\"}}],\\\"product_count\\\":0,\\\"huitu_id\\\":0,\\\"image_type\\\":0},\\\"requirement\\\":{\\\"fields\\\":[{\\\"image\\\":{\\\"key\\\":\\\"attributes.pcImage_1\\\",\\\"min_aspect_ratio\\\":0.0,\\\"min_pixels\\\":9600}}]}}\",\"pictureWidth\":370,\"pictureHeight\":245}",
                    "template": {
                        "title": "#{U__CITY}用户都在看!国内知名律师",
                        "targetUrl": "http://www.china3561.com",
                        "monitorUrl": "",
                        "userPortrait": "http://fc-feed.cdn.bcebos.com/0/pic/befa1b8e1015787136eb48d55638a24d.jpg",
                        "naUrl": "",
                        "brand": "search",
                        "pictures": [
                            {
                                "url": "${image}",
                                "targetUrl": null,
                                "naUrl": null,
                                "desc1": null,
                                "desc2": null
                            }
                        ],
                        "extraPictures": []
                    },
                    "pause": false,
                    "status": 2,
                    "refusereason": null
                }
    		]
    	},
    	"header": {
    		"oprs": 1,
    		"failures": [],
    		"succ": 1,
    		"oprtime": 0,
    		"desc": "success",
    		"status": 0
    	}
    }

    更新闪投创意

    接口描述

    更新闪投创意信息。

    接口URL

    http://sem.baidubce.com/v1/feed/cloud/DpaCreativeFeedService/updateCreativeFeed

    请求参数说明

    字段名称 类型 描述
    creativeFeedTypes array(object) 闪投创意对象数组,请参考其定义。

    注意:请求参数中的创意ID为必填信息。

    响应参数说明

    响应为闪投创意对象数组,请参考其定义。

    请求示例

    POST /v1/feed/cloud/DpaCreativeFeedService/updateCreativeFeed HTTP/1.1
    Accept-encoding: 'gzip, deflate'
    Host: sem.baidubce.com
    ContentType: application/json
    Authorization: bce-auth-v1/b406c344bb764e00aff7d3b80d9bd87a/2019-06-05T07:34:31Z/1800/host/bb0f820e4499b8b44548388b37a7afed970e965a7a59f79ebac47a99c315a97b(签名有效时间为30分钟,需要替换成自己生成的签名)
    Accept: '*/*'
    {
    	"header": {
    		"opUsername": "example",
    		"tgUsername": "example",
    		"bceUser": "example",
    		"opPassword": "example",
    		"tgPassword": "example"
    	},
    	"body": {
    		"creativeFeedTypes":[
                {
                    "template": {
                        "title": "#{U__CITY}用户都在看",
                        "targetUrl": "http://www.china3561.com",
                        "monitorUrl": "",
                        "userPortrait": "http://fc-feed.cdn.bcebos.com/0/pic/befa1b8e1015787136eb48d55638a24d.jpg",
                        "naUrl": "",
                        "brand": "search",
                        "pictures": [
                            {
                                "url": "${image}",
                                "targetUrl": null,
                                "naUrl": null,
                                "desc1": null,
                                "desc2": null
                            }
                        ],
                        "extraPictures": []
                    },
                    "materialstyle": 501,
                    "adgroupFeedId": 3739952204,
                    "creativeFeedName": "单品单图",
                    "creativeFeedId": 111150791786,
                    "pause": false
                }
            ]
    	}
    }

    响应示例

    {
    	"body": {
    		"data":  [
                {
                    "creativeFeedId": 111150791786,
                    "campaignFeedId": null,
                    "adgroupFeedId": 3739952204,
                    "materialstyle": 502,
                    "creativeFeedName": "单品单图",
                    "material": "{\"title\":\"上海用户都在看\",\"brand\":\"search\",\"url\":\"http://www.china3561.com\",\"userPortrait\":\"http://fc-feed.cdn.bcebos.com/0/pic/befa1b8e1015787136eb48d55638a24d.jpg\",\"pictures\":[{\"image\":\"http://fc-feed.cdn.bcebos.com/0/pic/8562166e1a1a9cff2a5f6d52940c4068.png\"},{\"image\":\"http://fc-feed.cdn.bcebos.com/0/pic/2ce3baae695113387fb56cf22924b7d3.png\"},{\"image\":\"http://fc-feed.cdn.bcebos.com/0/pic/08670eea4af547a8bffbb3b981e69989.png\"}],\"monitorUrl\":\"\",\"sku\":[],\"template\":\"{\\\"content\\\":{\\\"fields\\\":[{\\\"image\\\":{\\\"key\\\":\\\"imgUrl_1\\\",\\\"value\\\":\\\"http://fc-feed.cdn.bcebos.com/0/pic/8562166e1a1a9cff2a5f6d52940c4068.png\\\"}},{\\\"image\\\":{\\\"key\\\":\\\"imgUrl_3\\\",\\\"value\\\":\\\"http://fc-feed.cdn.bcebos.com/0/pic/08670eea4af547a8bffbb3b981e69989.png\\\"}},{\\\"text\\\":{\\\"key\\\":\\\"title\\\",\\\"value\\\":\\\"#{U__CITY}用户都在看\\\"}},{\\\"image\\\":{\\\"key\\\":\\\"userPortrait\\\",\\\"value\\\":\\\"http://fc-feed.cdn.bcebos.com/0/pic/befa1b8e1015787136eb48d55638a24d.jpg\\\"}},{\\\"image\\\":{\\\"key\\\":\\\"imgUrl_2\\\",\\\"value\\\":\\\"http://fc-feed.cdn.bcebos.com/0/pic/2ce3baae695113387fb56cf22924b7d3.png\\\"}},{\\\"url\\\":{\\\"key\\\":\\\"targetUrl\\\",\\\"value\\\":\\\"http://www.china3561.com\\\"}},{\\\"url\\\":{\\\"key\\\":\\\"naUrl\\\",\\\"value\\\":\\\"\\\"}},{\\\"url\\\":{\\\"key\\\":\\\"monitorUrl\\\",\\\"value\\\":\\\"\\\"}},{\\\"text\\\":{\\\"key\\\":\\\"brand\\\",\\\"value\\\":\\\"search\\\"}}],\\\"product_count\\\":0,\\\"huitu_id\\\":0,\\\"image_type\\\":0},\\\"requirement\\\":{\\\"fields\\\":[]}}\",\"pictureWidth\":370,\"pictureHeight\":245}",
                    "template": {
                        "title": "#{U__CITY}用户都在看",
                        "targetUrl": "http://www.china3561.com",
                        "monitorUrl": "",
                        "userPortrait": "http://fc-feed.cdn.bcebos.com/0/pic/befa1b8e1015787136eb48d55638a24d.jpg",
                        "naUrl": "",
                        "brand": "search",
                        "pictures": [
                            {
                                "url": "${image}",
                                "targetUrl": null,
                                "naUrl": null,
                                "desc1": null,
                                "desc2": null
                            }
                        ],
                        "extraPictures": []
                    },
                    "pause": false,
                    "status": 2,
                    "refusereason": null
                }
            ]
    	},
    	"header": {
    		"oprs": 1,
    		"failures": [],
    		"succ": 1,
    		"oprtime": 0,
    		"desc": "success",
    		"status": 0
    	}
    }

    删除闪投创意

    接口描述

    删除闪投创意。

    注意:删除后不可恢复,请谨慎操作。

    接口URL

    http://sem.baidubce.com/v1/feed/cloud/DpaCreativeFeedService/deleteCreativeFeed

    请求参数说明

    字段名称 类型 描述
    creativeFeedIds array(number) 需要删除的创意ID。一次最多删除100个创意。

    响应参数说明

    响应中succ字段代表删除成功的数量,failures中为删除失败的创意信息

    请求示例

    POST /v1/feed/cloud/DpaCreativeFeedService/deleteCreativeFeed HTTP/1.1
    Accept-encoding: 'gzip, deflate'
    Host: sem.baidubce.com
    ContentType: application/json
    Authorization: bce-auth-v1/b406c344bb764e00aff7d3b80d9bd87a/2019-06-05T07:34:31Z/1800/host/bb0f820e4499b8b44548388b37a7afed970e965a7a59f79ebac47a99c315a97b(签名有效时间为30分钟,需要替换成自己生成的签名)
    Accept: '*/*'
    {
    	"header": {
    		"opUsername": "example",
    		"tgUsername": "example",
    		"bceUser": "example",
    		"opPassword": "example",
    		"tgPassword": "example"
    	},
    	"body": {
            "creativeFeedIds" :[
                111150791786,
                123456
            ]
        }
    }

    响应示例

    {
    	"body": {
    		"data": null
    	},
    	"header": {
    		"oprs": 2,
    		"failures": [
                {
                    "code": 901700020,
                    "message": "创意未找到.",
                    "position": "_params.creativeFeedTypes[1]"
                }
            ],
    		"succ": 1,
    		"oprtime": 0,
    		"desc": "success",
    		"status": 0
    	}
    }

    获取闪投创意预览

    接口描述

    获取闪投创意预览。

    接口URL

    http://sem.baidubce.com/v1/feed/cloud/DpaCreativeFeedService/getCreativePreview

    请求参数说明

    字段名称 类型 描述
    creativeFeedTypes array(object) 闪投创意对象数组,请参考其定义。

    响应参数说明

    响应为闪投创意对象数组,请参考其定义。

    创意预览信息参考返回中的material字段,请参考闪投物料内容对象定义

    请求示例

    POST /v1/feed/cloud/DpaCreativeFeedService/getCreativePreview HTTP/1.1
    Accept-encoding: 'gzip, deflate'
    Host: sem.baidubce.com
    ContentType: application/json
    Authorization: bce-auth-v1/b406c344bb764e00aff7d3b80d9bd87a/2019-06-05T07:34:31Z/1800/host/bb0f820e4499b8b44548388b37a7afed970e965a7a59f79ebac47a99c315a97b(签名有效时间为30分钟,需要替换成自己生成的签名)
    Accept: '*/*'
    {
    	"header": {
    		"opUsername": "example",
    		"tgUsername": "example",
    		"bceUser": "example",
    		"opPassword": "example",
    		"tgPassword": "example"
    	},
    	"body": {
            "creativeFeedTypes":[
                {
                    "campaignFeedId": null,
                    "template": {
                        "title": "#{U__CITY}用户都在看",
                        "targetUrl": "http://www.china3561.com",
                        "monitorUrl": "",
                        "userPortrait": "http://fc-feed.cdn.bcebos.com/0/pic/befa1b8e1015787136eb48d55638a24d.jpg",
                        "naUrl": "",
                        "brand": "search",
                        "pictures": [
                            {
                                "url": "${image}",
                                "targetUrl": null,
                                "naUrl": null,
                                "desc1": null,
                                "desc2": null
                            }
                        ],
                        "extraPictures": []
                    },
                    "materialstyle": 501,
                    "adgroupFeedId": 3739952204,
                    "creativeFeedName": "单品单图",
                    "refusereason": null,
                    "creativeFeedId": null,
                    "pause": false,
                    "status": 0
                }
            ]
        }
    }

    响应示例

    {
    	"body": {
            "data": [
                {
                    "creativeFeedId": null,
                    "campaignFeedId": null,
                    "adgroupFeedId": 3739952204,
                    "materialstyle": 501,
                    "creativeFeedName": "单品单图",
                    "material": "{\"title\":\"上海用户都在看\",\"brand\":\"search\",\"url\":\"http://www.china3561.com\",\"userPortrait\":\"http://fc-feed.cdn.bcebos.com/0/pic/befa1b8e1015787136eb48d55638a24d.jpg\",\"pictures\":[{\"image\":\"http://fc-feed.cdn.bcebos.com/0/pic/b0ced943d347a8d9c74148ab4662b29a.jpg\",\"width\":0,\"height\":0,\"pid\":0}],\"sku\":[],\"template\":\"{\\\"content\\\":{\\\"fields\\\":[{\\\"image\\\":{\\\"key\\\":\\\"imgUrl\\\",\\\"value\\\":\\\"${attributes.pcImage_1}\\\"}},{\\\"text\\\":{\\\"key\\\":\\\"title\\\",\\\"value\\\":\\\"#{U__CITY}用户都在看\\\"}},{\\\"image\\\":{\\\"key\\\":\\\"userPortrait\\\",\\\"value\\\":\\\"http://fc-feed.cdn.bcebos.com/0/pic/befa1b8e1015787136eb48d55638a24d.jpg\\\"}},{\\\"url\\\":{\\\"key\\\":\\\"targetUrl\\\",\\\"value\\\":\\\"http://www.china3561.com\\\"}},{\\\"url\\\":{\\\"key\\\":\\\"naUrl\\\",\\\"value\\\":\\\"\\\"}},{\\\"url\\\":{\\\"key\\\":\\\"monitorUrl\\\",\\\"value\\\":\\\"\\\"}},{\\\"text\\\":{\\\"key\\\":\\\"brand\\\",\\\"value\\\":\\\"search\\\"}}],\\\"product_count\\\":0,\\\"huitu_id\\\":0,\\\"image_type\\\":0},\\\"requirement\\\":{\\\"fields\\\":[{\\\"image\\\":{\\\"key\\\":\\\"attributes.pcImage_1\\\",\\\"min_aspect_ratio\\\":0.0,\\\"min_pixels\\\":9600}}]}}\",\"monitorUrl\":\"\",\"naUrl\":\"\",\"duration\":0,\"videoid\":0}",
                    "template": {
                        "title": "#{U__CITY}用户都在看",
                        "targetUrl": "http://www.china3561.com",
                        "monitorUrl": "",
                        "userPortrait": "http://fc-feed.cdn.bcebos.com/0/pic/befa1b8e1015787136eb48d55638a24d.jpg",
                        "naUrl": "",
                        "brand": "search",
                        "pictures": [
                            {
                                "url": "${image}",
                                "targetUrl": null,
                                "naUrl": null,
                                "desc1": null,
                                "desc2": null
                            }
                        ],
                        "extraPictures": []
                    },
                    "pause": false,
                    "status": 0,
                    "refusereason": null
                }
            ]
    	},
    	"header": {
    		"oprs": 1,
    		"failures": [],
    		"succ": 1,
    		"oprtime": 0,
    		"desc": "success",
    		"status": 0
    	}
    }

    获取闪投用户、监控通配符

    接口描述

    获取用户、监控通配符。

    接口URL

    http://sem.baidubce.com/v1/feed/cloud/DpaCreativeFeedService/getSymbolFields

    请求参数说明

    空请求体

    响应参数说明

    响应中"user"部分为用户通配符,"monitor"部分为监控通配符。字段为闪投用户、监控通配符对象数组,请参考其定义。

    请求示例

    POST /v1/feed/cloud/DpaCreativeFeedService/getSymbolFields HTTP/1.1
    Accept-encoding: 'gzip, deflate'
    Host: sem.baidubce.com
    ContentType: application/json
    Authorization: bce-auth-v1/b406c344bb764e00aff7d3b80d9bd87a/2019-06-05T07:34:31Z/1800/host/bb0f820e4499b8b44548388b37a7afed970e965a7a59f79ebac47a99c315a97b(签名有效时间为30分钟,需要替换成自己生成的签名)
    Accept: '*/*'
    {
    	"header": {
    		"opUsername": "example",
    		"tgUsername": "example",
    		"bceUser": "example",
    		"opPassword": "example",
    		"tgPassword": "example"
    	},
    	"body": {
        }
    }

    响应示例

    {
    	"body": {
            "data": [
                {
                    "user": [
                        {
                            "value": "U__CITY",
                            "label": "城市",
                            "dimension": "空间维度",
                            "description": "**标题:**奥迪A6大降价,仅限#{U__CITY}**北京用户看到的广告:**奥迪A6大降价,仅限北京!
    **上海用户看到的广告:**奥迪A6大降价,仅限上海!
    **无法识别位置的人看到的广告:**奥迪A6大降价,仅限本地!"
                        }
                    ],
                    "monitor": [
                        {
                            "value": "IDEA_ID",
                            "label": "创意ID",
                            "dimension": "监控维度",
                            "description": "推广创意id"
                        }
                    ]
                }
            ]
    	},
    	"header": {
    		"oprs": 1,
    		"failures": [],
    		"succ": 1,
    		"oprtime": 0,
    		"desc": "success",
    		"status": 0
    	}
    }

    闪投创意样式列表

    以下列出所有支持的创意样式,以及使用限制、所支持的功能。

    支持的流量:该样式支持投放的流量。只有在创意所属单元的投放流量中选择了“优选流量”或至少包含一个支持的流量时,才可使用该样式。部分样式在某些流量中只支持投放到特定版位(如标注“仅列表页”),如果创意所属的单元包含该流量,但不包含支持投放的版位时,也可创建该样式的创意,但创意状态为“无效”(请参考闪投创意对象中status字段的说明);修改单元的投放版位,单元下的创意将自动重置无效状态。

    标题、品牌名、副标题:相应字段的最大长度限制,单位为字符。1个汉字占2个字符。

    创意图片:该样式所需图片的数量、图片文件大小限制、图片尺寸(单位为像素)。

    样式名称 样式ID 推广对象 支持的流量 标题 品牌名 副标题 创意图片 视频 deeplink 点击监测 曝光监测
    单品单图 501 网站链接 百度信息流
    百青藤
    36 8 不支持 1张图片
    单张不超过200KB
    370×245
    不支持 可选 可选 可选
    单品三图 502 网站链接 百度信息流
    百青藤
    60 8 不支持 3张图片
    单张不超过200KB
    370×245
    不支持 可选 可选 可选
    三品三图 503 网站链接 百度信息流
    百青藤
    60 8 不支持 3张图片
    单张不超过200KB
    370×245
    不支持 可选 可选
    IOS APP下载单品三图 504 应用下载(IOS) 百度信息流
    百青藤
    60 8 24 3张图片
    单张不超过200KB
    370×245
    不支持 可选 可选 可选
    IOS APP下载三品三图 505 应用下载(IOS) 百度信息流
    百青藤
    60 8 24 3张图片
    单张不超过200KB
    370×245
    不支持 可选 可选 可选
    Android APP下载单品三图 506 应用下载(Android) 百度信息流
    百青藤
    60 8 24 3张图片
    单张不超过200KB
    370×245
    不支持 可选 可选 可选
    Android APP下载三品三图 507 应用下载(Android) 百度信息流
    百青藤
    60 8 24 3张图片
    单张不超过200KB
    370×245
    不支持 可选 可选 可选
    单品大图 508 网站链接 百度信息流
    贴吧信息流
    百青藤
    60 8 不支持 1张图片
    单张不超过500KB
    1140×640
    不支持 可选 可选 可选
    IOS APP下载单品单图 509 应用下载(IOS) 百度信息流(仅列表页)
    百青藤
    36 8 24 1张图片
    单张不超过200KB
    370×245
    不支持 可选 可选 可选
    IOS APP下载单品大图 510 应用下载(IOS) 百度信息流
    贴吧信息流
    百青藤
    60 8 24 1张图片
    单张不超过500KB
    1140×640
    不支持 可选 可选 可选
    Android APP下载单品单图 511 应用下载(Android) 百度信息流(仅列表页)
    百青藤
    36 8 24 1张图片
    单张不超过200KB
    370×245
    不支持 可选 可选 可选
    Android APP下载单品大图 512 应用下载(Android) 百度信息流
    贴吧信息流
    百青藤
    60 8 24 1张图片
    单张不超过500KB
    1140×640
    不支持 可选 可选 可选
    贴吧_三品三图II 513 网站链接 单选贴吧信息流 60 8 不支持 3张图片
    单张不超过200KB
    220×220
    不支持 可选 可选 可选
    贴吧_单品三图II 514 网站链接 单选贴吧信息流 60 8 不支持 3张图片
    单张不超过200KB
    220×220
    不支持 可选 可选 可选
    贴吧_APP下载三品三图II 515 应用下载 单选贴吧信息流 60 8 24 3张图片
    单张不超过200KB
    220×220
    不支持 可选 可选 可选
    贴吧_APP下载单品三图II 516 应用下载 单选贴吧信息流 60 8 24 3张图片
    单张不超过200KB
    220×220
    不支持 可选 可选 可选
    橱窗样式 517 网站链接 百度信息流 36 8 不支持 4张图片
    单张不超过200KB
    370×245
    不支持 可选 可选 可选
    视频大图样式 518 网站链接 百度信息流
    贴吧信息流(仅列表页)
    百青藤
    60 8 不支持 1张图片
    单张不超过500KB
    1140×640
    视频大小不超过200MB,尺寸1280×720
    视频默认帧图片不超过500KB,尺寸1140×640
    可选 可选 可选
    视频大图下载样式 519 应用下载 百度信息流(仅列表页)
    贴吧信息流(仅列表页)
    百青藤
    60 8 24 1张图片
    单张不超过500KB
    1140×640
    视频大小不超过200MB,尺寸1280×720
    视频默认帧图片不超过500KB,尺寸1140×640
    可选 可选 可选
    竖版视频 521 网站链接 百度信息流(仅列表页)
    百青藤
    60 8 不支持 1张图片
    单张不超过500KB
    640×1140
    视频大小不超过200MB,尺寸720×1280
    视频默认帧图片不超过500KB,尺寸640×1140
    可选 可选 可选
    竖版视频下载 523 应用下载 百度信息流(仅列表页)
    百青藤
    60 8 24 1张图片
    单张不超过500KB
    640×1140
    视频大小不超过200MB,尺寸720×1280
    视频默认帧图片不超过500KB,尺寸640×1140
    可选 可选 可选
    开屏样式 524 网站链接 百青藤 不支持 不支持 不支持 1张图片
    单张不超过500KB
    640×960
    1080×1920
    480×800
    768×1024
    不支持 可选 可选 可选
    开屏下载 525 应用下载 百青藤 不支持 不支持 不支持 1张图片
    单张不超过500KB
    640×960
    1080×1920
    480×800
    768×1024
    不支持 可选 可选 可选
    上一篇
    创意物料说明
    下一篇
    商品组模块