创意模块接口

创意对象

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

字段名称 类型 描述
creativeFeedId number 创意ID
adgroupFeedId number 所属推广单元ID
creativeFeedName string 创意名称
materialstyle number 创意样式ID,取值请参考创意样式列表
pause boolean 是否暂停推广
status number 创意状态。
此字段仅用于查询,新增/修改创意时参数中传此字段无效。
取值范围如下:
0:有效
1:暂停推广
2:审核中
3:审核未通过
4:无效(因与所属推广单元所选的投放版位不匹配而无法投放,推广单元修改投放版位后将自动重置此状态。请参考创意样式列表的说明。)
material string 物料内容。
物料内容为string形式的json对象,包含该创意所需的标题、图片、落地页URL等展示物料,以及监测URL等功能性物料。各种创意样式所需的物料字段有所不同,请参考创意物料说明创意样式列表
refusereason string 审核未通过的原因(审核拒绝理由)。原因可能有多个,该字段为string形式的json数组,数组元素为string类型,每个元素是一个原因。
示例:
"[\"原因A\",\"原因B\"]"
ideaType number 返回的创意类型,取值0代表自定义创意 1代表程序化创意

查询创意

接口描述

查询创意信息

接口URL

http://sem.baidubce.com/v1/feed/cloud/CreativeFeedService/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/CreativeFeedService/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": {
        "idType": 3,
        "ids": [
            "54320498743"
        ],
        "creativeFeedFields": [
            "creativeFeedId",
            "creativeFeedName",
            "materialstyle",
            "material"
            "ideaType":0
        ]
    }
}

响应示例

{
    "body": {
        "data": [
            {
                "creativeFeedId": 54320498743,
                "creativeFeedName": "Creative1",
                "materialstyle": 101,
                "material": "{\"title\":\"使用信息流推广,获得好效果!\",\"brand\":\"百度\",\"url\":\"https://www.baidu.com/\",\"userPortrait\":\"http://example.com/example.jpg\",\"pictures\":[{\"image\":\"http://example.com/example.jpg\"}]}"
            }
        ]
    },
    "header": {
        "oprs": 1,
        "failures": [],
        "succ": 1,
        "oprtime": 0,
        "desc": "success",
        "status": 0
    }
}

新增创意

接口描述

新增创意

接口URL

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

请求参数说明

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

响应参数说明

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

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

请求示例

POST /v1/feed/cloud/CreativeFeedService/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": 3739688195,
                "creativeFeedName": "Creative1",
                "materialstyle": 101,
                "material": "{\"title\":\"使用信息流推广,获得好效果!\",\"brand\":\"百度\",\"url\":\"https://www.baidu.com/\",\"userPortrait\":\"http://example.com/example.jpg\",\"pictures\":[{\"image\":\"http://example.com/example.jpg\"}]}"
            }
        ]
    }
}

响应示例

{
    "body": {
        "data": [
            {
                "creativeFeedId": 54320498743,
                "adgroupFeedId": 3739688195,
                "creativeFeedName": "Creative1",
                "materialstyle": 101,
                "material": "{\"title\":\"使用信息流推广,获得好效果!\",\"brand\":\"百度\",\"url\":\"https://www.baidu.com/\",\"userPortrait\":\"http://example.com/example.jpg\",\"pictures\":[{\"image\":\"http://example.com/example.jpg\"}]}"
            }
        ]
    },
    "header": {
        "oprs": 1,
        "failures": [],
        "succ": 1,
        "oprtime": 0,
        "desc": "success",
        "status": 0
    }
}

更新创意

接口描述

更新创意信息

接口URL

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

请求参数说明

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

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

响应参数说明

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

请求示例

POST /v1/feed/cloud/CreativeFeedService/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": [
            {
                "creativeFeedId": 54320498743,
                "adgroupFeedId": 3739688195,
                "creativeFeedName": "Creative1",
                "materialstyle": 101,
                "material": "{\"title\":\"使用信息流推广,获得好效果!\",\"brand\":\"百度\",\"url\":\"https://www.baidu.com/\",\"userPortrait\":\"http://example.com/example.jpg\",\"pictures\":[{\"image\":\"http://example.com/example.jpg\"}]}"
            }
        ]
    }
}

响应示例

