更新动态创意
全部接口
V1.1
loading
V1.1
loading
所属权限 | Ads Management |
请求地址 | dynamic_creatives/update |
请求方法 | post |
全局参数
全局参数是指每一个接口都需要使用到的参数。详情参考,代码案例参考。
参数名称 | 参数类型 |
---|---|
access_token | 授权令牌,完成 OAuth 2.0 授权后获得,参考授权认证章节 |
timestamp |
当前的时间戳,单位为秒,允许客户端请求最大时间误差为 300 秒。 MarketingAPI 所使用的时间戳,若无特殊说明,均为秒级时间戳 MarketingAPI 所使用的时区为 GMT+8,例如当时间戳为 1494840119 时,表示 2017-05-15 17:21:59 |
nonce | 随机字串标识,不超过 32 个字符,由调用方自行生成,需保证全局唯一性 |
fields | get 接口增加 fields 字段,用于指定返回参数的字段列表,为选填字段。fields 取值范围为 get 接口返回的 list 中的字段。如不填写,则根据默认值进行返回 |
请求参数
参数仅适用于腾讯广告平台,暂不支持微信公众平台。
标有*的参数为必填项
名称 | 类型 | 描述 |
---|---|---|
account_id*
|
integer | 广告主帐号 id,有操作权限的帐号 id,不支持代理商 id |
dynamic_creative_id*
|
integer | 广告创意 id |
dynamic_creative_template_id*
|
integer | 创意规格 id,具体请咨询您的运营接口人,也可通过 [创意规格查询工具] 进行查询 |
dynamic_creative_elements
|
struct | 创意元素 |
image
|
string | 图片 id,通过 [images 模块] 上传图片后获得,图片 id 字段长度最小 1 字节,长度最大 192 字节 |
image2
|
string | 素材图片 2 的 id,通过 [images 模块] 上传图片后获得,素材图片 2 的 id 字段长度最小 1 字节,长度最大 192 字节 |
image3
|
string | 素材图片 3 的 id,通过 [images 模块] 上传图片后获得,素材图片 3 的 id 字段长度最小 1 字节,长度最大 192 字节 |
title
|
string | 广告文案 字段长度最小 1 字节,长度最大 10240 字节 |
description
|
string | 广告描述 字段长度最小 1 字节,长度最大 10240 字节 |
corporate
|
struct | 商标 |
corporate_name
|
string | 商标名称 字段长度最小 1 字节,长度最大 10240 字节 |
corporate_img
|
string | 商标图片 id,通过 [images 模块] 上传图片后获得,商标图片 id 字段长度最小 1 字节,长度最大 192 字节 |
video
|
string | 视频 id,通过 [videos 模块] 上传视频后获得,视频 id 字段长度最小 1 字节,长度最大 192 字节 |
image_options
|
string[] | 图片墙,图片 id 通过 [images 模块] 上传图片获得,图片墙 数组最小长度 0,最大长度 3 字段长度最小 1 字节,长度最大 384 字节 |
image_list_options
|
array[] | 注意,该结构为二维数组,外层数组中的每个元素为 imgae_list,内层数组中的元素为 image,示例:image_list_options:[[image1_1, image1_2],[image2_1, image2_2]],图片墙 数组最小长度 0,最大长度 3 数组最小长度 1,最大长度 12 |
title_options
|
string[] | 广告文案 数组最小长度 0,最大长度 3 字段长度最小 1 字节,长度最大 10240 字节 |
description_options
|
string[] | 广告描述 数组最小长度 0,最大长度 3 字段长度最小 1 字节,长度最大 360 字节 |
video_options
|
string[] | 视频 数组最小长度 0,最大长度 3 字段长度最小 1 字节,长度最大 384 字节 |
short_video_struct_options
|
struct[] | 视频 数组最小长度 0,最大长度 3 |
short_video1
|
integer | 视频 id,通过 [videos 模块] 上传视频后获得 |
short_video2
|
integer | 视频 id,通过 [videos 模块] 上传视频后获得 |
deep_link_type
|
string | 应用直达点击方式 字段长度最小 1 字节,长度最大 96 字节 |
link_name_type
|
enum | 链接名称类型,若不填写,则默认显示【查看详情】,[枚举详情] 枚举列表:{ VIEW_DETAILS, GET_COUPONS, MAKE_AN_APPOINTMENT, BUY_NOW, GO_SHOPPING, ENTER_MINI_PROGRAM, ENTER_MINI_GAME, APPLY_NOW, RESERVATION_BUY, CONSULT_NOW, BOOK_DRIVE, ENTER_OFFICIAL_ACCOUNTS, PLAY_NOW, OPEN_MINI_GAME, DOWNLOAD_APP, DOWNLOAD_GAME, GET_SAMPLES, GET_IT_NOW, BUY_ASAP, DOWNLOAD_NOW, VIEW_APPS, MORE_INFO, GET_VOUCHERS, FOLLOW_OFFICIAL_ACCOUNT, READ_NOVELS, WATCH_LIVE, RESERVE_NOW } |
image_list
|
string[] | 图片墙,图片 id 通过 [images 模块] 上传图片获得,图片墙 数组最小长度 1,最大长度 12 字段长度最小 1 字节,长度最大 192 字节 |
element_story
|
struct[] | 集装箱创意组合,具体请咨询你的运营接口人,集装箱创意组合 数组最小长度 1,最大长度 14 |
image
|
string | 图片 id,通过 [images 模块] 上传图片后获得,图片 id 字段长度最小 1 字节,长度最大 192 字节 |
image2
|
string | 素材图片 2 的 id,通过 [images 模块] 上传图片后获得,素材图片 2 的 id 字段长度最小 1 字节,长度最大 192 字节 |
description
|
string | 广告描述 字段长度最小 1 字节,长度最大 10240 字节 |
url
|
string | 跳转链接 字段长度最小 1 字节,长度最大 1536 字节 |
title
|
string | 广告文案 字段长度最小 1 字节,长度最大 10240 字节 |
url
|
string | 跳转链接 字段长度最小 1 字节,长度最大 1536 字节 |
button_text
|
string | 跳转按钮文字 字段长度最小 1 字节,长度最大 96 字节 |
bottom_text
|
string | 左下辅助文字 字段长度最小 1 字节,长度最大 96 字节 |
countdown_expiring_timestamp
|
integer | 倒计时截止时间戳,unix 时间戳,单位秒 最小值 1000000000,最大值 9999999999 |
mini_program_id
|
string | 小程序 id 字段长度最小 1 字节,长度最大 384 字节 |
mini_program_path
|
string | 小程序路径 字段长度最小 1 字节,长度最大 2048 字节 |
label
|
struct[] | 标签数组 数组最小长度 1,最大长度 3 |
content*
|
string | 标签内容 字段长度最小 1 字节,长度最大 255 字节 |
product_tags
|
enum[] | product_tags,[枚举详情] 数组最小长度 1,最大长度 2 枚举列表:{ ONLY_FOR_NEW_CUSTOMER, OVERSEAS_SHOPPING, COUPON, DISCOUNT, FREE_SHIPPING, CASH_ON_DELIVERY } |
logo_description
|
string | 素材标题,仅在规格支持时传入,详见规格详情 字段长度最小 1 字节,长度最大 250 字节 |
logo
|
string | 标签广告 logo 图片 id,通过 [images 模块] 上传图片后获得,仅在规格支持时传入,详见规格详情 字段长度最小 1 字节,长度最大 64 字节 |
left_bottom_txt
|
string | 左下角描述 字段长度最小 1 字节,长度最大 192 字节 |
animation_effect
|
string | 动画效果 字段长度最小 1 字节,长度最大 96 字节 |
phone
|
string | 电话号码 字段长度最小 1 字节,长度最大 96 字节 |
short_video_struct
|
struct | 短视频结构,短视频结构,支持 short_video1,short_video2 |
short_video1
|
integer | 视频 id,通过 [videos 模块] 上传视频后获得 |
short_video2
|
integer | 视频 id,通过 [videos 模块] 上传视频后获得 |
long_video_struct
|
struct | 完整视频结构,完整视频结构,支持 long_video1,long_video2 |
long_video1
|
integer | 视频 id,通过 [videos 模块] 上传视频后获得 |
long_video2
|
integer | 视频 id,通过 [videos 模块] 上传视频后获得 |
banner_content
|
struct | banner 素材内容 |
image*
|
string | 图片 id,通过 [images 模块] 上传图片后获得,图片 id 字段长度最小 1 字节,长度最大 192 字节 |
title*
|
string | 广告文案 字段长度最小 1 字节,长度最大 10240 字节 |
url*
|
string | 跳转链接 字段长度最小 1 字节,长度最大 1536 字节 |
card_content
|
struct | 卡片素材内容 |
image*
|
string | 图片 id,通过 [images 模块] 上传图片后获得,图片 id 字段长度最小 1 字节,长度最大 192 字节 |
description*
|
string | 广告描述 字段长度最小 1 字节,长度最大 10240 字节 |
url*
|
string | 跳转链接 字段长度最小 1 字节,长度最大 1536 字节 |
video_popup_button
|
struct | 视频浮层按钮信息 |
video_popup_button_text
|
string | 视频浮层按钮文案 字段长度最小 1 字节,长度最大 192 字节 |
video_popup_button_url
|
string | 视频浮层按钮链接 字段长度最小 1 字节,长度最大 2048 字节 |
button_url
|
string | 按钮链接 字段长度最小 1 字节,长度最大 2048 字节 |
brand
|
struct | 品牌形象结构,品牌形象元素,支持 brand_img,brand_name,brand_description |
brand_img
|
string | 广告主头像图片 id,通过 [images 模块] 上传图片后获得,仅在规格支持时传入,详见规格详情 字段长度最小 1 字节,长度最大 64 字节 |
brand_name
|
string | 广告主名称 字段长度最小 1 字节,长度最大 24 字节 |
brand_description
|
string | 广告文案 字段长度最小 1 字节,长度最大 42 字节 |
caption
|
string | 消息标题 字段长度最小 1 字节,长度最大 96 字节 |
shop_image
|
string | 卖点图片 id 字段长度最小 1 字节,长度最大 2048 字节 |
deep_link_url
|
string | 应用直达页 URL 字段长度最小 0 字节,长度最大 2048 字节 |
impression_tracking_url
|
string | 曝光监控地址,监控地址主域只允许白名单内的域名,详见 [第三方监控] 字段长度最小 0 字节,长度最大 1023 字节 |
click_tracking_url
|
string | 监控链接,监控地址主域只允许白名单内的域名,详见 [第三方监控] 字段长度最小 0 字节,长度最大 1024 字节 |
feeds_video_comment_switch
|
boolean | 视频广告评论开关 可选值:{ true, false } |
union_market_switch
|
boolean | 联盟下载器开关 可选值:{ true, false } |
video_end_page
|
struct | 视频播放结束页,(当前仅支持互动推广页) |
end_page_id*
|
string | 视频播放结束页 id 字段长度最小 1 字节,长度最大 20 字节 |
end_page_type*
|
enum | 视频播放结束页类型,[枚举详情] 枚举列表:{ VIDEO_END_PAGE_TYPE_PLAY_H5 } |
使用说明
- 注意:支持动态创意元素的传参使用带_options 后缀的参数。可通过 [创意规格查询工具] 进行查询哪些元素支持动态创意。
请求示例
curl 'https://api.e.qq.com/v1.1/dynamic_creatives/update?access_token=<ACCESS_TOKEN>×tamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id=<ACCOUNT_ID>' \
-d 'dynamic_creative_id=123' \
-d 'dynamic_creative_template_id=471' \
-d 'dynamic_creative_elements={"corporate":{"corporate_name":"DC 规格"},"image_options":["141201:db1c272f4daf9a8261db5bd49ab88632","141201:dfdbedd1a4870a21e392ee8569f663ff"],"title_options":["1111111111111111testetetetsttest11","1111111111111111testtestett2"]}' \
-d 'deep_link_url=http://www.example.com' \
-d 'impression_tracking_url=http://www.example.com' \
-d 'click_tracking_url=http://www.example.com' \
-d 'video_end_page=[]'
应答字段
名称 | 类型 | 描述 |
---|---|---|
dynamic_creative_id
|
integer | 广告创意 id |
应答示例
{
"code": 0,
"message": "",
"message_cn": "",
"data": {
"dynamic_creative_id": 123
}
}
可视化调试工具
问题仍未解决?
请前往腾讯广告反馈中心在线提交问题,我们的人工客服将为你服务