更新动态创意
全部接口
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
}
}可视化调试工具
问题仍未解决？
请前往腾讯广告反馈中心在线提交问题，我们的人工客服将为你服务