{
    "body": {
        "data": [
            {
                "creativeFeedId": 54320498743,
                "adgroupFeedId": 3739688195,
                "creativeFeedName": "Creative1",
                "materialstyle": 101,
                "material": "{\"title\":\"使用信息流推广,获得好效果!\",\"brand\":\"百度\",\"url\":\"https://www.baidu.com/\",\"userPortrait\":\"http://example.com/example.jpg\",\"pictures\":[{\"image\":\"http://example.com/example.jpg\"}]}"
            }
        ]
    },
    "header": {
        "oprs": 1,
        "failures": [],
        "succ": 1,
        "oprtime": 0,
        "desc": "success",
        "status": 0
    }
}

删除创意

接口描述

删除创意。

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

接口URL

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

请求参数说明

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

响应参数说明

响应为创意对象数组,但是仅包含被删除的创意ID信息。

请求示例

POST /v1/feed/cloud/CreativeFeedService/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": [
            54320498743,
            54320498744,
            54320498745
        ]
    }
}

响应示例

{
    "body": {
        "data": [
            {
                "creativeFeedId": 54320498743
            },
            {
                "creativeFeedId": 54320498744
            },
            {
                "creativeFeedId": 54320498745
            }
        ]
    },
    "header": {
        "oprs": 1,
        "failures": [],
        "succ": 1,
        "oprtime": 0,
        "desc": "success",
        "status": 0
    }
}

根据物料内容生成实况预览地址

接口描述

根据指定的物料内容生成实况预览URL。物料内容即使还没有在创意中提交,也可利用此接口生成预览地址。

接口URL

http://sem.baidubce.com/v1/feed/cloud/CreativeFeedService/getTempCreativeFeedPreviewUrl

请求参数说明

字段名称 类型 描述
previewFeedTypes array(Object) 预览对象数组(定义见下),目前只支持1个,即数组长度为1。

预览对象包含了预览所需的信息:

字段名称 类型 描述
materialstyle number 预览的样式ID
creativeFeedName string 预览物料的创意名称(无实际作用,调用时可任意填写)
previewSource string 预览来源,请填写"other"
material string 预览物料的内容,与创意对象的material字段定义相同

响应参数说明

字段名称 类型 描述
qr string 预览二维码URL地址

请求示例

POST /v1/feed/cloud/CreativeFeedService/getTempCreativeFeedPreviewUrl 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":{
        "previewFeedTypes":[
            {
                "materialstyle":101,
                "creativeFeedName":"creative_20126046113",
                "previewSource":"other",
                "material":"{\"title\":\"使用信息流推广,获得好效果!\",\"brand\":\"百度\",\"url\":\"https://www.baidu.com/\",\"userPortrait\":\"http://example.com/example.jpg\",\"pictures\":[{\"image\":\"http://example.com/example.jpg\"}]}"
            }
        ]
    }
}

响应示例

{
    "header":{
        "oprs": 1,
        "failures": [],
        "succ": 1,
        "oprtime": 0,
        "desc": "success",
        "status": 0
    },
    "body":{
        "data":[
            {
                "qr": "http://bj.bcebos.com/fc-feed/preview/img/926000f96eb2bf7c.png"
            }
        ]
    }
}

生成创意的实况预览地址

接口描述

根据创意ID生成实况预览URL。

接口URL

http://sem.baidubce.com/v1/feed/cloud/CreativeFeedService/getCreativeFeedPreviewUrlWithPreviewSource

请求参数说明

字段名称 类型 描述
previewFeedRequest array(Object) 预览对象数组(定义见下),目前只支持1个,即数组长度为1。

预览对象包含了预览所需的信息:

字段名称 类型 描述
creativeFeedId Integer 创意ID
previewSource String 预览来源,请填写"other"

响应参数说明

字段名称 类型 描述
qr string 预览二维码URL地址

请求示例

POST /v1/feed/cloud/CreativeFeedService/getCreativeFeedPreviewUrlWithPreviewSource 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":{
        "previewFeedRequest":{
            "creativeFeedId": 54320498743,
            "previewSource": "other",
        }
    }
}

响应示例

{
    "header":{
        "oprs": 1,
        "failures": [],
        "succ": 1,
        "oprtime": 0,
        "desc": "success",
        "status": 0
    },
    "body":{
        "data":[
            {
                "qr": "http://bj.bcebos.com/fc-feed/preview/img/926000f96eb2bf7c.png"
            }
        ]
    }
}

创意物料说明

创意物料即创意的material字段,是创意在展现时所需的信息。各个物料在material字段的json对象字段中提供。

以下是全部物料字段的说明。各个样式实际所支持的字段,以及对字段值的限制各有不同,请参考创意样式列表中的说明。

功能 字段 类型 说明
基础物料 title string 标题
brand string 品牌名
subtitle string 副标题
userPortrait string 头像图片URL。所有样式必填头像图片URL。头像图片统一要求尺寸为120×120,大小不超过1MB。
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"}]
pictureWidth number 创意图片宽度(单位:像素)。支持多种图片尺寸的样式需要填此字段。
pictureHeight number 创意图片高度(单位:像素)。支持多种图片尺寸的样式需要填此字段。
url string 落地页URL。推广对象为网站链接的必填此字段,推广对象为APP下载的创意不支持此字段。
视频 videoid number 视频ID。仅视频样式支持。
视频ID可以通过相关接口,或信息流推广Web端的“视频库”中获取。
poster string 视频默认帧图片。仅视频样式支持。
deeplink naUrl string APP调起URL。统一要求url长度不超过1024个字符。
填写APP调起URL后,创意被点击时将优先调起APP,如果调起失败则会使用普通落地页。
监测URL monitorUrl string 点击监测URL。统一要求url长度不超过1024个字符。
exposureUrl string 曝光监测URL。统一要求url长度不超过1024个字符。
注意:仅推广单元中选择的优化目标为曝光或转化时支持曝光监测。
elements object 程序化创意返回字段, 表示程序化创意元素信息。
其中有titles表示标题元素集合。
singlePic表示单图元素集合。
largePic表示大图元素集合。
package3Pic表示三图元素集合,三张图算为一个整体,并且用空格分开。
示例如下:
"elements": {"titles": ["程序化1121","程序化1122火锅店装修完了,下一步就是选火锅桌了"],"singlePic": ["http://fc-feed.cdn.bcebos.com/0/pic/1f9461970e9c7537cf271c66180a8872.jpg"],"largePic": ["http://fc-feed.cdn.bcebos.com/0/pic/169d7df05bbece8a71aa007123a09ae3.jpg"],"package3Pic": ["http://fc-feed.cdn.bcebos.com/0/pic/0922504eedacc8f3f88ce7e848d91862.png http://bj.bcebos.com/fc-feed/0/pic/78e1b01b14852550de3ec5080276a37b.jpg http://bj.bcebos.com/fc-feed/0/pic/8c7612b3cce925fa96cafb1c7142ad4c.jpg"]}

创意样式列表

以下列出所有支持的创意样式,以及使用限制、所支持的功能。现在闪投API不支持闪投程序化创意

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

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

创意图片:该样式所需图片的数量、图片文件大小限制、图片尺寸(单位为像素)。部分样式支持多种图片尺寸,每个创意可选用其中一种。标注“(仅联盟流量)”的尺寸仅支持投放到百度联盟媒体,只有在创意所属单元的投放流量中选择了“优选流量”或包含百度联盟媒体流量时才可使用该尺寸。

样式名称 样式ID 推广对象 支持的流量 标题 品牌名 副标题 创意图片 视频 deeplink 点击监测 曝光监测
单图链接 101 网站链接 百度信息流
百度联盟媒体
好看视频
36 8 不支持 1张图片
单张不超过200KB
370×245
960×640(仅联盟流量)
600×500(仅联盟流量)
800×120(仅联盟流量)
不支持 可选 可选 可选
单图下载 105 APP下载 百度信息流(仅列表页)
百度联盟媒体
36 8 24 1张图片
单张不超过200KB
370×245
960×640(仅联盟流量)
600×500(仅联盟流量)
800×120(仅联盟流量)
不支持 可选 可选 可选
三图链接(1) 102 网站链接 百度信息流
百度联盟媒体
60 8 不支持 3张图片
单张不超过200KB
370×245
960×640(仅联盟流量)
600×300(仅联盟流量)
220×220(仅联盟流量)
不支持 可选 可选 可选
三图下载(1) 104 APP下载 百度信息流
百度联盟媒体
60 8 24 3张图片
单张不超过200KB
370×245
960×640(仅联盟流量)
600×300(仅联盟流量)
220×220(仅联盟流量)
不支持 可选 可选 可选
三图链接(2) 221 网站链接 贴吧信息流 60 8 不支持 3张图片
单张不超过200KB
220×220
不支持 可选 可选 可选
三图下载(2) 223 APP下载 贴吧信息流 60 8 24 3张图片
单张不超过200KB
220×220
不支持 可选 可选 可选
大图链接 107 网站链接 百度信息流
贴吧信息流
百度联盟媒体
好看视频
60 8 不支持 1张图片
单张不超过500KB
1140×640
600×300(仅联盟流量)
1280×720(仅联盟流量)
960×640(仅联盟流量)
不支持 可选 可选 可选
大图下载 106 APP下载 百度信息流
贴吧信息流
百度联盟媒体
好看视频
60 8 24 1张图片
单张不超过500KB
1140×640
600×300(仅联盟流量)
1280×720(仅联盟流量)
960×640(仅联盟流量)
不支持 可选 可选 可选
小图视频链接 103 网站链接 百度信息流
百度联盟媒体
36 8 不支持 1张图片
单张不超过200KB
370×245
视频大小不超过200MB,尺寸1280×720
视频默认帧图片不超过500KB,尺寸750×420
不支持 可选 可选
大图视频链接 108 网站链接 百度信息流
贴吧信息流(仅列表页)
百度联盟媒体
好看视频
60 8 不支持 1张图片
单张不超过500KB
1140×640
640×480(仅联盟流量)
640×360(仅联盟流量)
视频大小不超过200MB,尺寸1280×720
视频默认帧图片不超过500KB,尺寸1140×640
可选 可选 可选
大图视频下载 109 APP下载 百度信息流(仅列表页)
贴吧信息流(仅列表页)
好看视频
60 8 24 1张图片
单张不超过500KB
1140×640
视频大小不超过200MB,尺寸1280×720
视频默认帧图片不超过500KB,尺寸1140×640
可选 可选 可选
竖版视频链接 111 网站链接 百度信息流(仅列表页) 60 8 不支持 1张图片
单张不超过500KB
640×1140
视频大小不超过200MB,尺寸720×1280
视频默认帧图片不超过500KB,尺寸640×1140
可选 可选 可选
竖版视频下载 112 APP下载 百度信息流(仅列表页) 60 8 不支持 1张图片
单张不超过500KB
640×1140
视频大小不超过200MB,尺寸720×1280
视频默认帧图片不超过500KB,尺寸640×1140
可选 可选 可选
开屏链接 401 网站链接 百度联盟媒体 不支持 不支持 不支持 1张图片
单张不超过500KB
640×960
1080×1920
480×800
768×1024
不支持 可选 可选 可选
开屏下载 403 APP下载 百度联盟媒体 不支持 不支持 不支持 1张图片
单张不超过500KB
640×960
1080×1920
480×800
768×1024
不支持 可选 可选 可选
横幅链接 402 网站链接 百度联盟媒体 不支持 不支持 不支持 1张图片
单张不超过200KB
800×120
600×500
580×90
350×350
不支持 可选 可选 可选
横幅下载 404 APP下载 百度联盟媒体 不支持 不支持 不支持 1张图片
单张不超过200KB
800×120
600×500
580×90
350×350
不支持 可选 可选 可选

闪投创意模块

闪投创意对象

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

字段名称 类型 描述
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 监控链接
仅在选取APP下载类型闪投计划时可用(IOS或Andriod),支持选填.可使用商品库字段,如${monitorUrl}
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,仅橱窗样式可用

闪投多尺寸图片对象

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

字段名称 类型 描述
pictures array(object) 图片列表,示例:
[{"image":"http://www.sample1.jpg"},{"image":"http://www.sample2.jpg"},{"image":"http://www.sample3.jpg"}]
width string 多尺寸图片宽度
height string 多尺寸图片调度

闪投预览物料内容对象

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

字段名称 类型 描述
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字段说明。

响应参数说明

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

请求示例

``` javascript
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
960×640(仅联盟流量)
600×500(仅联盟流量)
800×120(仅联盟流量)
不支持 可选 可选 可选
单品三图 502 网站链接 百度信息流
贴吧信息流
百度联盟媒体
60 8 不支持 3张图片
单张不超过200KB
370×245
960×640(仅联盟流量)
600×300(仅联盟流量)
220×220(仅联盟流量)
不支持 可选 可选 可选
三品三图 503 网站链接 百度信息流
贴吧信息流
百度联盟媒体
60 8 不支持 3张图片
单张不超过200KB
370×245
960×640(仅联盟流量)
600×300(仅联盟流量)
220×220(仅联盟流量)
可选 可选 可选
IOS APP下载单品三图 504 APP下载(IOS) 百度信息流
贴吧信息流
百度联盟媒体
60 8 24 3张图片
单张不超过200KB
370×245
960×640(仅联盟流量)
600×300(仅联盟流量)
220×220(仅联盟流量)
不支持 可选 可选 可选
IOS APP下载三品三图 505 APP下载(IOS) 百度信息流
贴吧信息流
百度联盟媒体
60 8 24 3张图片
单张不超过200KB
370×245
960×640(仅联盟流量)
600×300(仅联盟流量)
220×220(仅联盟流量)
不支持 可选 可选 可选
Android APP下载单品三图 506 APP下载(Android) 百度信息流
贴吧信息流
百度联盟媒体
60 8 24 3张图片
单张不超过200KB
370×245
960×640(仅联盟流量)
600×300(仅联盟流量)
220×220(仅联盟流量)
不支持 可选 可选 可选
Android APP下载三品三图 507 APP下载(Android) 百度信息流
贴吧信息流
百度联盟媒体
60 8 24 3张图片
单张不超过200KB
370×245
960×640(仅联盟流量)
600×300(仅联盟流量)
220×220(仅联盟流量)
不支持 可选 可选 可选
单品大图 508 网站链接 百度信息流
贴吧信息流
百度联盟媒体
60 8 不支持 1张图片
单张不超过500KB
1140×640
600×300(仅联盟流量)
1280×720(仅联盟流量)
960×640(仅联盟流量)
不支持 可选 可选 可选
IOS APP下载单品单图 509 APP下载(IOS) 百度信息流
贴吧信息流
百度联盟媒体
36 8 24 1张图片
单张不超过200KB
370×245
960×640(仅联盟流量)
600×500(仅联盟流量)
800×120(仅联盟流量)
不支持 可选 可选 可选
IOS APP下载单品大图 510 APP下载(IOS) 百度信息流
贴吧信息流
百度联盟媒体
60 8 24 1张图片
单张不超过500KB
1140×640
600×300(仅联盟流量)
1280×720(仅联盟流量)
960×640(仅联盟流量)
不支持 可选 可选 可选
Android APP下载单品单图 511 APP下载(Android) 百度信息流
贴吧信息流
百度联盟媒体
36 8 24 1张图片
单张不超过200KB
370×245
960×640(仅联盟流量)
600×500(仅联盟流量)
800×120(仅联盟流量)
不支持 可选 可选 可选
Android APP下载单品大图 512 APP下载(Android) 百度信息流
贴吧信息流
百度联盟媒体
60 8 24 1张图片
单张不超过500KB
1140×640
600×300(仅联盟流量)
1280×720(仅联盟流量)
960×640(仅联盟流量)
不支持 可选 可选 可选
三品三图II 513 网站链接 单选贴吧信息流 60 8 不支持 1张图片
单张不超过200KB
220×220
不支持 可选 可选 可选
单品三图II 514 网站链接 单选贴吧信息流 60 8 不支持 1张图片
单张不超过200KB
220×220
不支持 可选 可选 可选
贴吧_APP下载三品三图II 515 APP下载 单选贴吧信息流 60 8 24 1张图片
单张不超过200KB
220×220
不支持 可选 可选 可选
贴吧_APP下载单品三图II 516 APP下载 单选贴吧信息流 60 8 24 1张图片
单张不超过200KB
220×220
不支持 可选 可选 可选
橱窗样式 517 网站链接 百度信息流 36 8 不支持 4张图片
单张不超过200KB
370×245
不支持 可选 可选 可选
视频大图样式 518 网站链接 百度信息流
贴吧信息流(仅列表页)
60 8 不支持 1张图片
单张不超过500KB
1140×640
视频大小不超过200MB,尺寸1280×720
视频默认帧图片不超过500KB,尺寸1140×640
可选 可选 可选
视频大图下载样式 519 APP下载 百度信息流(仅列表页)
贴吧信息流(仅列表页)
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 APP下载 百度信息流(仅列表页) 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 APP下载 百度联盟媒体 不支持 不支持 不支持 1张图片
单张不超过500KB
640×960
1080×1920
480×800
768×1024
不支持 可选 可选 可选