广告创意 (Adcreative)

V1.1

loading

本节将为您介绍广告创意 (Adcreative) 相关接口。广告创意由创意形式组成，创意形式定义了每一个创意包含什么元素，并与广告组的广告版位属性一起，决定了当前创意会在具体哪些位置进行展示。关于广告创意更详细的介绍可以参考【广告创意】章节。

创建广告创意（adcreatives/add）

所属权限（scope）：Ads Management

更新广告创意（adcreatives/update）

所属权限（scope）：Ads Management

获取广告创意（adcreatives/get）

所属权限（scope）：Ads Management, Ads Insights

删除广告创意（adcreatives/delete）

所属权限（scope）：Ads Management

创建广告创意
全部接口
V1.1
loading

所属权限	Ads Management
请求地址	adcreatives/add
请求方法	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 中的字段。如不填写，则根据默认值进行返回

特定请求头参数

该接口支持一些特定请求头的参数，该参数支持放入请求的请求头中，注意不是请求体中。

请求头名称	描述
X-Request-Id	资源请求的唯一 id，该请求头参数用于保证接口重试的幂等性，即当请求参数是 A 时，X-Request-Id 为 B 时，即使重复请求，API 侧永远不会新建一个全新的广告资源，避免重试的时候重复创建。如果在创建时重复传入相同的请求参数和 X-Request-Id，那么会返回该 X-Request-Id 对应的唯一的广告资源。支持的接口列表参考投放接口错误处理指引章节

请求头名称

描述

X-Request-Id

资源请求的唯一 id，该请求头参数用于保证接口重试的幂等性，即当请求参数是 A 时，X-Request-Id 为 B 时，即使重复请求，API 侧永远不会新建一个全新的广告资源，避免重试的时候重复创建。如果在创建时重复传入相同的请求参数和 X-Request-Id，那么会返回该 X-Request-Id 对应的唯一的广告资源。支持的接口列表参考投放接口错误处理指引章节

请求参数

标有*的参数为必填项

名称	类型	描述
account_id*	integer	广告主帐号 id，有操作权限的帐号 id，不支持代理商 id
campaign_id*	int64	推广计划 id
adcreative_name*	string	广告创意名称，字段长度最小 1 个等宽字符，长度最大 60 等宽字符（即字段最大长度为 60 个中文字或全角标点，120 个英文字或半角标点。一个等宽字符等价于一个中文，等价于两个英文。）字段长度最小 1 字节，长度最大 180 字节
adcreative_template_id*	integer	创意形式 id，具体请咨询您的运营接口人，也可通过创意形式查询工具进行查询
adcreative_elements*	struct	创意元素，不同 adcreative_template_id 要求的元素不尽相同，其中部分创意形式的文案元素支持换行能力，使用“\n ”表示换行，占 0.5 个等宽字符，建议行数不超过 6 行，具体情况可通过 [创意规格查询工具] 进行查询
promoted_object_type*	enum	推广目标类型，[枚举详情]，当 campaign_type 取值 CAMPAIGN_TYPE_WECHAT_MOMENTS 时，枚举列表：{ PROMOTED_OBJECT_TYPE_LINK_WECHAT, PROMOTED_OBJECT_TYPE_LOCAL_ADS_WECHAT, PROMOTED_OBJECT_TYPE_ECOMMERCE, PROMOTED_OBJECT_TYPE_APP_ANDROID, PROMOTED_OBJECT_TYPE_APP_IOS, PROMOTED_OBJECT_TYPE_LEAD_AD, PROMOTED_OBJECT_TYPE_MINI_GAME_WECHAT } 当 campaign_type 取值 CAMPAIGN_TYPE_NORMAL 时，枚举列表：{PROMOTED_OBJECT_TYPE_LINK, PROMOTED_OBJECT_TYPE_LINK_WECHAT, PROMOTED_OBJECT_TYPE_ECOMMERCE, PROMOTED_OBJECT_TYPE_APP_ANDROID, PROMOTED_OBJECT_TYPE_APP_IOS, PROMOTED_OBJECT_TYPE_APP_ANDROID_MYAPP, PROMOTED_OBJECT_TYPE_APP_ANDROID_UNION, PROMOTED_OBJECT_TYPE_LOCAL_ADS_WECHAT, PROMOTED_OBJECT_TYPE_QQ_MESSAGE, PROMOTED_OBJECT_TYPE_LEAD_AD, PROMOTED_OBJECT_TYPE_MINI_GAME_WECHAT, PROMOTED_OBJECT_TYPE_APP_QUICK_APP,PROMOTED_OBJECT_TYPE_WECHAT_OFFICIAL_ACCOUNT} 枚举列表：{ PROMOTED_OBJECT_TYPE_LINK, PROMOTED_OBJECT_TYPE_LINK_WECHAT, PROMOTED_OBJECT_TYPE_ECOMMERCE, PROMOTED_OBJECT_TYPE_APP_ANDROID, PROMOTED_OBJECT_TYPE_APP_QUICK_APP, PROMOTED_OBJECT_TYPE_APP_IOS, PROMOTED_OBJECT_TYPE_APP_ANDROID_MYAPP, PROMOTED_OBJECT_TYPE_APP_ANDROID_UNION, PROMOTED_OBJECT_TYPE_QQ_BROWSER_MINI_PROGRAM, PROMOTED_OBJECT_TYPE_LOCAL_ADS_WECHAT, PROMOTED_OBJECT_TYPE_QQ_MESSAGE, PROMOTED_OBJECT_TYPE_LEAD_AD, PROMOTED_OBJECT_TYPE_MINI_GAME_WECHAT, PROMOTED_OBJECT_TYPE_MINI_GAME_QQ, PROMOTED_OBJECT_TYPE_MINI_PROGRAM_WECHAT, PROMOTED_OBJECT_TYPE_WECHAT_CHANNELS, PROMOTED_OBJECT_TYPE_WECHAT_OFFICIAL_ACCOUNT, PROMOTED_OBJECT_TYPE_WECHAT_OFFICIAL_ACCOUNT }
page_type*	enum	落地页类型，[枚举详情] 枚举列表：{ PAGE_TYPE_DEFAULT, PAGE_TYPE_TSA_APP, PAGE_TYPE_TSA_WEB_NONE_ECOMMERCE, PAGE_TYPE_CANVAS_WECHAT, PAGE_TYPE_MINI_PROGRAM_WECHAT, PAGE_TYPE_FENGYE_ECOMMERCE, PAGE_TYPE_FENGYE_EC_WECHAT_MINIPROGRAM, PAGE_TYPE_MINI_GAME_WECHAT, PAGE_TYPE_MINI_PROGRAM_QQ, PAGE_TYPE_MINI_PROGRAM_CANVAS_WECHAT, PAGE_TYPE_MINI_GAME_QQ, PAGE_TYPE_ARTICAL_WECHAT, PAGE_TYPE_MOMENTS_SIMPLE_NATIVE_WECHAT, PAGE_TYPE_FULL_SCREEN_WECHAT, PAGE_TYPE_YUEBAO_QUICKAPP, PAGE_TYPE_YUEBAO_OFFICIAL_ACCOUNT_ARTICLE, PAGE_TYPE_XIJING_QUICK, PAGE_TYPE_WEIMOB_WECHAT_MINIPROGRAM, PAGE_TYPE_FENGSHU_MINI_PROGRAM, PAGE_TYPE_WECHAT_FOCUS_DAILOG, PAGE_TYPE_WECHAT_MOMENTS_SCAN_PHOTO, PAGE_TYPE_WECHAT_MOMENTS_SUBSCRIPTION, PAGE_TYPE_WECHAT_RED_PACKET_COVER, PAGE_TYPE_WECHAT_VIDEO_TOPIC, PAGE_TYPE_CHANNELS_HALF_CARD }
automatic_site_enabled	boolean	是否开启自动版位功能（暂不包含 SITE_SET_WECHAT 和 SITE_SET_MOMENTS），此字段与 site_set 字段至少需要写入一个。可选值：{ true, false }
site_set	enum[]	投放版位集合，当前单版位或者 SITE_SET_TENCENT_NEWS+SITE_SET_TENCENT_VIDEO+SITE_SET_MOBILE_UNION+SITE_SET_KANDIAN+SITE_SET_QQ_MUSIC_GAME 的组合，[枚举详情] 数组最小长度 1，最大长度 32 枚举列表：{ SITE_SET_QZONE, SITE_SET_QQCLIENT, SITE_SET_MUSIC, SITE_SET_MOBILE_UNION, SITE_SET_QQCOM, SITE_SET_WECHAT, SITE_SET_MOBILE_INNER, SITE_SET_TENCENT_NEWS, SITE_SET_TENCENT_VIDEO, SITE_SET_TENCENT_KUAIBAO, SITE_SET_MOBILE_MYAPP, SITE_SET_PCQQ, SITE_SET_KANDIAN, SITE_SET_QQ_MUSIC_GAME, SITE_SET_MOMENTS, SITE_SET_KUAISHOU, SITE_SET_MINI_GAME_WECHAT, SITE_SET_MINI_GAME_QQ, SITE_SET_MOBILE_GAME, SITE_SET_MOBILE_YYB, SITE_SET_QQSHOPPING, SITE_SET_WECHAT_SEARCH, SITE_SET_WECHAT_PLUGIN }
page_spec	struct	落地页信息，根据不同 promoted_object_type 和 page_type，要求的 page_spec 信息不同
page_id	int64	落地页 id
page_url	string	落地页 url 字段长度最小 1 字节，长度最大 1023 字节
mini_program_spec	struct	小程序落地页，mini_program_id 和 mini_program_path 要同时填写
mini_program_id*	string	小程序 id 字段长度最小 1 字节，长度最大 384 字节
mini_program_path	string	小程序路径字段长度最小 1 字节，长度最大 2048 字节
mini_program_paths	string[]	小程序落地页 path 列表数组最小长度 1，最大长度 255 字段长度最小 1 字节，长度最大 2048 字节
mini_game_spec	struct	小游戏落地页信息
mini_game_tracking_parameter	string	小游戏监控参数，需以英文字符?开头，如：?channel=xxxx，字段长度最小 1 个等宽字符，长度最大 250 个等宽字符（即字段最大长度为 250 个中文字或全角标点，500 个英文字或半角标点。一个等宽字符等价于一个中文，等价于两个英文。）字段长度最小 0 字节，长度最大 750 字节
mini_game_openlink	string	openlink 地址字段，当投放版位含优量汇时、推广目标是微信小游戏推广目标时，支持填写「微信小游戏落地页的 openlink 地址」（白名单灰度中），什么是 opelink 可参考[微信开放文档] 字段长度最小 0 字节，长度最大 2048 字节
mini_game_openlink_page_spec	struct	小游戏蹊径落地页，当投放版位含优量汇时、推广目标是微信小游戏推广目标时，落地页使用「微信小游戏」落地页时，支持使用「蹊径落地页」（白名单灰度中）；注意不能同时和「 mini_game_openlink 」同时使用，否则会被蹊径落地页链接覆盖。
landing_page_type*	enum	openlink 落地页页面类型，不大于 1024 个英文字符或数字，[枚举详情] 枚举列表：{ LANDING_PAGE_TYPE_XJ_WEBSITE_H5 }
landing_page_id*	integer	落地页 id
override_canvas_head_option	enum	原生推广页顶部素材和广告创意素材之间的替换关系，（仅在朋友圈广告使用原生推广页情况下有效），[枚举详情] 枚举列表：{ OPTION_CANVAS_OVERRIDE_CREATIVE, OPTION_CREATIVE_OVERRIDE_CANVAS, OPTION_KEEP_DIFFERENT }
dynamic_product_spec	struct	动态多商品广告落地页信息，仅支持 MDPA 广告使用动态落地页(见 dynamic_adcreative_spec.landing_page_url_type) 时填写
page_url	string	动态落地页 url 字段长度最小 1 字节，长度最大 1023 字节
mini_program_paths	string[]	动态多商品广告小程序落地页 path 列表数组最小长度 1，最大长度 6 字段长度最小 1 字节，长度最大 2048 字节
link_page_type	enum	文字链跳转类型类型，[枚举详情] 枚举列表：{ LINK_PAGE_TYPE_NOT_USED, LINK_PAGE_TYPE_DEFAULT, LINK_PAGE_TYPE_CANVAS_WECHAT, LINK_PAGE_TYPE_ARTICAL_WECHAT, LINK_PAGE_TYPE_MINI_PROGRAM_WECHAT, LINK_PAGE_TYPE_MINI_PROGRAM_CANVAS_WECHAT, LINK_PAGE_TYPE_MINI_GAME_WECHAT, LINK_PAGE_TYPE_FENGYE_ECOMMERCE, LINK_PAGE_TYPE_XJ_ANDROID_APP_H5, LINK_PAGE_TYPE_XJ_IOS_APP_H5, LINK_PAGE_TYPE_XJ_WEBSITE_H5, LINK_PAGE_TYPE_WECHAT_MOMENTS_SIMPLE_NATIVE, LINK_PAGE_TYPE_WECHAT_APPOINTMENT_CARD, LINK_PAGE_TYPE_WECHAT_CONSULT, LINK_PAGE_TYPE_WECHAT_MOMENTS_SUBSCRIPTION, LINK_PAGE_TYPE_WECHAT_RED_PACKET_COVER, LINK_PAGE_TYPE_WECHAT_VIDEO_TOPIC, LINK_PAGE_TYPE_WECHAT_OFFICIAL_ACCOUNT_DETAIL, LINK_PAGE_TYPE_XJ_QUICK, LINK_PAGE_TYPE_YOUZAN_WECHAT_MINIPROGRAM, LINK_PAGE_TYPE_WEIMOB_WECHAT_MINIPROGRAM }
link_name_type	enum	链接名称类型，[枚举详情] 枚举列表：{ NOT_USED, VIEW_DETAILS, GET_COUPONS, MAKE_AN_APPOINTMENT, BUY_NOW, GO_SHOPPING, ENTER_MINI_PROGRAM, ENTER_MINI_GAME, APPLY_NOW, BOOK_NOW, RESERVATION_BUY, CONSULT_NOW, BOOK_DRIVE, ENTER_OFFICIAL_ACCOUNTS, PLAY_NOW, OPEN_MINI_GAME, DOWNLOAD_APP, DOWNLOAD_GAME, GET_SAMPLES, TRY_NOW, GET_IT_NOW, BUY_ASAP, DOWNLOAD_NOW, VIEW_APPS, MORE_INFO, GET_VOUCHERS, FOLLOW_OFFICIAL_ACCOUNT, READ_NOVELS, WATCH_LIVE, RESERVE_NOW, OPEN_APP, ALREADY_INSTALL, SETUP_NOW, SECKILL_NOW, TRY_PLAY_NOW, INSTALL_NOW, MORE_ABOUT_OFFICIAL_ACCOUNT_CHT, FOLLOW_OFFICIAL_ACCOUNT_CHT, GET_FOR_FREE, WATCH_VIDEO, CARNIVAL_618, SURPRISE_618, DISCOUNT_618, GO_618_VENUE, GET_618_WELFARE, CONTACT_CUSTOMER_SERVICE, CONTACT_BUSINESS }
link_page_spec	struct	文字链跳转信息，根据不同 promoted_object_type 和 page_type、link_page_type，要求的 link_page_spec 信息不同
page_id	int64	落地页 id
page_url	string	落地页 url 字段长度最小 1 字节，长度最大 1023 字节
mini_program_spec	struct	小程序落地页，mini_program_id 和 mini_program_path 要同时填写
mini_program_id*	string	小程序 id 字段长度最小 1 字节，长度最大 384 字节
mini_program_path	string	小程序路径字段长度最小 1 字节，长度最大 2048 字节
mini_program_paths	string[]	小程序落地页 path 列表数组最小长度 1，最大长度 255 字段长度最小 1 字节，长度最大 2048 字节
mini_game_spec	struct	小游戏落地页信息
mini_game_tracking_parameter	string	小游戏监控参数，需以英文字符?开头，如：?channel=xxxx，字段长度最小 1 个等宽字符，长度最大 250 个等宽字符（即字段最大长度为 250 个中文字或全角标点，500 个英文字或半角标点。一个等宽字符等价于一个中文，等价于两个英文。）字段长度最小 0 字节，长度最大 750 字节
conversion_data_type	enum	数据展示的数据类型，素材下方展示账户内积累的展示推广目标相关的转化数据，吸引用户点击。投放指引：[枚举详情] 枚举列表：{ CONVERSION_DATA_DEFAULT, CONVERSION_DATA_FRIEND_PLAY, CONVERSION_DATA_APP_DOWNLOAD, CONVERSION_DATA_ONSHOP, CONVERSION_DATA_ADMETRIC, CONVERSION_DATA_FRIEND_FOLLOW }
conversion_target_type	enum	数据展示转化行为，仅 conversion_data_type 为 CONVERSION_DATA_ADMETRIC 时可设置可使用的版位可通过 [创意规格查询工具] 进行查询，[枚举详情] 枚举列表：{ CONVERSION_TARGET_DEFAULT, CONVERSION_TARGET_GET, CONVERSION_TARGET_RESERVE, CONVERSION_TARGET_BOOK, CONVERSION_TARGET_BUY, CONVERSION_TARGET_APPLY, CONVERSION_TARGET_CONSULT, CONVERSION_TARGET_DOWNLOAD, CONVERSION_TARGET_PLAYING, CONVERSION_TARGET_CLICK, CONVERSION_TARGET_SEE, CONVERSION_TARGET_INVOLVE, CONVERSION_TARGET_OPEN, CONVERSION_TARGET_PURCHASE, CONVERSION_TARGET_BROWSE, CONVERSION_TARGET_TRY, CONVERSION_TARGET_DRIVE, CONVERSION_TARGET_ENTER, CONVERSION_TARGET_READ, CONVERSION_TARGET_FOLLOW, CONVERSION_TARGET_USE, CONVERSION_TARGET_EXPERIENCE, CONVERSION_TARGET_SETUP, CONVERSION_TARGET_SECKILL }
qq_mini_game_tracking_query_string	string	QQ 小游戏监控参数字段长度最小 0 字节，长度最大 2048 字节
deep_link_url	string	应用直达页 URL，微信朋友圈广告（site_set=SITE_SET_MOMENTS）的创意形式，promoted_object_type 为 PROMOTED_OBJECT_TYPE_APP_ANDROID 时，需要同时填写 deeplink_ios_appid ；或 promoted_object_type 为 PROMOTED_OBJECT_TYPE_APP_IOS 时，需要同时填写 deeplink_anroid_appid，以确保双端都能支持应用直达。字段长度最小 0 字节，长度最大 2048 字节
android_deep_link_app_id	string	安卓应用直达 AppId 字段长度最小 0 字节，长度最大 128 字节
ios_deep_link_app_id	string	IOS 应用直达 AppId 字段长度最小 0 字节，长度最大 128 字节
universal_link_url	string	通用链接页 URL 字段长度最小 0 字节，长度最大 2048 字节
promoted_object_id	string	推广目标 id，详见 [查询推广目标 id] 字段长度最小 0 字节，长度最大 128 字节
profile_id	integer	朋友圈头像昵称跳转页 id，仅微信朋友圈广告（site_set=SITE_SET_MOMENTS）的创意形式支持
share_content_spec	struct	简版原生页分享信息，仅在部分朋友圈创意形式下设置有效，具体可通过创意形式查询工具或 adcreative_templates/get 接口进行查询，若该字段不为空，则表示投放简版原生推广页（点击图片后会跳转至系统自动生成的简版原生推广页）
share_title*	string	简版原生页分享标题，字段长度最小 1 个等宽字符，长度最大 14 个等宽字符（即字段最大长度为 14 个中文字或全角标点，28 个英文字或半角标点。一个等宽字符等价于一个中文，等价于两个英文。）
share_description*	string	简版原生页分享描述，字段长度最小 1 个等宽字符，长度最大 20 个等宽字符（即字段最大长度为 20 个中文字或全角标点，40 个英文字或半角标点。一个等宽字符等价于一个中文，等价于两个英文。）
dynamic_adcreative_spec	struct	动态商品广告属性，当创意为动态商品广告创意时，该字段必填
product_catalog_id*	integer	商品库 id
product_mode*	enum	动态商品广告（DPA）类型，支持单商品动态商品广告（SDPA）和多商品动态商品广告（MDPA），[枚举详情] 枚举列表：{ SINGLE, MULTIPLE }
product_source*	string	动态商品广告所使用的商品信息,可以填入商品系列 id 或者商品 id 字段长度最小 1 字节，长度最大 128 字节
product_exposure_quantity_mode	enum	动态商品广告推荐的商品数量模式，当广告形态为动态多商品广告时，该字段必填，[枚举详情] 枚举列表：{ PRODUCT_ITEMS_SINGLE, PRODUCT_ITEMS_MULTIPLE }
landing_page_url_type	enum	MDPA 落地页类型，当创意为动态多商品广告创意时，该字段必填，[枚举详情] 枚举列表：{ LANDING_PAGE_URL_TYPE_UNKNOWN, LANDING_PAGE_URL_TYPE_STATIC, LANDING_PAGE_URL_TYPE_DYNAMIC }
component_id	integer	附加创意组件 id 最小值 1，最大值 4294967295
union_market_switch	boolean	跳转厂商应用商店，用户点击广告后，将跳转到用户手机厂商商店的应用下载页面。因此，为保障转化率，请在“目标详情-转化归因”中使用全渠道归因，并确保应用在华为、OPPO、VIVO、小米应用商店上架，未上架的厂商请在“设备品牌型号”定向中屏蔽，否则将导致跳转失败。仅投放 SITE_SET_MOMENTS, SITE_SET_KANDIAN, SITE_SET_QQ_MUSIC_GAME, SITE_SET_MOBILE_INNER, SITE_SET_TENCENT_NEWS, SITE_SET_TENCENT_VIDEO 或 SITE_SET_MOBILE_UNION 时可设置；目前白名单开放中，如果需要使用请联系您的运营经理可选值：{ true, false }
playable_page_material_id	string	互动推广页落地页 id，（待废弃，请改为使用 video_end_page 进行设置）字段长度最小 1 字节，长度最大 20 字节
video_end_page	struct	视频播放结束页，（当前仅支持互动推广页）
end_page_id*	string	视频播放结束页 id 字段长度最小 1 字节，长度最大 20 字节
end_page_type*	enum	视频播放结束页类型，[枚举详情] 枚举列表：{ VIDEO_END_PAGE_TYPE_PLAY_H5 }
feeds_video_comment_switch	boolean	视频广告评论开关可选值：{ true, false }
webview_url	string	简易原生页嵌入 Webview url,和 simple_canvas_sub_type 配合使用，关系如下:SIMPLE_CANVAS_SUB_TYPE_URL,SIMPLE_CANVAS_SUB_TYPE_SLIDE_UP 时必填，SIMPLE_CANVAS_SUB_TYPE_WEB_STORE 时系统其他填充为 web store 地址，其他情况无效。域名仅支持数字、大小写字母、连字符等字符，且不支持绑定端口号，url 下的 path 支持 a-zA-Z0-9`~!@#%&_=;$^*()-+{}[]:,.?/\|等字符，示例：1. http[s]://abc-cd.ef.com/1Aa-Bb?a=123&b=123, 2. qb://weapp/?package 字段长度最小 0 字节，长度最大 1023 字节
simple_canvas_sub_type	enum	简版原生页子类型(灰度中)，仅在简版原生页下生效，其他情况改字段内容会被忽略，[枚举详情] 枚举列表：{ SIMPLE_CANVAS_SUB_TYPE_UNKNOWN, SIMPLE_CANVAS_SUB_TYPE_DEFAULT, SIMPLE_CANVAS_SUB_TYPE_URL, SIMPLE_CANVAS_SUB_TYPE_SLIDE_UP, SIMPLE_CANVAS_SUB_TYPE_WEB_STORE, SIMPLE_CANVAS_SUB_TYPE_CHOOSE }
floating_zone	struct	浮层卡片创意内容
floating_zone_switch*	boolean	浮层卡片开关可选值：{ true, false }
floating_zone_image_id	string	尺寸：512512，大小：不超过 50 KB，格式：.jpg\|.jpeg\|.png ；
floating_zone_name	string	文案一，字段长度最小 1 个等宽字符，长度最大 8 等宽字符（即字段最大长度为 8 个中文字或全角标点，16 个英文字或半角标点。一个等宽字符等价于一个中文，等价于两个英文。）
floating_zone_desc	string	文案二，字段长度最小 0 个等宽字符，长度最大 6 等宽字符（即字段最大长度为 6 个中文字或全角标点，12 个英文字或半角标点。一个等宽字符等价于一个中文，等价于两个英文。）
floating_zone_button_text	string	按钮文案，字段长度最小 0 个等宽字符，长度最大 4 等宽字符（即字段最大长度为 4 个中文字或全角标点，8 个英文字或半角标点。一个等宽字符等价于一个中文，等价于两个英文。）
floating_zone_type	enum	浮层卡片类型，[枚举详情] 枚举列表：{ FLOATING_ZONE_TYPE_UNKNOWN, FLOATING_ZONE_TYPE_IMAGE_TEXT, FLOATING_ZONE_TYPE_SINGLE_IMAGE, FLOATING_ZONE_TYPE_MULTI_BUTTON }
floating_zone_single_image_id	string	尺寸: 540276 ,大小：不超过 50 KB，格式：.jpg\|.jpeg\|.png ；
marketing_pendant_image_id	string	挂件图，悬浮展示在竖版视频上以展示营销卖点。在 [images 模块] 上传图片后获得该 id 并在参数中传入，上传图片时需指定 image_usage 字段。字段长度最小 1 字节，长度最大 64 字节仅在规格支持时传入，可通过 [创意规格查询工具] 查询字段长度最小 0 字节，长度最大 64 字节
countdown_switch	boolean	倒计时组件开关可选值：{ true, false }
head_click_type	enum	头像点击跳转信息，[枚举详情] 枚举列表：{ HEAD_CLICK_TYPE_DEFAULT, HEAD_CLICK_TYPE_CUSTOMIZED, HEAD_CLICK_TYPE_CELEBRITY_ACCOUNT, HEAD_CLICK_TYPE_VIRTUAL_ACCOUNT, HEAD_CLICK_TYPE_LIVE_PROFILE, HEAD_CLICK_TYPE_LIVE_EVENT, HEAD_CLICK_TYPE_BRAND_PROGRAM, HEAD_CLICK_TYPE_CNY_PROFILE }
head_click_spec	struct	头像点击跳转信息，目前支持跳转搜一搜品牌专区，白名单开放中，如果需要使用请联系您的运营经理
brand_app_id	string	搜一搜品牌形象 app id 字段长度最小 1 字节，长度最大 2048 字节
page_track_url	string	页面级转化跟踪 URL(可选) 字段长度最小 1 字节，长度最大 2048 字节
barrage_list	struct[]	弹幕列表数组最小长度 0，最大长度 20
id*	integer	弹幕 id
app_gift_pack_code	struct	礼包码，微信朋友圈广告创意形式需要填写，礼包码
code	string	礼包码，微信朋友圈广告创意形式需要填写，礼包码字段长度最小 0 字节，长度最大 450 字节
tips	string	礼包码提示，微信朋友圈广告创意形式需要填写，礼包码提示
enable_breakthrough_siteset	boolean	是否支持版位突破，广告版位选择“微信朋友圈”，当广告有机会获得更多曝光与转化时，将可能投放到微信公众号与小程序版位，若不传值默认为 true 可选值：{ true, false }
industry_label	string	行业标签内容字段长度最小 0 字节，长度最大 2048 字节
union_market_spec	struct	厂商下载信息，厂商下载信息，仅可在跳转厂商应用商店（union_market_switch）值为 true 时使用。
union_market_jump_type	enum	厂商直达链接跳转类型，[枚举详情] 枚举列表：{ UNION_MARKET_JUMP_TYPE_DEFAULT, UNION_MARKET_JUMP_TYPE_LANDING_PAGE }
android_quick_app_spec	struct	安卓快应用跳转信息
android_quick_app_jump_type*	enum	安卓快应用跳转类型，[枚举详情] 枚举列表：{ ANDROID_QUICK_APP_JUMP_TYPE_DEFAULT, ANDROID_QUICK_APP_JUMP_TYPE_LANDING_PAGE }
android_quick_app_jump_url*	string	安卓快应用跳转 URL 字段长度最小 0 字节，长度最大 2048 字节

使用说明

DPA 广告功能灰度开放，如有接入需求，请联系对接渠道运营同事线下进行申请。

请求示例


curl 'https://api.e.qq.com/v1.1/adcreatives/add?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id=<ACCOUNT_ID>' \
-d 'campaign_id=<CAMPAIGN_ID>' \
-d 'adcreative_name=广告创意' \
-d 'adcreative_template_id=<ADCREATIVE_TEMPLATE_ID>' \
-d 'adcreative_elements={"image":"123456"}' \
-d 'promoted_object_type=PROMOTED_OBJECT_TYPE_LINK_WECHAT' \
-d 'page_type=PAGE_TYPE_DEFAULT' \
-d 'site_set=["SITE_SET_WECHAT"]' \
-d 'page_spec={"page_url":"https://www.example.com"}' \
-d 'link_page_spec={
    "mini_program_spec": {
        "mini_program_paths": []
    },
    "mini_game_spec": []
}' \
-d 'share_content_spec=[]' \
-d 'video_end_page=[]' \
-d 'floating_zone=[]' \
-d 'head_click_spec=[]' \
-d 'barrage_list=[]' \
-d 'app_gift_pack_code={
    "code": 0
}' \
-d 'union_market_spec=[]' \
-d 'android_quick_app_spec=[]'

场景组合示例

枚举值会自动根据已选条件变化，只展示有示例数据的枚举值

应答字段

名称	类型	描述
adcreative_id	int64	广告创意 id

应答示例

{
    "code": 0,
    "message": "",
    "message_cn": "",
    "data": {
        "adcreative_id": "<ADCREATIVE_ID>"
    }
}

可视化调试工具

更新广告创意
全部接口
V1.1
loading

所属权限	Ads Management
请求地址	adcreatives/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
adcreative_id*	int64	广告创意 id
adcreative_name	string	广告创意名称，字段长度最小 1 个等宽字符，长度最大 60 等宽字符（即字段最大长度为 60 个中文字或全角标点，120 个英文字或半角标点。一个等宽字符等价于一个中文，等价于两个英文。）字段长度最小 1 字节，长度最大 180 字节
adcreative_elements	struct	创意元素，不同 adcreative_template_id 要求的元素不尽相同，其中部分创意形式的文案元素支持换行能力，使用“\n ”表示换行，占 0.5 个等宽字符，建议行数不超过 6 行，具体情况可通过 [创意规格查询工具] 进行查询
page_type	enum	落地页类型，[枚举详情] 枚举列表：{ PAGE_TYPE_DEFAULT, PAGE_TYPE_TSA_APP, PAGE_TYPE_TSA_WEB_NONE_ECOMMERCE, PAGE_TYPE_CANVAS_WECHAT, PAGE_TYPE_MINI_PROGRAM_WECHAT, PAGE_TYPE_FENGYE_ECOMMERCE, PAGE_TYPE_FENGYE_EC_WECHAT_MINIPROGRAM, PAGE_TYPE_MINI_GAME_WECHAT, PAGE_TYPE_MINI_PROGRAM_QQ, PAGE_TYPE_MINI_PROGRAM_CANVAS_WECHAT, PAGE_TYPE_MINI_GAME_QQ, PAGE_TYPE_ARTICAL_WECHAT, PAGE_TYPE_MOMENTS_SIMPLE_NATIVE_WECHAT, PAGE_TYPE_FULL_SCREEN_WECHAT, PAGE_TYPE_YUEBAO_QUICKAPP, PAGE_TYPE_YUEBAO_OFFICIAL_ACCOUNT_ARTICLE, PAGE_TYPE_XIJING_QUICK, PAGE_TYPE_WEIMOB_WECHAT_MINIPROGRAM, PAGE_TYPE_FENGSHU_MINI_PROGRAM, PAGE_TYPE_WECHAT_FOCUS_DAILOG, PAGE_TYPE_WECHAT_MOMENTS_SCAN_PHOTO, PAGE_TYPE_WECHAT_MOMENTS_SUBSCRIPTION, PAGE_TYPE_WECHAT_RED_PACKET_COVER, PAGE_TYPE_WECHAT_VIDEO_TOPIC, PAGE_TYPE_CHANNELS_HALF_CARD }
page_spec	struct	落地页信息，根据不同 promoted_object_type 和 page_type，要求的 page_spec 信息不同
page_id	int64	落地页 id
page_url	string	落地页 url 字段长度最小 1 字节，长度最大 1023 字节
mini_program_spec	struct	小程序落地页，mini_program_id 和 mini_program_path 要同时填写
mini_program_id*	string	小程序 id 字段长度最小 1 字节，长度最大 384 字节
mini_program_path	string	小程序路径字段长度最小 1 字节，长度最大 2048 字节
mini_program_paths	string[]	小程序落地页 path 列表数组最小长度 1，最大长度 255 字段长度最小 1 字节，长度最大 2048 字节
mini_game_spec	struct	小游戏落地页信息
mini_game_tracking_parameter	string	小游戏监控参数，需以英文字符?开头，如：?channel=xxxx，字段长度最小 1 个等宽字符，长度最大 250 个等宽字符（即字段最大长度为 250 个中文字或全角标点，500 个英文字或半角标点。一个等宽字符等价于一个中文，等价于两个英文。）字段长度最小 0 字节，长度最大 750 字节
mini_game_openlink	string	openlink 地址字段，当投放版位含优量汇时、推广目标是微信小游戏推广目标时，支持填写「微信小游戏落地页的 openlink 地址」（白名单灰度中），什么是 opelink 可参考[微信开放文档] 字段长度最小 0 字节，长度最大 2048 字节
mini_game_openlink_page_spec	struct	小游戏蹊径落地页，当投放版位含优量汇时、推广目标是微信小游戏推广目标时，落地页使用「微信小游戏」落地页时，支持使用「蹊径落地页」（白名单灰度中）；注意不能同时和「 mini_game_openlink 」同时使用，否则会被蹊径落地页链接覆盖。
landing_page_type*	enum	openlink 落地页页面类型，不大于 1024 个英文字符或数字，[枚举详情] 枚举列表：{ LANDING_PAGE_TYPE_XJ_WEBSITE_H5 }
landing_page_id*	integer	落地页 id
override_canvas_head_option	enum	原生推广页顶部素材和广告创意素材之间的替换关系，（仅在朋友圈广告使用原生推广页情况下有效），[枚举详情] 枚举列表：{ OPTION_CANVAS_OVERRIDE_CREATIVE, OPTION_CREATIVE_OVERRIDE_CANVAS, OPTION_KEEP_DIFFERENT }
dynamic_product_spec	struct	动态多商品广告落地页信息，仅支持 MDPA 广告使用动态落地页(见 dynamic_adcreative_spec.landing_page_url_type) 时填写
page_url	string	动态落地页 url 字段长度最小 1 字节，长度最大 1023 字节
mini_program_paths	string[]	动态多商品广告小程序落地页 path 列表数组最小长度 1，最大长度 6 字段长度最小 1 字节，长度最大 2048 字节
link_page_type	enum	文字链跳转类型类型，[枚举详情] 枚举列表：{ LINK_PAGE_TYPE_NOT_USED, LINK_PAGE_TYPE_DEFAULT, LINK_PAGE_TYPE_CANVAS_WECHAT, LINK_PAGE_TYPE_ARTICAL_WECHAT, LINK_PAGE_TYPE_MINI_PROGRAM_WECHAT, LINK_PAGE_TYPE_MINI_PROGRAM_CANVAS_WECHAT, LINK_PAGE_TYPE_MINI_GAME_WECHAT, LINK_PAGE_TYPE_FENGYE_ECOMMERCE, LINK_PAGE_TYPE_XJ_ANDROID_APP_H5, LINK_PAGE_TYPE_XJ_IOS_APP_H5, LINK_PAGE_TYPE_XJ_WEBSITE_H5, LINK_PAGE_TYPE_WECHAT_MOMENTS_SIMPLE_NATIVE, LINK_PAGE_TYPE_WECHAT_APPOINTMENT_CARD, LINK_PAGE_TYPE_WECHAT_CONSULT, LINK_PAGE_TYPE_WECHAT_MOMENTS_SUBSCRIPTION, LINK_PAGE_TYPE_WECHAT_RED_PACKET_COVER, LINK_PAGE_TYPE_WECHAT_VIDEO_TOPIC, LINK_PAGE_TYPE_WECHAT_OFFICIAL_ACCOUNT_DETAIL, LINK_PAGE_TYPE_XJ_QUICK, LINK_PAGE_TYPE_YOUZAN_WECHAT_MINIPROGRAM, LINK_PAGE_TYPE_WEIMOB_WECHAT_MINIPROGRAM }
link_name_type	enum	链接名称类型，[枚举详情] 枚举列表：{ NOT_USED, VIEW_DETAILS, GET_COUPONS, MAKE_AN_APPOINTMENT, BUY_NOW, GO_SHOPPING, ENTER_MINI_PROGRAM, ENTER_MINI_GAME, APPLY_NOW, BOOK_NOW, RESERVATION_BUY, CONSULT_NOW, BOOK_DRIVE, ENTER_OFFICIAL_ACCOUNTS, PLAY_NOW, OPEN_MINI_GAME, DOWNLOAD_APP, DOWNLOAD_GAME, GET_SAMPLES, TRY_NOW, GET_IT_NOW, BUY_ASAP, DOWNLOAD_NOW, VIEW_APPS, MORE_INFO, GET_VOUCHERS, FOLLOW_OFFICIAL_ACCOUNT, READ_NOVELS, WATCH_LIVE, RESERVE_NOW, OPEN_APP, ALREADY_INSTALL, SETUP_NOW, SECKILL_NOW, TRY_PLAY_NOW, INSTALL_NOW, MORE_ABOUT_OFFICIAL_ACCOUNT_CHT, FOLLOW_OFFICIAL_ACCOUNT_CHT, GET_FOR_FREE, WATCH_VIDEO, CARNIVAL_618, SURPRISE_618, DISCOUNT_618, GO_618_VENUE, GET_618_WELFARE, CONTACT_CUSTOMER_SERVICE, CONTACT_BUSINESS }
link_page_spec	struct	文字链跳转信息，根据不同 promoted_object_type 和 page_type、link_page_type，要求的 link_page_spec 信息不同
page_id	int64	落地页 id
page_url	string	落地页 url 字段长度最小 1 字节，长度最大 1023 字节
mini_program_spec	struct	小程序落地页，mini_program_id 和 mini_program_path 要同时填写
mini_program_id*	string	小程序 id 字段长度最小 1 字节，长度最大 384 字节
mini_program_path	string	小程序路径字段长度最小 1 字节，长度最大 2048 字节
mini_program_paths	string[]	小程序落地页 path 列表数组最小长度 1，最大长度 255 字段长度最小 1 字节，长度最大 2048 字节
mini_game_spec	struct	小游戏落地页信息
mini_game_tracking_parameter	string	小游戏监控参数，需以英文字符?开头，如：?channel=xxxx，字段长度最小 1 个等宽字符，长度最大 250 个等宽字符（即字段最大长度为 250 个中文字或全角标点，500 个英文字或半角标点。一个等宽字符等价于一个中文，等价于两个英文。）字段长度最小 0 字节，长度最大 750 字节
conversion_data_type	enum	数据展示的数据类型，素材下方展示账户内积累的展示推广目标相关的转化数据，吸引用户点击。投放指引：[枚举详情] 枚举列表：{ CONVERSION_DATA_DEFAULT, CONVERSION_DATA_FRIEND_PLAY, CONVERSION_DATA_APP_DOWNLOAD, CONVERSION_DATA_ONSHOP, CONVERSION_DATA_ADMETRIC, CONVERSION_DATA_FRIEND_FOLLOW }
conversion_target_type	enum	数据展示转化行为，仅 conversion_data_type 为 CONVERSION_DATA_ADMETRIC 时可设置可使用的版位可通过 [创意规格查询工具] 进行查询，[枚举详情] 枚举列表：{ CONVERSION_TARGET_DEFAULT, CONVERSION_TARGET_GET, CONVERSION_TARGET_RESERVE, CONVERSION_TARGET_BOOK, CONVERSION_TARGET_BUY, CONVERSION_TARGET_APPLY, CONVERSION_TARGET_CONSULT, CONVERSION_TARGET_DOWNLOAD, CONVERSION_TARGET_PLAYING, CONVERSION_TARGET_CLICK, CONVERSION_TARGET_SEE, CONVERSION_TARGET_INVOLVE, CONVERSION_TARGET_OPEN, CONVERSION_TARGET_PURCHASE, CONVERSION_TARGET_BROWSE, CONVERSION_TARGET_TRY, CONVERSION_TARGET_DRIVE, CONVERSION_TARGET_ENTER, CONVERSION_TARGET_READ, CONVERSION_TARGET_FOLLOW, CONVERSION_TARGET_USE, CONVERSION_TARGET_EXPERIENCE, CONVERSION_TARGET_SETUP, CONVERSION_TARGET_SECKILL }
qq_mini_game_tracking_query_string	string	QQ 小游戏监控参数字段长度最小 0 字节，长度最大 2048 字节
deep_link_url	string	应用直达页 URL，微信朋友圈广告（site_set=SITE_SET_MOMENTS）的创意形式，promoted_object_type 为 PROMOTED_OBJECT_TYPE_APP_ANDROID 时，需要同时填写 deeplink_ios_appid ；或 promoted_object_type 为 PROMOTED_OBJECT_TYPE_APP_IOS 时，需要同时填写 deeplink_anroid_appid，以确保双端都能支持应用直达。字段长度最小 0 字节，长度最大 2048 字节
android_deep_link_app_id	string	安卓应用直达 AppId 字段长度最小 0 字节，长度最大 128 字节
ios_deep_link_app_id	string	IOS 应用直达 AppId 字段长度最小 0 字节，长度最大 128 字节
universal_link_url	string	通用链接页 URL 字段长度最小 0 字节，长度最大 2048 字节
share_content_spec	struct	简版原生页分享信息，仅在部分朋友圈创意形式下设置有效，具体可通过创意形式查询工具或 adcreative_templates/get 接口进行查询，若该字段不为空，则表示投放简版原生推广页（点击图片后会跳转至系统自动生成的简版原生推广页）
share_title*	string	简版原生页分享标题，字段长度最小 1 个等宽字符，长度最大 14 个等宽字符（即字段最大长度为 14 个中文字或全角标点，28 个英文字或半角标点。一个等宽字符等价于一个中文，等价于两个英文。）
share_description*	string	简版原生页分享描述，字段长度最小 1 个等宽字符，长度最大 20 个等宽字符（即字段最大长度为 20 个中文字或全角标点，40 个英文字或半角标点。一个等宽字符等价于一个中文，等价于两个英文。）
profile_id	integer	朋友圈头像昵称跳转页 id，仅微信朋友圈广告（site_set=SITE_SET_MOMENTS）的创意形式支持
component_id	integer	附加创意组件 id 最小值 1，最大值 4294967295
online_enabled	boolean	是否开启“创意修改、广告不下线”功能，默认均为 false（不开启创意修改、原广告不下线功能）当且仅当广告创意的状态为审核通过，且 site_set !=SITE_SET_WECHAT 时，可将此字段设置为 true, 可选值：{ true, false }，true：是，false：否可选值：{ true, false }
revised_adcreative_spec	struct	修改后的创意内容，当且仅当 online_enabled = true 时，此字段允许写入
revised_adcreative_elements	struct	修改后的创意元素，填写要求同 adcreative_elements，当且仅当 online_enabled = true 时，此字段允许写入，创意元素
revised_page_spec	struct	修改后的落地页，填写要求同 page_spec，当且仅当 online_enabled = true 时，此字段允许写入，根据不同 promoted_object_type 和 page_type，要求的 page_spec 信息不同
page_id	int64	落地页 id
page_url	string	落地页 url 字段长度最小 1 字节，长度最大 1023 字节
union_market_switch	boolean	跳转厂商应用商店，用户点击广告后，将跳转到用户手机厂商商店的应用下载页面。因此，为保障转化率，请在“目标详情-转化归因”中使用全渠道归因，并确保应用在华为、OPPO、VIVO、小米应用商店上架，未上架的厂商请在“设备品牌型号”定向中屏蔽，否则将导致跳转失败。仅投放 SITE_SET_MOMENTS, SITE_SET_KANDIAN, SITE_SET_QQ_MUSIC_GAME, SITE_SET_MOBILE_INNER, SITE_SET_TENCENT_NEWS, SITE_SET_TENCENT_VIDEO 或 SITE_SET_MOBILE_UNION 时可设置；目前白名单开放中，如果需要使用请联系您的运营经理可选值：{ true, false }
playable_page_material_id	string	互动推广页落地页 id，（待废弃，请改为使用 video_end_page 进行设置）字段长度最小 1 字节，长度最大 20 字节
video_end_page	struct	视频播放结束页，（当前仅支持互动推广页）
end_page_id*	string	视频播放结束页 id 字段长度最小 1 字节，长度最大 20 字节
end_page_type*	enum	视频播放结束页类型，[枚举详情] 枚举列表：{ VIDEO_END_PAGE_TYPE_PLAY_H5 }
feeds_video_comment_switch	boolean	视频广告评论开关可选值：{ true, false }
webview_url	string	简易原生页嵌入 Webview url,和 simple_canvas_sub_type 配合使用，关系如下:SIMPLE_CANVAS_SUB_TYPE_URL,SIMPLE_CANVAS_SUB_TYPE_SLIDE_UP 时必填，SIMPLE_CANVAS_SUB_TYPE_WEB_STORE 时系统其他填充为 web store 地址，其他情况无效。域名仅支持数字、大小写字母、连字符等字符，且不支持绑定端口号，url 下的 path 支持 a-zA-Z0-9`~!@#%&_=;$^*()-+{}[]:,.?/\|等字符，示例：1. http[s]://abc-cd.ef.com/1Aa-Bb?a=123&b=123, 2. qb://weapp/?package 字段长度最小 0 字节，长度最大 1023 字节
simple_canvas_sub_type	enum	简版原生页子类型(灰度中)，仅在简版原生页下生效，其他情况改字段内容会被忽略，[枚举详情] 枚举列表：{ SIMPLE_CANVAS_SUB_TYPE_UNKNOWN, SIMPLE_CANVAS_SUB_TYPE_DEFAULT, SIMPLE_CANVAS_SUB_TYPE_URL, SIMPLE_CANVAS_SUB_TYPE_SLIDE_UP, SIMPLE_CANVAS_SUB_TYPE_WEB_STORE, SIMPLE_CANVAS_SUB_TYPE_CHOOSE }
floating_zone	struct	浮层卡片创意内容
floating_zone_switch*	boolean	浮层卡片开关可选值：{ true, false }
floating_zone_image_id	string	尺寸：512512，大小：不超过 50 KB，格式：.jpg\|.jpeg\|.png ；
floating_zone_name	string	文案一，字段长度最小 1 个等宽字符，长度最大 8 等宽字符（即字段最大长度为 8 个中文字或全角标点，16 个英文字或半角标点。一个等宽字符等价于一个中文，等价于两个英文。）
floating_zone_desc	string	文案二，字段长度最小 0 个等宽字符，长度最大 6 等宽字符（即字段最大长度为 6 个中文字或全角标点，12 个英文字或半角标点。一个等宽字符等价于一个中文，等价于两个英文。）
floating_zone_button_text	string	按钮文案，字段长度最小 0 个等宽字符，长度最大 4 等宽字符（即字段最大长度为 4 个中文字或全角标点，8 个英文字或半角标点。一个等宽字符等价于一个中文，等价于两个英文。）
floating_zone_type	enum	浮层卡片类型，[枚举详情] 枚举列表：{ FLOATING_ZONE_TYPE_UNKNOWN, FLOATING_ZONE_TYPE_IMAGE_TEXT, FLOATING_ZONE_TYPE_SINGLE_IMAGE, FLOATING_ZONE_TYPE_MULTI_BUTTON }
floating_zone_single_image_id	string	尺寸: 540276 ,大小：不超过 50 KB，格式：.jpg\|.jpeg\|.png ；
marketing_pendant_image_id	string	挂件图，悬浮展示在竖版视频上以展示营销卖点。在 [images 模块] 上传图片后获得该 id 并在参数中传入，上传图片时需指定 image_usage 字段。字段长度最小 1 字节，长度最大 64 字节仅在规格支持时传入，可通过 [创意规格查询工具] 查询字段长度最小 0 字节，长度最大 64 字节
countdown_switch	boolean	倒计时组件开关可选值：{ true, false }
head_click_type	enum	头像点击跳转信息，[枚举详情] 枚举列表：{ HEAD_CLICK_TYPE_DEFAULT, HEAD_CLICK_TYPE_CUSTOMIZED, HEAD_CLICK_TYPE_CELEBRITY_ACCOUNT, HEAD_CLICK_TYPE_VIRTUAL_ACCOUNT, HEAD_CLICK_TYPE_LIVE_PROFILE, HEAD_CLICK_TYPE_LIVE_EVENT, HEAD_CLICK_TYPE_BRAND_PROGRAM, HEAD_CLICK_TYPE_CNY_PROFILE }
head_click_spec	struct	头像点击跳转信息，目前支持跳转搜一搜品牌专区，白名单开放中，如果需要使用请联系您的运营经理
brand_app_id	string	搜一搜品牌形象 app id 字段长度最小 1 字节，长度最大 2048 字节
barrage_list	struct[]	弹幕列表数组最小长度 0，最大长度 20
id*	integer	弹幕 id
app_gift_pack_code	struct	礼包码，微信朋友圈广告创意形式需要填写，礼包码
code	string	礼包码，微信朋友圈广告创意形式需要填写，礼包码字段长度最小 0 字节，长度最大 450 字节
tips	string	礼包码提示，微信朋友圈广告创意形式需要填写，礼包码提示
industry_label	string	行业标签内容字段长度最小 0 字节，长度最大 2048 字节
union_market_spec	struct	厂商下载信息，厂商下载信息，仅可在跳转厂商应用商店（union_market_switch）值为 true 时使用。
union_market_jump_type	enum	厂商直达链接跳转类型，[枚举详情] 枚举列表：{ UNION_MARKET_JUMP_TYPE_DEFAULT, UNION_MARKET_JUMP_TYPE_LANDING_PAGE }
android_quick_app_spec	struct	安卓快应用跳转信息
android_quick_app_jump_type*	enum	安卓快应用跳转类型，[枚举详情] 枚举列表：{ ANDROID_QUICK_APP_JUMP_TYPE_DEFAULT, ANDROID_QUICK_APP_JUMP_TYPE_LANDING_PAGE }
android_quick_app_jump_url*	string	安卓快应用跳转 URL 字段长度最小 0 字节，长度最大 2048 字节

使用说明

修改广告创意（修改 adcreative_name 除外），将会导致引用它的所有广告进行待审核状态。
对于朋友圈广告（campaign_type=CAMPAIGN_TYPE_WECHAT_MOMENTS），一旦广告审核通过且当前时间大于广告投放起始时间，则不允许修改 adcreative_name 外的字段。
DPA 广告功能灰度开放，如有接入需求，请联系对接渠道运营同事线下进行申请。

请求示例


curl 'https://api.e.qq.com/v1.1/adcreatives/update?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id=<ACCOUNT_ID>' \
-d 'adcreative_id=<ADCREATIVE_ID>' \
-d 'adcreative_name=广告创意' \
-d 'adcreative_elements={"image":"123456"}' \
-d 'page_type=PAGE_TYPE_DEFAULT' \
-d 'page_spec={"page_url":"https://www.example.com"}' \
-d 'link_page_spec={
    "mini_program_spec": {
        "mini_program_paths": []
    },
    "mini_game_spec": []
}' \
-d 'share_content_spec=[]' \
-d 'revised_adcreative_spec={
    "revised_adcreative_elements": {
        "corporate": [],
        "image_list": [],
        "element_story": [],
        "mini_program_paths": [],
        "label": [],
        "product_tags": [],
        "short_video_struct": [],
        "long_video_struct": [],
        "banner_content": [],
        "card_content": [],
        "video_popup_button": [],
        "brand": [],
        "labelled_img": {
            "label": []
        },
        "end_page": [],
        "shop_image_struct": [],
        "chosen_button": {
            "chosen_button_landing_page1": {
                "page_spec": {
                    "page_url": "https://www.example.com"
                },
                "page_type": "PAGE_TYPE_DEFAULT",
                "landing_page_info": []
            },
            "chosen_button_landing_page2": {
                "page_spec": {
                    "page_url": "https://www.example.com"
                },
                "page_type": "PAGE_TYPE_DEFAULT",
                "landing_page_info": []
            }
        },
        "living_desc_struct": {
            "living_desc_list": []
        },
        "floating_zone_struct": [],
        "wegame_info_spec": []
    },
    "revised_page_spec": []
}' \
-d 'video_end_page=[]' \
-d 'floating_zone=[]' \
-d 'head_click_spec=[]' \
-d 'barrage_list=[]' \
-d 'app_gift_pack_code={
    "code": 0
}' \
-d 'union_market_spec=[]' \
-d 'android_quick_app_spec=[]'

应答字段

名称	类型	描述
adcreative_id	int64	广告创意 id

应答示例

{
    "code": 0,
    "message": "",
    "message_cn": "",
    "data": {
        "adcreative_id": "<ADCREATIVE_ID>"
    }
}

可视化调试工具

获取广告创意
全部接口
V1.1
loading

所属权限	Ads Management,Ads Insights
请求地址	adcreatives/get
请求方法	get

全局参数

全局参数是指每一个接口都需要使用到的参数。详情参考，代码案例参考。

参数名称	参数类型
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
filtering	struct[]	过滤条件，若此字段不传，或传空则视为无限制条件，详见 [过滤条件] 数组最小长度 1，最大长度 5
field*	string	过滤字段可选值：{ adcreative_id, adcreative_name, campaign_id, promoted_object_type, adcreative_template_id, created_time, last_modified_time, product_mode, product_source, barrage_list, enable_breakthrough_siteset, source }
operator*	enum	操作符当 field 取值 adcreative_id 时，枚举列表：{ EQUALS, IN } 当 field 取值 adcreative_name 时，枚举列表：{ EQUALS, CONTAINS } 当 field 取值 product_mode 时，枚举列表：{ EQUALS } 当 field 取值 product_source 时，枚举列表：{ EQUALS } 当 field 取值 campaign_id 时，枚举列表：{ EQUALS } 当 field 取值 promoted_object_type 时，枚举列表：{ EQUALS } 当 field 取值 adcreative_template_id 时，枚举列表：{ EQUALS } 当 field 取值 created_time 时，枚举列表：{ EQUALS, LESS_EQUALS, LESS, GREATER_EQUALS, GREATER } 当 field 取值 last_modified_time 时，枚举列表：{ EQUALS, LESS_EQUALS, LESS, GREATER_EQUALS, GREATER } 当 field 取值 source 时，枚举列表：{ EQUALS }
values*	string[]	字段取值，values 数组的个数限制与 operator 的取值相关，详见 [过滤条件] 当 field 取值 adcreative_name 时，字段长度最小 1 字节，长度最大 180 字节当 field 取值 promoted_object_type 时，枚举列表：{ PROMOTED_OBJECT_TYPE_APP_ANDROID, PROMOTED_OBJECT_TYPE_APP_IOS, PROMOTED_OBJECT_TYPE_ECOMMERCE, PROMOTED_OBJECT_TYPE_LINK_WECHAT, PROMOTED_OBJECT_TYPE_APP_ANDROID_MYAPP, PROMOTED_OBJECT_TYPE_APP_ANDROID_UNION, PROMOTED_OBJECT_TYPE_LOCAL_ADS_WECHAT, PROMOTED_OBJECT_TYPE_QQ_BROWSER_MINI_PROGRAM, PROMOTED_OBJECT_TYPE_LINK, PROMOTED_OBJECT_TYPE_QQ_MESSAGE, PROMOTED_OBJECT_TYPE_QZONE_VIDEO_PAGE, PROMOTED_OBJECT_TYPE_LOCAL_ADS, PROMOTED_OBJECT_TYPE_ARTICLE, PROMOTED_OBJECT_TYPE_LEAD_AD, PROMOTED_OBJECT_TYPE_TENCENT_KE, PROMOTED_OBJECT_TYPE_QZONE_PAGE_ARTICLE, PROMOTED_OBJECT_TYPE_QZONE_PAGE_IFRAMED, PROMOTED_OBJECT_TYPE_QZONE_PAGE, PROMOTED_OBJECT_TYPE_APP_PC, PROMOTED_OBJECT_TYPE_MINI_GAME_WECHAT, PROMOTED_OBJECT_TYPE_MINI_GAME_QQ, PROMOTED_OBJECT_TYPE_WECHAT_CHANNELS, PROMOTED_OBJECT_TYPE_WECHAT_OFFICIAL_ACCOUNT, PROMOTED_OBJECT_TYPE_MINI_PROGRAM_WECHAT, PROMOTED_OBJECT_TYPE_APP_QUICK_APP } 当 field 取值 created_time 时，字段长度为 10 字节当 field 取值 last_modified_time 时，字段长度为 10 字节当 field 取值 product_mode 时，枚举列表：{ SINGLE, MULTIPLE } 当 field 取值 product_source 时，字段长度最小 1 字节，长度最大 180 字节当 field 取值 source 时，枚举列表：{ AD_CREATIVE_SOURCE_NORMAL, AD_CREATIVE_AUTO_DERIVE, AD_CREATIVE_AUTO_GENERATE }
page	integer	搜索页码，默认值：1 最小值 1，最大值 99999
page_size	integer	一页显示的数据条数，默认值：10。最小值 1，最大值 100
is_deleted	boolean	是否已删除，true：是，false：否可选值：{ true, false }
link_page_type_compatible	boolean	是否返回旧结构文字链数据可选值：{ true, false }

使用说明

is_deleted 参数不传时默认为 false，只返回未删除记录。
is_deleted 参数为 true 时，需要同时在 filtering 传参数 last_modified_time。
当根据广告创意 id 进行查询且 is_deleted 参数不传或为 false 时，获取的广告创意列表包含已删除的广告创意。

请求示例


curl -G 'https://api.e.qq.com/v1.1/adcreatives/get?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id=<ACCOUNT_ID>' \
-d 'filtering=[{"field":"adcreative_name","operator":"EQUALS","values":["广告创意"]}]' \
-d 'page=1' \
-d 'page_size=10' \
-d 'is_deleted=false'

应答字段

名称	类型	描述
list	struct[]	返回信息列表
campaign_id	int64	推广计划 id
adcreative_id	int64	广告创意 id
adcreative_name	string	广告创意名称
adcreative_template_id	integer	创意形式 id，具体请咨询您的运营接口人，也可通过创意形式查询工具进行查询
adcreative_elements	struct	创意元素，不同 adcreative_template_id 要求的元素不尽相同，其中部分创意形式的文案元素支持换行能力，使用“\n ”表示换行，占 0.5 个等宽字符，建议行数不超过 6 行，具体情况可通过 [创意规格查询工具] 进行查询
page_type	enum	落地页类型，[枚举详情]
page_spec	struct	落地页信息，根据不同 promoted_object_type 和 page_type，要求的 page_spec 信息不同
page_id	int64	落地页 id
page_url	string	落地页 url
mini_program_spec	struct	小程序落地页，mini_program_id 和 mini_program_path 要同时填写
mini_program_id	string	小程序 id
mini_program_path	string	小程序路径
mini_program_paths	string[]	小程序落地页 path 列表
mini_game_spec	struct	小游戏落地页信息
mini_game_tracking_parameter	string	小游戏监控参数，需以英文字符?开头，如：?channel=xxxx，字段长度最小 1 个等宽字符，长度最大 250 个等宽字符（即字段最大长度为 250 个中文字或全角标点，500 个英文字或半角标点。一个等宽字符等价于一个中文，等价于两个英文。）
mini_game_openlink	string	openlink 地址字段，当投放版位含优量汇时、推广目标是微信小游戏推广目标时，支持填写「微信小游戏落地页的 openlink 地址」（白名单灰度中），什么是 opelink 可参考[微信开放文档]
mini_game_openlink_page_spec	struct	小游戏蹊径落地页，当投放版位含优量汇时、推广目标是微信小游戏推广目标时，落地页使用「微信小游戏」落地页时，支持使用「蹊径落地页」（白名单灰度中）；注意不能同时和「 mini_game_openlink 」同时使用，否则会被蹊径落地页链接覆盖。
landing_page_type	enum	openlink 落地页页面类型，不大于 1024 个英文字符或数字，[枚举详情]
landing_page_id	integer	落地页 id
override_canvas_head_option	enum	原生推广页顶部素材和广告创意素材之间的替换关系，（仅在朋友圈广告使用原生推广页情况下有效），[枚举详情]
dynamic_product_spec	struct	动态多商品广告落地页信息，仅支持 MDPA 广告使用动态落地页(见 dynamic_adcreative_spec.landing_page_url_type) 时填写
page_url	string	动态落地页 url
mini_program_paths	string[]	动态多商品广告小程序落地页 path 列表
link_page_type	enum	文字链跳转类型类型，[枚举详情]
link_name_type	enum	链接名称类型，[枚举详情]
link_page_spec	struct	文字链跳转信息，根据不同 promoted_object_type 和 page_type、link_page_type，要求的 link_page_spec 信息不同
page_id	int64	落地页 id
page_url	string	落地页 url
mini_program_spec	struct	小程序落地页，mini_program_id 和 mini_program_path 要同时填写
mini_program_id	string	小程序 id
mini_program_path	string	小程序路径
mini_program_paths	string[]	小程序落地页 path 列表
mini_game_spec	struct	小游戏落地页信息
mini_game_tracking_parameter	string	小游戏监控参数，需以英文字符?开头，如：?channel=xxxx，字段长度最小 1 个等宽字符，长度最大 250 个等宽字符（即字段最大长度为 250 个中文字或全角标点，500 个英文字或半角标点。一个等宽字符等价于一个中文，等价于两个英文。）
conversion_data_type	enum	数据展示的数据类型，素材下方展示账户内积累的展示推广目标相关的转化数据，吸引用户点击。投放指引：[枚举详情]
conversion_target_type	enum	数据展示转化行为，仅 conversion_data_type 为 CONVERSION_DATA_ADMETRIC 时可设置可使用的版位可通过 [创意规格查询工具] 进行查询，[枚举详情]
qq_mini_game_tracking_query_string	string	QQ 小游戏监控参数
deep_link_url	string	应用直达页 URL，微信朋友圈广告（site_set=SITE_SET_MOMENTS）的创意形式，promoted_object_type 为 PROMOTED_OBJECT_TYPE_APP_ANDROID 时，需要同时填写 deeplink_ios_appid ；或 promoted_object_type 为 PROMOTED_OBJECT_TYPE_APP_IOS 时，需要同时填写 deeplink_anroid_appid，以确保双端都能支持应用直达。
android_deep_link_app_id	string	安卓应用直达 AppId
ios_deep_link_app_id	string	IOS 应用直达 AppId
universal_link_url	string	通用链接页 URL
site_set	enum[]	投放版位集合，当前单版位或者 SITE_SET_TENCENT_NEWS+SITE_SET_TENCENT_VIDEO+SITE_SET_MOBILE_UNION+SITE_SET_KANDIAN+SITE_SET_QQ_MUSIC_GAME 的组合，[枚举详情]
automatic_site_enabled	boolean	是否开启自动版位功能（暂不包含 SITE_SET_WECHAT 和 SITE_SET_MOMENTS），此字段与 site_set 字段至少需要写入一个。
promoted_object_type	enum	推广目标类型，[枚举详情]
promoted_object_id	string	推广目标 id，详见 [查询推广目标 id]
profile_id	integer	朋友圈头像昵称跳转页 id，仅微信朋友圈广告（site_set=SITE_SET_MOMENTS）的创意形式支持
created_time	integer	创建时间（时间戳）
last_modified_time	integer	最后修改时间（时间戳）
share_content_spec	struct	分享信息
share_title	string	，分享标题
share_description	string	，分享描述
dynamic_adcreative_spec	struct	动态商品广告属性，当创意为动态商品广告创意时，该字段必填
product_catalog_id	integer	商品库 id
product_mode	enum	动态商品广告（DPA）类型，支持单商品动态商品广告（SDPA）和多商品动态商品广告（MDPA），[枚举详情]
product_source	string	动态商品广告所使用的商品信息,可以填入商品系列 id 或者商品 id
product_exposure_quantity_mode	enum	动态商品广告推荐的商品数量模式，当广告形态为动态多商品广告时，该字段必填，[枚举详情]
landing_page_url_type	enum	MDPA 落地页类型，当创意为动态多商品广告创意时，该字段必填，[枚举详情]
is_deleted	boolean	是否已删除，true：是，false：否
is_dynamic_creative	boolean	是否是动态创意广告自动生成的，true：是，false：否
component_id	integer	附加创意组件 id
online_enabled	boolean	是否开启“创意修改、广告不下线”功能
revised_adcreative_spec	struct	修改后的创意内容，当且仅当 online_enabled = true 时，此字段允许写入
revised_adcreative_elements	struct	修改后的创意元素，填写要求同 adcreative_elements，当且仅当 online_enabled = true 时，此字段允许写入，创意元素
revised_page_spec	struct	修改后的落地页，填写要求同 page_spec，当且仅当 online_enabled = true 时，此字段允许写入，根据不同 promoted_object_type 和 page_type，要求的 page_spec 信息不同
page_id	int64	落地页 id
page_url	string	落地页 url
union_market_switch	boolean	跳转厂商应用商店，用户点击广告后，将跳转到用户手机厂商商店的应用下载页面。因此，为保障转化率，请在“目标详情-转化归因”中使用全渠道归因，并确保应用在华为、OPPO、VIVO、小米应用商店上架，未上架的厂商请在“设备品牌型号”定向中屏蔽，否则将导致跳转失败。仅投放 SITE_SET_MOMENTS, SITE_SET_KANDIAN, SITE_SET_QQ_MUSIC_GAME, SITE_SET_MOBILE_INNER, SITE_SET_TENCENT_NEWS, SITE_SET_TENCENT_VIDEO 或 SITE_SET_MOBILE_UNION 时可设置；目前白名单开放中，如果需要使用请联系您的运营经理
playable_page_material_id	string	互动推广页落地页 id，（待废弃，请改为使用 video_end_page 进行设置）
video_end_page	struct	视频播放结束页，（当前仅支持互动推广页）
end_page_id	string	视频播放结束页 id
end_page_type	enum	视频播放结束页类型，[枚举详情]
feeds_video_comment_switch	boolean	视频广告评论开关
webview_url	string	简易原生页嵌入 Webview url,和 simple_canvas_sub_type 配合使用，关系如下:SIMPLE_CANVAS_SUB_TYPE_URL,SIMPLE_CANVAS_SUB_TYPE_SLIDE_UP 时必填，SIMPLE_CANVAS_SUB_TYPE_WEB_STORE 时系统其他填充为 web store 地址，其他情况无效。域名仅支持数字、大小写字母、连字符等字符，且不支持绑定端口号，url 下的 path 支持 a-zA-Z0-9`~!@#%&_=;$^*()-+{}[]:,.?/\|等字符，示例：1. http[s]://abc-cd.ef.com/1Aa-Bb?a=123&b=123, 2. qb://weapp/?package
simple_canvas_sub_type	enum	简版原生页子类型(灰度中)，仅在简版原生页下生效，其他情况改字段内容会被忽略，[枚举详情]
floating_zone	struct	浮层卡片创意内容
floating_zone_switch	boolean	浮层卡片开关
floating_zone_image_id	string	卡片图片
floating_zone_name	string
floating_zone_desc	string
floating_zone_button_text	string
floating_zone_type	enum	浮层卡片类型，[枚举详情]
floating_zone_single_image_id	string	卡片单图
marketing_pendant_image_id	string	挂件图，悬浮展示在竖版视频上以展示营销卖点。在 [images 模块] 上传图片后获得该 id 并在参数中传入，上传图片时需指定 image_usage 字段。字段长度最小 1 字节，长度最大 64 字节仅在规格支持时传入，可通过 [创意规格查询工具] 查询
countdown_switch	boolean	倒计时组件开关
source	enum	创意来源，[枚举详情]
page_track_url	string	页面级转化跟踪 URL(可选)
head_click_type	enum	头像点击跳转信息，[枚举详情]
head_click_spec	struct	头像点击跳转信息，目前支持跳转搜一搜品牌专区，白名单开放中，如果需要使用请联系您的运营经理
brand_app_id	string	搜一搜品牌形象 app id
barrage_list	struct[]	弹幕列表
id	integer	弹幕 id
text	string	弹幕文案，1~12 个字
app_gift_pack_code	struct	礼包码，微信朋友圈广告创意形式需要填写，礼包码
code	string	礼包码，微信朋友圈广告创意形式需要填写，礼包码
tips	string	礼包码提示，微信朋友圈广告创意形式需要填写，礼包码提示
enable_breakthrough_siteset	boolean	是否支持版位突破，广告版位选择“微信朋友圈”，当广告有机会获得更多曝光与转化时，将可能投放到微信公众号与小程序版位，若不传值默认为 true
creative_template_version_type	enum	数据版本类型 0:历史数据 1:旧版本 2:新版本，[枚举详情]
industry_label	string	行业标签内容
union_market_spec	struct	厂商下载信息，厂商下载信息，仅可在跳转厂商应用商店（union_market_switch）值为 true 时使用。
union_market_jump_type	enum	厂商直达链接跳转类型，[枚举详情]
creative_template_category	string	创意形式类型
android_quick_app_spec	struct	安卓快应用跳转信息
android_quick_app_jump_type	enum	安卓快应用跳转类型，[枚举详情]
android_quick_app_jump_url	string	安卓快应用跳转 URL
page_info	struct	分页配置信息
page	integer	搜索页码
page_size	integer	一页显示的数据条数
total_number	integer	总条数
total_page	integer	总页数

应答示例

{
    "code": 0,
    "message": "",
    "message_cn": "",
    "data": {
        "list": [
            {
                "campaign_id": "<CAMPAIGN_ID>",
                "adcreative_id": "<ADCREATIVE_ID>",
                "adcreative_name": "广告创意",
                "adcreative_template_id": "<ADCREATIVE_TEMPLATE_ID>",
                "adcreative_elements": {
                    "image": "123456"
                },
                "page_type": "PAGE_TYPE_DEFAULT",
                "page_spec": {
                    "page_url": "https://www.example.com"
                },
                "link_page_spec": {
                    "mini_program_spec": {
                        "mini_program_paths": []
                    },
                    "mini_game_spec": []
                },
                "site_set": [
                    "SITE_SET_WECHAT"
                ],
                "promoted_object_type": "PROMOTED_OBJECT_TYPE_LINK_WECHAT",
                "created_time": 1491019858,
                "last_modified_time": 1491098468,
                "share_content_spec": [],
                "is_deleted": false,
                "revised_adcreative_spec": {
                    "revised_adcreative_elements": {
                        "corporate": [],
                        "image_list": [],
                        "element_story": [],
                        "mini_program_paths": [],
                        "label": [],
                        "product_tags": [],
                        "short_video_struct": [],
                        "long_video_struct": [],
                        "banner_content": [],
                        "card_content": [],
                        "video_popup_button": [],
                        "brand": [],
                        "labelled_img": {
                            "label": []
                        },
                        "end_page": [],
                        "shop_image_struct": [],
                        "chosen_button": {
                            "chosen_button_landing_page1": {
                                "page_spec": {
                                    "page_url": "https://www.example.com"
                                },
                                "page_type": "PAGE_TYPE_DEFAULT",
                                "landing_page_info": []
                            },
                            "chosen_button_landing_page2": {
                                "page_spec": {
                                    "page_url": "https://www.example.com"
                                },
                                "page_type": "PAGE_TYPE_DEFAULT",
                                "landing_page_info": []
                            }
                        },
                        "living_desc_struct": {
                            "living_desc_list": []
                        },
                        "floating_zone_struct": [],
                        "wegame_info_spec": []
                    },
                    "revised_page_spec": []
                },
                "video_end_page": [],
                "floating_zone": [],
                "head_click_spec": [],
                "barrage_list": [],
                "app_gift_pack_code": {
                    "code": 0
                },
                "union_market_spec": [],
                "android_quick_app_spec": []
            }
        ],
        "page_info": {
            "page": 1,
            "page_size": 10,
            "total_number": 1,
            "total_page": 1
        }
    }
}

可视化调试工具

删除广告创意
全部接口
V1.1
loading

所属权限	Ads Management
请求地址	adcreatives/delete
请求方法	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
adcreative_id*	int64	广告创意 id

使用说明

删除广告创意后，引用它的所有广告将会停止曝光，但该广告创意关联的广告不会被自动删除。
朋友圈广告不允许删除广告创意。

请求示例


curl 'https://api.e.qq.com/v1.1/adcreatives/delete?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id=<ACCOUNT_ID>' \
-d 'adcreative_id=<ADCREATIVE_ID>'

应答字段

名称	类型	描述
adcreative_id	int64	广告创意 id

应答示例

{
    "code": 0,
    "message": "",
    "message_cn": "",
    "data": {
        "adcreative_id": "<ADCREATIVE_ID>"
    }
}

可视化调试工具

创建动态创意
全部接口
V1.1
loading

所属权限	Ads Management
请求地址	dynamic_creatives/add
请求方法	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_name*	string	广告创意名称，同一帐号下的广告创意名称不允许重复（字段长度最小 1 个等宽字符，长度最大 60 等宽字符（即字段最大长度为 60 个中文字或全角标点，120 个英文字或半角标点。一个等宽字符等价于一个中文，等价于两个英文。）字段长度最小 1 字节，长度最大 180 字节
dynamic_creative_template_id	integer	创意规格 id，具体请咨询您的运营接口人，也可通过 [创意规格查询工具] 进行查询，dynamic_creative_type 为 DYNAMIC_CREATIVE_TYPE_PROGRAM 时不传该参数
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，最大长度 9 字段长度最小 1 字节，长度最大 384 字节
image_list_options	array[]	注意，该结构为二维数组，外层数组中的每个元素为 imgae_list，内层数组中的元素为 image，示例：image_list_options:[[image1_1, image1_2],[image2_1, image2_2]]，图片墙数组最小长度 0，最大长度 9 数组最小长度 1，最大长度 12
title_options	string[]	广告文案数组最小长度 0，最大长度 3 字段长度最小 1 字节，长度最大 10240 字节
description_options	string[]	广告描述数组最小长度 0，最大长度 3 字段长度最小 1 字节，长度最大 360 字节
video_options	string[]	视频数组最小长度 0，最大长度 9 字段长度最小 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, BOOK_NOW, RESERVATION_BUY, CONSULT_NOW, BOOK_DRIVE, ENTER_OFFICIAL_ACCOUNTS, PLAY_NOW, OPEN_MINI_GAME, DOWNLOAD_APP, DOWNLOAD_GAME, GET_SAMPLES, TRY_NOW, GET_IT_NOW, BUY_ASAP, DOWNLOAD_NOW, VIEW_APPS, MORE_INFO, GET_VOUCHERS, FOLLOW_OFFICIAL_ACCOUNT, READ_NOVELS, WATCH_LIVE, RESERVE_NOW, OPEN_APP, ALREADY_INSTALL, RESERVE_LIVE, SETUP_NOW, SECKILL_NOW, TRY_PLAY_NOW, INSTALL_NOW, MORE_ABOUT_OFFICIAL_ACCOUNT_CHT, FOLLOW_OFFICIAL_ACCOUNT_CHT, GET_FOR_FREE, CARNIVAL_618, SURPRISE_618, DISCOUNT_618, GO_618_VENUE, GET_618_WELFARE, CONTACT_CUSTOMER_SERVICE, CONTACT_BUSINESS }
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_begin	integer	倒计时开始时间戳，unix 时间戳，单位秒最小值 0，最大值 9999999999
countdown_expiring_timestamp	integer	倒计时截止时间戳，unix 时间戳，单位秒最小值 1000000000，最大值 9999999999
countdown_price	string	倒计时价格字段长度最小 0 字节，长度最大 10 字节
countdown_time_type	enum	倒计时时间类型 0:距离活动开始 1:距离活动结束，[枚举详情] 枚举列表：{ COUNTDOWN_TIME_START, COUNTDOWN_TIME_END }
mini_program_id	string	小程序 id 字段长度最小 1 字节，长度最大 384 字节
mini_program_path	string	小程序路径字段长度最小 1 字节，长度最大 2048 字节
label	struct[]	标签数组数组最小长度 1，最大长度 255
content*	string	标签内容字段长度最小 1 字节，长度最大 255 字节
type	enum	创意标签类型，[枚举详情] 枚举列表：{ LABEL_TYPE_COMMON, LABEL_TYPE_CUSTOMIZETEXT, LABEL_TYPE_ICON }
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 字节，长度最大 192 字节
brand_description	string	广告文案字段长度最小 1 字节，长度最大 42 字节
caption	string	消息标题字段长度最小 1 字节，长度最大 96 字节
head_line	string	消息标题字段长度最小 1 字节，长度最大 192 字节
shop_image_struct	struct	卖点图
shop_image_switch	boolean	卖点图开关可选值：{ true, false }
dynamic_shop_image_switch	boolean	卖点图轮播开关可选值：{ true, false }
shop_image_id	string	卖点图片 id 字段长度最小 1 字节，长度最大 2048 字节
shop_image_title	string	卖点图标题字段长度最小 1 字节，长度最大 2048 字节
shop_image_description	string	卖点图文案字段长度最小 1 字节，长度最大 2048 字节
chosen_button	struct	选择按钮
chosen_button_text1	string	左侧按钮文字字段长度最小 1 字节，长度最大 192 字节
chosen_button_landing_page1	struct	跳转落地页信息
page_spec	struct	落地页信息，根据不同 promoted_object_type 和 page_type，要求的 page_spec 信息不同
page_id	int64	落地页 id
page_url	string	落地页 url 字段长度最小 1 字节，长度最大 1023 字节
mini_program_spec	struct	小程序落地页，mini_program_id 和 mini_program_path 要同时填写
mini_program_id*	string	小程序 id 字段长度最小 1 字节，长度最大 384 字节
mini_program_path	string	小程序路径字段长度最小 1 字节，长度最大 2048 字节
mini_program_paths	string[]	小程序落地页 path 列表数组最小长度 1，最大长度 255 字段长度最小 1 字节，长度最大 2048 字节
mini_game_spec	struct	小游戏落地页信息
mini_game_tracking_parameter	string	小游戏监控参数，需以英文字符?开头，如：?channel=xxxx，字段长度最小 1 个等宽字符，长度最大 250 个等宽字符（即字段最大长度为 250 个中文字或全角标点，500 个英文字或半角标点。一个等宽字符等价于一个中文，等价于两个英文。）字段长度最小 0 字节，长度最大 750 字节
mini_game_openlink	string	openlink 地址字段，当投放版位含优量汇时、推广目标是微信小游戏推广目标时，支持填写「微信小游戏落地页的 openlink 地址」（白名单灰度中），什么是 opelink 可参考[微信开放文档] 字段长度最小 0 字节，长度最大 2048 字节
mini_game_openlink_page_spec	struct	小游戏蹊径落地页，当投放版位含优量汇时、推广目标是微信小游戏推广目标时，落地页使用「微信小游戏」落地页时，支持使用「蹊径落地页」（白名单灰度中）；注意不能同时和「 mini_game_openlink 」同时使用，否则会被蹊径落地页链接覆盖。
landing_page_type*	enum	openlink 落地页页面类型，不大于 1024 个英文字符或数字，[枚举详情] 枚举列表：{ LANDING_PAGE_TYPE_XJ_WEBSITE_H5 }
landing_page_id*	integer	落地页 id
override_canvas_head_option	enum	原生推广页顶部素材和广告创意素材之间的替换关系，（仅在朋友圈广告使用原生推广页情况下有效），[枚举详情] 枚举列表：{ OPTION_CANVAS_OVERRIDE_CREATIVE, OPTION_CREATIVE_OVERRIDE_CANVAS, OPTION_KEEP_DIFFERENT }
dynamic_product_spec	struct	动态多商品广告落地页信息，仅支持 MDPA 广告使用动态落地页(见 dynamic_adcreative_spec.landing_page_url_type) 时填写
page_url	string	动态落地页 url 字段长度最小 1 字节，长度最大 1023 字节
mini_program_paths	string[]	动态多商品广告小程序落地页 path 列表数组最小长度 1，最大长度 6 字段长度最小 1 字节，长度最大 2048 字节
page_type	enum	落地页类型，[枚举详情] 枚举列表：{ PAGE_TYPE_DEFAULT, PAGE_TYPE_TSA_APP, PAGE_TYPE_TSA_WEB_NONE_ECOMMERCE, PAGE_TYPE_CANVAS_WECHAT, PAGE_TYPE_MINI_PROGRAM_WECHAT, PAGE_TYPE_FENGYE_ECOMMERCE, PAGE_TYPE_MINI_GAME_WECHAT, PAGE_TYPE_MOMENTS_SIMPLE_NATIVE_WECHAT, PAGE_TYPE_MINI_PROGRAM_CANVAS_WECHAT, PAGE_TYPE_MINI_GAME_QQ, PAGE_TYPE_MINI_PROGRAM_QQ, PAGE_TYPE_FENGSHU_MINI_PROGRAM, PAGE_TYPE_FENGYE_EC_WECHAT_MINIPROGRAM, PAGE_TYPE_YUEBAO_QUICKAPP, PAGE_TYPE_YUEBAO_OFFICIAL_ACCOUNT_ARTICLE, PAGE_TYPE_XIJING_QUICK }
link_name_type	enum	链接名称类型，[枚举详情] 枚举列表：{ NOT_USED, VIEW_DETAILS, GET_COUPONS, MAKE_AN_APPOINTMENT, BUY_NOW, GO_SHOPPING, ENTER_MINI_PROGRAM, ENTER_MINI_GAME, APPLY_NOW, BOOK_NOW, RESERVATION_BUY, CONSULT_NOW, BOOK_DRIVE, ENTER_OFFICIAL_ACCOUNTS, PLAY_NOW, OPEN_MINI_GAME, DOWNLOAD_APP, DOWNLOAD_GAME, GET_SAMPLES, TRY_NOW, GET_IT_NOW, BUY_ASAP, DOWNLOAD_NOW, VIEW_APPS, MORE_INFO, GET_VOUCHERS, FOLLOW_OFFICIAL_ACCOUNT, READ_NOVELS, WATCH_LIVE, RESERVE_NOW, OPEN_APP, ALREADY_INSTALL, SETUP_NOW, SECKILL_NOW, TRY_PLAY_NOW, INSTALL_NOW, MORE_ABOUT_OFFICIAL_ACCOUNT_CHT, FOLLOW_OFFICIAL_ACCOUNT_CHT, GET_FOR_FREE, WATCH_VIDEO, CARNIVAL_618, SURPRISE_618, DISCOUNT_618, GO_618_VENUE, GET_618_WELFARE, CONTACT_CUSTOMER_SERVICE, CONTACT_BUSINESS }
landing_page_platform	enum	落地页制作平台，[枚举详情] 枚举列表：{ LANDING_PAGE_PLATFORM_UNKNOWN, LANDING_PAGE_PLATFORM_TSA, LANDING_PAGE_PLATFORM_FENGYE_EC, LANDING_PAGE_PLATFORM_FENGYE_DEFAULT, LANDING_PAGE_PLATFORM_XIJING, LANDING_PAGE_PLATFORM_YOUZAN, LANDING_PAGE_PLATFORM_MP, LANDING_PAGE_PLATFORM_APP_STORE, LANDING_PAGE_PLATFORM_YIYE, LANDING_PAGE_PLATFORM_JINSHUJU, LANDING_PAGE_PLATFORM_WEIMOB, LANDING_PAGE_PLATFORM_QQ_MOBILE, LANDING_PAGE_PLATFORM_QQ_BROWSER, LANDING_PAGE_PLATFORM_PLAY, LANDING_PAGE_PLATFORM_YUEBAO, LANDING_PAGE_PLATFORM_HEBANG, LANDING_PAGE_PLATFORM_HELIANG, LANDING_PAGE_PLATFORM_MADAO, LANDING_PAGE_PLATFORM_ZHONGZHI }
landing_page_info	struct	品牌形象
landing_page_type	enum	落地页页面类型，不大于 1024 个英文字符或数字，[枚举详情] 枚举列表：{ LANDING_PAGE_TYPE_UNKNOWN, LANDING_PAGE_TYPE_ANDROID_APP, LANDING_PAGE_TYPE_IOS_APP, LANDING_PAGE_TYPE_FENGYE_WEB, LANDING_PAGE_TYPE_FENGYE_LBS, LANDING_PAGE_TYPE_NATIVE, LANDING_PAGE_TYPE_ANDROID_APP_NATIVE, LANDING_PAGE_TYPE_IOS_APP_NATIVE, LANDING_PAGE_TYPE_XJ_ANDROID_APP_H5, LANDING_PAGE_TYPE_XJ_IOS_APP_H5, LANDING_PAGE_TYPE_XJ_WEBSITE_H5, LANDING_PAGE_TYPE_XJ_WEBSITE_NATIVE, LANDING_PAGE_TYPE_XJ_ANDROID_APP_NATIVE, LANDING_PAGE_TYPE_XJ_IOS_APP_NATIVE, LANDING_PAGE_TYPE_FENGYE_EC_SINGLE, LANDING_PAGE_TYPE_FENGYE_EC_TOGETHER, LANDING_PAGE_TYPE_FENGYE_EC_FOCUS, LANDING_PAGE_TYPE_FENGYE_EC_COMMON, LANDING_PAGE_TYPE_FENGYE_EC_WECHAT_MINIPROGRAM, LANDING_PAGE_TYPE_PLAY_H5, LANDING_PAGE_TYPE_YOUZAN_SINGLE, LANDING_PAGE_TYPE_YOUZAN_TOGETHER, LANDING_PAGE_TYPE_YOUZAN_WECHAT_MINIPROGRAM, LANDING_PAGE_TYPE_YIYE_FORM, LANDING_PAGE_TYPE_JINSHUJU_FORM, LANDING_PAGE_TYPE_WEIMOB_PRODUCTSET, LANDING_PAGE_TYPE_WEIMOB_PROMOTION, LANDING_PAGE_TYPE_WEIMOB_PRODUCT, LANDING_PAGE_TYPE_WEIMOB_H5, LANDING_PAGE_TYPE_WEIMOB_WECHAT_MINIPROGRAM, LANDING_PAGE_TYPE_QQ_MOBILE_MINI_PROGRAM, LANDING_PAGE_TYPE_QQ_BROWSER_MINI_PROGRAM, LANDING_PAGE_TYPE_QQ_MINI_GAME, LANDING_PAGE_TYPE_WECHAT_NATIVE, LANDING_PAGE_TYPE_WECHAT_H5, LANDING_PAGE_TYPE_WECHAT_OFFICIAL_ACCOUNT_ARTICLE, LANDING_PAGE_TYPE_WECHAT_COUPON, LANDING_PAGE_TYPE_WECHAT_OFFICIAL_ACCOUNT_DETAIL, LANDING_PAGE_TYPE_WECHAT_APPSTORE_MOMENTS, LANDING_PAGE_TYPE_WECHAT_H5_TEMPLATE, LANDING_PAGE_TYPE_WECHAT_MOMENTS_SIMPLE_NATIVE, LANDING_PAGE_TYPE_WECHAT_FULL_SCREEN, LANDING_PAGE_TYPE_WECHAT_BASE_DETAILS, LANDING_PAGE_TYPE_WECHAT_PICTURE_DETAILS, LANDING_PAGE_TYPE_WECHAT_STORE, LANDING_PAGE_TYPE_WECHAT_MOMENTS_H5_BRAND, LANDING_PAGE_TYPE_WECHAT_MOMENTS_PICTURE_FORM, LANDING_PAGE_TYPE_WECHAT_MOMENTS_VIDEO_FORM, LANDING_PAGE_TYPE_WECHAT_MOMENTS_APPLIED_TEXT, LANDING_PAGE_TYPE_WECHAT_MOMENTS_APPLIED_VIDEO, LANDING_PAGE_TYPE_WECHAT_FORM_TEMPLATE, LANDING_PAGE_TYPE_WECHAT_VOTING_TEMPLATE, LANDING_PAGE_TYPE_WECHAT_PAYMENT_COUPONS, LANDING_PAGE_TYPE_WECHAT_MINI_GAME, LANDING_PAGE_TYPE_WECHAT_NATIVE_BETA, LANDING_PAGE_TYPE_WECHAT_CALL_DAILOG, LANDING_PAGE_TYPE_WECHAT_FOCUS_DAILOG, LANDING_PAGE_TYPE_WECHAT_MINI_PROGRAM, LANDING_PAGE_TYPE_STURNUS_IMAX, LANDING_PAGE_TYPE_TENCENT_NEWS_SOFT_ARTICLE, LANDING_PAGE_TYPE_TENCENT_NEWS_LIVE, LANDING_PAGE_TYPE_XJ_OTT, LANDING_PAGE_TYPE_WECHAT_APPOINTMENT_CARD, LANDING_PAGE_TYPE_WECHAT_CONSULT, LANDING_PAGE_TYPE_YUEBAO_QUICKAPP, LANDING_PAGE_TYPE_YUEBAO_OFFICIAL_ACCOUNT_ARTICLE, LANDING_PAGE_TYPE_XJ_QUICK }
chosen_button_text2	string	右侧按钮文字字段长度最小 1 字节，长度最大 192 字节
chosen_button_landing_page2	struct	跳转落地页信息
page_spec	struct	落地页信息，根据不同 promoted_object_type 和 page_type，要求的 page_spec 信息不同
page_id	int64	落地页 id
page_url	string	落地页 url 字段长度最小 1 字节，长度最大 1023 字节
mini_program_spec	struct	小程序落地页，mini_program_id 和 mini_program_path 要同时填写
mini_program_id*	string	小程序 id 字段长度最小 1 字节，长度最大 384 字节
mini_program_path	string	小程序路径字段长度最小 1 字节，长度最大 2048 字节
mini_program_paths	string[]	小程序落地页 path 列表数组最小长度 1，最大长度 255 字段长度最小 1 字节，长度最大 2048 字节
mini_game_spec	struct	小游戏落地页信息
mini_game_tracking_parameter	string	小游戏监控参数，需以英文字符?开头，如：?channel=xxxx，字段长度最小 1 个等宽字符，长度最大 250 个等宽字符（即字段最大长度为 250 个中文字或全角标点，500 个英文字或半角标点。一个等宽字符等价于一个中文，等价于两个英文。）字段长度最小 0 字节，长度最大 750 字节
mini_game_openlink	string	openlink 地址字段，当投放版位含优量汇时、推广目标是微信小游戏推广目标时，支持填写「微信小游戏落地页的 openlink 地址」（白名单灰度中），什么是 opelink 可参考[微信开放文档] 字段长度最小 0 字节，长度最大 2048 字节
mini_game_openlink_page_spec	struct	小游戏蹊径落地页，当投放版位含优量汇时、推广目标是微信小游戏推广目标时，落地页使用「微信小游戏」落地页时，支持使用「蹊径落地页」（白名单灰度中）；注意不能同时和「 mini_game_openlink 」同时使用，否则会被蹊径落地页链接覆盖。
landing_page_type*	enum	openlink 落地页页面类型，不大于 1024 个英文字符或数字，[枚举详情] 枚举列表：{ LANDING_PAGE_TYPE_XJ_WEBSITE_H5 }
landing_page_id*	integer	落地页 id
override_canvas_head_option	enum	原生推广页顶部素材和广告创意素材之间的替换关系，（仅在朋友圈广告使用原生推广页情况下有效），[枚举详情] 枚举列表：{ OPTION_CANVAS_OVERRIDE_CREATIVE, OPTION_CREATIVE_OVERRIDE_CANVAS, OPTION_KEEP_DIFFERENT }
dynamic_product_spec	struct	动态多商品广告落地页信息，仅支持 MDPA 广告使用动态落地页(见 dynamic_adcreative_spec.landing_page_url_type) 时填写
page_url	string	动态落地页 url 字段长度最小 1 字节，长度最大 1023 字节
mini_program_paths	string[]	动态多商品广告小程序落地页 path 列表数组最小长度 1，最大长度 6 字段长度最小 1 字节，长度最大 2048 字节
page_type	enum	落地页类型，[枚举详情] 枚举列表：{ PAGE_TYPE_DEFAULT, PAGE_TYPE_TSA_APP, PAGE_TYPE_TSA_WEB_NONE_ECOMMERCE, PAGE_TYPE_CANVAS_WECHAT, PAGE_TYPE_MINI_PROGRAM_WECHAT, PAGE_TYPE_FENGYE_ECOMMERCE, PAGE_TYPE_MINI_GAME_WECHAT, PAGE_TYPE_MOMENTS_SIMPLE_NATIVE_WECHAT, PAGE_TYPE_MINI_PROGRAM_CANVAS_WECHAT, PAGE_TYPE_MINI_GAME_QQ, PAGE_TYPE_MINI_PROGRAM_QQ, PAGE_TYPE_FENGSHU_MINI_PROGRAM, PAGE_TYPE_FENGYE_EC_WECHAT_MINIPROGRAM, PAGE_TYPE_YUEBAO_QUICKAPP, PAGE_TYPE_YUEBAO_OFFICIAL_ACCOUNT_ARTICLE, PAGE_TYPE_XIJING_QUICK }
link_name_type	enum	链接名称类型，[枚举详情] 枚举列表：{ NOT_USED, VIEW_DETAILS, GET_COUPONS, MAKE_AN_APPOINTMENT, BUY_NOW, GO_SHOPPING, ENTER_MINI_PROGRAM, ENTER_MINI_GAME, APPLY_NOW, BOOK_NOW, RESERVATION_BUY, CONSULT_NOW, BOOK_DRIVE, ENTER_OFFICIAL_ACCOUNTS, PLAY_NOW, OPEN_MINI_GAME, DOWNLOAD_APP, DOWNLOAD_GAME, GET_SAMPLES, TRY_NOW, GET_IT_NOW, BUY_ASAP, DOWNLOAD_NOW, VIEW_APPS, MORE_INFO, GET_VOUCHERS, FOLLOW_OFFICIAL_ACCOUNT, READ_NOVELS, WATCH_LIVE, RESERVE_NOW, OPEN_APP, ALREADY_INSTALL, SETUP_NOW, SECKILL_NOW, TRY_PLAY_NOW, INSTALL_NOW, MORE_ABOUT_OFFICIAL_ACCOUNT_CHT, FOLLOW_OFFICIAL_ACCOUNT_CHT, GET_FOR_FREE, WATCH_VIDEO, CARNIVAL_618, SURPRISE_618, DISCOUNT_618, GO_618_VENUE, GET_618_WELFARE, CONTACT_CUSTOMER_SERVICE, CONTACT_BUSINESS }
landing_page_platform	enum	落地页制作平台，[枚举详情] 枚举列表：{ LANDING_PAGE_PLATFORM_UNKNOWN, LANDING_PAGE_PLATFORM_TSA, LANDING_PAGE_PLATFORM_FENGYE_EC, LANDING_PAGE_PLATFORM_FENGYE_DEFAULT, LANDING_PAGE_PLATFORM_XIJING, LANDING_PAGE_PLATFORM_YOUZAN, LANDING_PAGE_PLATFORM_MP, LANDING_PAGE_PLATFORM_APP_STORE, LANDING_PAGE_PLATFORM_YIYE, LANDING_PAGE_PLATFORM_JINSHUJU, LANDING_PAGE_PLATFORM_WEIMOB, LANDING_PAGE_PLATFORM_QQ_MOBILE, LANDING_PAGE_PLATFORM_QQ_BROWSER, LANDING_PAGE_PLATFORM_PLAY, LANDING_PAGE_PLATFORM_YUEBAO, LANDING_PAGE_PLATFORM_HEBANG, LANDING_PAGE_PLATFORM_HELIANG, LANDING_PAGE_PLATFORM_MADAO, LANDING_PAGE_PLATFORM_ZHONGZHI }
landing_page_info	struct	品牌形象
landing_page_type	enum	落地页页面类型，不大于 1024 个英文字符或数字，[枚举详情] 枚举列表：{ LANDING_PAGE_TYPE_UNKNOWN, LANDING_PAGE_TYPE_ANDROID_APP, LANDING_PAGE_TYPE_IOS_APP, LANDING_PAGE_TYPE_FENGYE_WEB, LANDING_PAGE_TYPE_FENGYE_LBS, LANDING_PAGE_TYPE_NATIVE, LANDING_PAGE_TYPE_ANDROID_APP_NATIVE, LANDING_PAGE_TYPE_IOS_APP_NATIVE, LANDING_PAGE_TYPE_XJ_ANDROID_APP_H5, LANDING_PAGE_TYPE_XJ_IOS_APP_H5, LANDING_PAGE_TYPE_XJ_WEBSITE_H5, LANDING_PAGE_TYPE_XJ_WEBSITE_NATIVE, LANDING_PAGE_TYPE_XJ_ANDROID_APP_NATIVE, LANDING_PAGE_TYPE_XJ_IOS_APP_NATIVE, LANDING_PAGE_TYPE_FENGYE_EC_SINGLE, LANDING_PAGE_TYPE_FENGYE_EC_TOGETHER, LANDING_PAGE_TYPE_FENGYE_EC_FOCUS, LANDING_PAGE_TYPE_FENGYE_EC_COMMON, LANDING_PAGE_TYPE_FENGYE_EC_WECHAT_MINIPROGRAM, LANDING_PAGE_TYPE_PLAY_H5, LANDING_PAGE_TYPE_YOUZAN_SINGLE, LANDING_PAGE_TYPE_YOUZAN_TOGETHER, LANDING_PAGE_TYPE_YOUZAN_WECHAT_MINIPROGRAM, LANDING_PAGE_TYPE_YIYE_FORM, LANDING_PAGE_TYPE_JINSHUJU_FORM, LANDING_PAGE_TYPE_WEIMOB_PRODUCTSET, LANDING_PAGE_TYPE_WEIMOB_PROMOTION, LANDING_PAGE_TYPE_WEIMOB_PRODUCT, LANDING_PAGE_TYPE_WEIMOB_H5, LANDING_PAGE_TYPE_WEIMOB_WECHAT_MINIPROGRAM, LANDING_PAGE_TYPE_QQ_MOBILE_MINI_PROGRAM, LANDING_PAGE_TYPE_QQ_BROWSER_MINI_PROGRAM, LANDING_PAGE_TYPE_QQ_MINI_GAME, LANDING_PAGE_TYPE_WECHAT_NATIVE, LANDING_PAGE_TYPE_WECHAT_H5, LANDING_PAGE_TYPE_WECHAT_OFFICIAL_ACCOUNT_ARTICLE, LANDING_PAGE_TYPE_WECHAT_COUPON, LANDING_PAGE_TYPE_WECHAT_OFFICIAL_ACCOUNT_DETAIL, LANDING_PAGE_TYPE_WECHAT_APPSTORE_MOMENTS, LANDING_PAGE_TYPE_WECHAT_H5_TEMPLATE, LANDING_PAGE_TYPE_WECHAT_MOMENTS_SIMPLE_NATIVE, LANDING_PAGE_TYPE_WECHAT_FULL_SCREEN, LANDING_PAGE_TYPE_WECHAT_BASE_DETAILS, LANDING_PAGE_TYPE_WECHAT_PICTURE_DETAILS, LANDING_PAGE_TYPE_WECHAT_STORE, LANDING_PAGE_TYPE_WECHAT_MOMENTS_H5_BRAND, LANDING_PAGE_TYPE_WECHAT_MOMENTS_PICTURE_FORM, LANDING_PAGE_TYPE_WECHAT_MOMENTS_VIDEO_FORM, LANDING_PAGE_TYPE_WECHAT_MOMENTS_APPLIED_TEXT, LANDING_PAGE_TYPE_WECHAT_MOMENTS_APPLIED_VIDEO, LANDING_PAGE_TYPE_WECHAT_FORM_TEMPLATE, LANDING_PAGE_TYPE_WECHAT_VOTING_TEMPLATE, LANDING_PAGE_TYPE_WECHAT_PAYMENT_COUPONS, LANDING_PAGE_TYPE_WECHAT_MINI_GAME, LANDING_PAGE_TYPE_WECHAT_NATIVE_BETA, LANDING_PAGE_TYPE_WECHAT_CALL_DAILOG, LANDING_PAGE_TYPE_WECHAT_FOCUS_DAILOG, LANDING_PAGE_TYPE_WECHAT_MINI_PROGRAM, LANDING_PAGE_TYPE_STURNUS_IMAX, LANDING_PAGE_TYPE_TENCENT_NEWS_SOFT_ARTICLE, LANDING_PAGE_TYPE_TENCENT_NEWS_LIVE, LANDING_PAGE_TYPE_XJ_OTT, LANDING_PAGE_TYPE_WECHAT_APPOINTMENT_CARD, LANDING_PAGE_TYPE_WECHAT_CONSULT, LANDING_PAGE_TYPE_YUEBAO_QUICKAPP, LANDING_PAGE_TYPE_YUEBAO_OFFICIAL_ACCOUNT_ARTICLE, LANDING_PAGE_TYPE_XJ_QUICK }
living_desc_struct	struct	轮播文案
living_desc_struct_switch*	boolean	轮播组件开关可选值：{ true, false }
living_desc_list	string[]	轮播文案数组最小长度 2，最大长度 5 字段长度最小 1 字节，长度最大 1024 字节
floating_zone_struct	struct	浮层卡片创意内容
floating_zone_switch*	boolean	浮层卡片开关可选值：{ true, false }
floating_zone_image_id	string	尺寸：512512，大小：不超过 50 KB，格式：.jpg\|.jpeg\|.png ；
floating_zone_name	string	文案一，字段长度最小 1 个等宽字符，长度最大 8 等宽字符（即字段最大长度为 8 个中文字或全角标点，16 个英文字或半角标点。一个等宽字符等价于一个中文，等价于两个英文。）
floating_zone_desc	string	文案二，字段长度最小 0 个等宽字符，长度最大 6 等宽字符（即字段最大长度为 6 个中文字或全角标点，12 个英文字或半角标点。一个等宽字符等价于一个中文，等价于两个英文。）
floating_zone_button_text	string	按钮文案，字段长度最小 0 个等宽字符，长度最大 4 等宽字符（即字段最大长度为 4 个中文字或全角标点，8 个英文字或半角标点。一个等宽字符等价于一个中文，等价于两个英文。）
floating_zone_type	enum	浮层卡片类型，[枚举详情] 枚举列表：{ FLOATING_ZONE_TYPE_UNKNOWN, FLOATING_ZONE_TYPE_IMAGE_TEXT, FLOATING_ZONE_TYPE_SINGLE_IMAGE, FLOATING_ZONE_TYPE_MULTI_BUTTON }
floating_zone_single_image_id	string	尺寸: 540276 ,大小：不超过 50 KB，格式：.jpg\|.jpeg\|.png ；
canvas_share_image	string	图片 URL 字段长度最小 1 字节，长度最大 2048 字节
wegame_info_spec	struct	小游戏结束页能力
wegame_info_switch	boolean	小游戏结束页开关可选值：{ true, false }
campaign_type*	enum	推广计划类型，[枚举详情] 枚举列表：{ CAMPAIGN_TYPE_NORMAL }
promoted_object_type*	enum	推广目标类型，[枚举详情] 枚举列表：{ PROMOTED_OBJECT_TYPE_LINK, PROMOTED_OBJECT_TYPE_LINK_WECHAT, PROMOTED_OBJECT_TYPE_ECOMMERCE, PROMOTED_OBJECT_TYPE_APP_ANDROID, PROMOTED_OBJECT_TYPE_APP_QUICK_APP, PROMOTED_OBJECT_TYPE_APP_IOS, PROMOTED_OBJECT_TYPE_APP_ANDROID_MYAPP, PROMOTED_OBJECT_TYPE_APP_ANDROID_UNION, PROMOTED_OBJECT_TYPE_QQ_BROWSER_MINI_PROGRAM, PROMOTED_OBJECT_TYPE_LOCAL_ADS_WECHAT, PROMOTED_OBJECT_TYPE_QQ_MESSAGE, PROMOTED_OBJECT_TYPE_LEAD_AD, PROMOTED_OBJECT_TYPE_MINI_GAME_WECHAT, PROMOTED_OBJECT_TYPE_MINI_GAME_QQ, PROMOTED_OBJECT_TYPE_MINI_PROGRAM_WECHAT, PROMOTED_OBJECT_TYPE_WECHAT_OFFICIAL_ACCOUNT, PROMOTED_OBJECT_TYPE_WECHAT_CHANNELS }
page_type	enum	落地页类型，[枚举详情] 枚举列表：{ PAGE_TYPE_DEFAULT, PAGE_TYPE_TSA_APP, PAGE_TYPE_TSA_WEB_NONE_ECOMMERCE, PAGE_TYPE_CANVAS_WECHAT, PAGE_TYPE_MINI_PROGRAM_WECHAT, PAGE_TYPE_FENGYE_ECOMMERCE, PAGE_TYPE_MINI_GAME_WECHAT, PAGE_TYPE_MOMENTS_SIMPLE_NATIVE_WECHAT, PAGE_TYPE_MINI_PROGRAM_CANVAS_WECHAT, PAGE_TYPE_MINI_GAME_QQ, PAGE_TYPE_MINI_PROGRAM_QQ, PAGE_TYPE_FENGSHU_MINI_PROGRAM, PAGE_TYPE_FENGYE_EC_WECHAT_MINIPROGRAM, PAGE_TYPE_YUEBAO_QUICKAPP, PAGE_TYPE_YUEBAO_OFFICIAL_ACCOUNT_ARTICLE, PAGE_TYPE_XIJING_QUICK }
automatic_site_enabled	boolean	是否开启自动版位功能（暂不包含 SITE_SET_WECHAT 和 SITE_SET_MOMENTS），此字段与 site_set 字段至少需要写入一个。可选值：{ true, false }
site_set	enum[]	投放版位集合，当前单版位或者 SITE_SET_TENCENT_NEWS+SITE_SET_TENCENT_VIDEO+SITE_SET_MOBILE_UNION+SITE_SET_KANDIAN+SITE_SET_QQ_MUSIC_GAME 的组合，[枚举详情] 数组最小长度 1，最大长度 32 枚举列表：{ SITE_SET_QZONE, SITE_SET_QQCLIENT, SITE_SET_MUSIC, SITE_SET_MOBILE_UNION, SITE_SET_QQCOM, SITE_SET_WECHAT, SITE_SET_MOBILE_INNER, SITE_SET_TENCENT_NEWS, SITE_SET_TENCENT_VIDEO, SITE_SET_TENCENT_KUAIBAO, SITE_SET_MOBILE_MYAPP, SITE_SET_PCQQ, SITE_SET_KANDIAN, SITE_SET_QQ_MUSIC_GAME, SITE_SET_MOMENTS, SITE_SET_KUAISHOU, SITE_SET_MINI_GAME_WECHAT, SITE_SET_MINI_GAME_QQ, SITE_SET_MOBILE_GAME, SITE_SET_MOBILE_YYB, SITE_SET_QQSHOPPING, SITE_SET_WECHAT_SEARCH, SITE_SET_WECHAT_PLUGIN }
promoted_object_id	string	推广目标 id，详见 [查询推广目标 id] 字段长度最小 0 字节，长度最大 128 字节
page_spec	struct	落地页信息，根据不同 promoted_object_type 和 page_type，要求的 page_spec 信息不同
page_id	int64	落地页 id
page_url	string	落地页 url 字段长度最小 1 字节，长度最大 1023 字节
link_page_type	enum	文字链跳转类型类型，[枚举详情] 枚举列表：{ LINK_PAGE_TYPE_NOT_USED, LINK_PAGE_TYPE_DEFAULT, LINK_PAGE_TYPE_CANVAS_WECHAT, LINK_PAGE_TYPE_ARTICAL_WECHAT, LINK_PAGE_TYPE_MINI_PROGRAM_WECHAT, LINK_PAGE_TYPE_MINI_PROGRAM_CANVAS_WECHAT, LINK_PAGE_TYPE_MINI_GAME_WECHAT, LINK_PAGE_TYPE_FENGYE_ECOMMERCE, LINK_PAGE_TYPE_XJ_ANDROID_APP_H5, LINK_PAGE_TYPE_XJ_IOS_APP_H5, LINK_PAGE_TYPE_XJ_WEBSITE_H5, LINK_PAGE_TYPE_WECHAT_MOMENTS_SIMPLE_NATIVE, LINK_PAGE_TYPE_XJ_QUICK, LINK_PAGE_TYPE_WECHAT_OFFICIAL_ACCOUNT_DETAIL, LINK_PAGE_TYPE_WECHAT_CONSULT }
link_name_type	enum	链接名称类型，[枚举详情] 枚举列表：{ NOT_USED, VIEW_DETAILS, GET_COUPONS, MAKE_AN_APPOINTMENT, BUY_NOW, GO_SHOPPING, ENTER_MINI_PROGRAM, ENTER_MINI_GAME, APPLY_NOW, BOOK_NOW, RESERVATION_BUY, CONSULT_NOW, BOOK_DRIVE, ENTER_OFFICIAL_ACCOUNTS, PLAY_NOW, OPEN_MINI_GAME, DOWNLOAD_APP, DOWNLOAD_GAME, GET_SAMPLES, TRY_NOW, GET_IT_NOW, BUY_ASAP, DOWNLOAD_NOW, VIEW_APPS, MORE_INFO, GET_VOUCHERS, FOLLOW_OFFICIAL_ACCOUNT, READ_NOVELS, WATCH_LIVE, RESERVE_NOW, OPEN_APP, ALREADY_INSTALL, SETUP_NOW, SECKILL_NOW, TRY_PLAY_NOW, INSTALL_NOW, MORE_ABOUT_OFFICIAL_ACCOUNT_CHT, FOLLOW_OFFICIAL_ACCOUNT_CHT, GET_FOR_FREE, WATCH_VIDEO, CARNIVAL_618, SURPRISE_618, DISCOUNT_618, GO_618_VENUE, GET_618_WELFARE, CONTACT_CUSTOMER_SERVICE, CONTACT_BUSINESS }
link_page_spec	struct	文字链跳转信息，根据不同 promoted_object_type 和 page_type、link_page_type，要求的 link_page_spec 信息不同
page_id	int64	落地页 id
page_url	string	落地页 url 字段长度最小 1 字节，长度最大 1023 字节
mini_program_spec	struct	小程序落地页，mini_program_id 和 mini_program_path 要同时填写
mini_program_id*	string	小程序 id 字段长度最小 1 字节，长度最大 384 字节
mini_program_path	string	小程序路径字段长度最小 1 字节，长度最大 2048 字节
mini_program_paths	string[]	小程序落地页 path 列表数组最小长度 1，最大长度 255 字段长度最小 1 字节，长度最大 2048 字节
mini_game_spec	struct	小游戏落地页信息
mini_game_tracking_parameter	string	小游戏监控参数，需以英文字符?开头，如：?channel=xxxx，字段长度最小 1 个等宽字符，长度最大 250 个等宽字符（即字段最大长度为 250 个中文字或全角标点，500 个英文字或半角标点。一个等宽字符等价于一个中文，等价于两个英文。）字段长度最小 0 字节，长度最大 750 字节
conversion_data_type	enum	数据展示数据类型，[枚举详情] 枚举列表：{ CONVERSION_DATA_DEFAULT, CONVERSION_DATA_FRIEND_PLAY, CONVERSION_DATA_APP_DOWNLOAD, CONVERSION_DATA_ONSHOP, CONVERSION_DATA_ADMETRIC, CONVERSION_DATA_FRIEND_FOLLOW }
conversion_target_type	enum	数据展示转化数据量类型，仅投朋友圈流量且 conversion_data_type 为 CONVERSION_DATA_ADMETRIC 时可设置，[枚举详情] 枚举列表：{ CONVERSION_TARGET_DEFAULT, CONVERSION_TARGET_GET, CONVERSION_TARGET_RESERVE, CONVERSION_TARGET_BOOK, CONVERSION_TARGET_BUY, CONVERSION_TARGET_APPLY, CONVERSION_TARGET_CONSULT, CONVERSION_TARGET_DOWNLOAD, CONVERSION_TARGET_PLAYING, CONVERSION_TARGET_CLICK, CONVERSION_TARGET_SEE, CONVERSION_TARGET_INVOLVE, CONVERSION_TARGET_OPEN, CONVERSION_TARGET_PURCHASE, CONVERSION_TARGET_BROWSE, CONVERSION_TARGET_TRY, CONVERSION_TARGET_DRIVE, CONVERSION_TARGET_ENTER, CONVERSION_TARGET_READ, CONVERSION_TARGET_FOLLOW, CONVERSION_TARGET_USE, CONVERSION_TARGET_EXPERIENCE, CONVERSION_TARGET_SETUP, CONVERSION_TARGET_SECKILL }
qq_mini_game_tracking_query_string	string	为 QQ 小游戏落地页地址增加独立的监控参数，可选填，为 QQ 小游戏落地页地址增加独立的监控参数字段长度最小 0 字节，长度最大 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 }
android_deep_link_app_id	string	安卓应用直达 AppId 字段长度最小 0 字节，长度最大 128 字节
ios_deep_link_app_id	string	IOS 应用直达 AppId 字段长度最小 0 字节，长度最大 128 字节
universal_link_url	string	通用链接页 URL 字段长度最小 0 字节，长度最大 2048 字节
profile_id	integer	朋友圈头像昵称跳转页 id，仅微信朋友圈广告（site_set=SITE_SET_MOMENTS）的创意形式支持
share_content_spec	struct	分享信息，仅在部分朋友圈创意规格下设置有效，具体可通过 [创意规格查询工具] 或 adcreative_templates/get 接口进行查询，若该字段不为空，则表示投放简版原生推广页（点击图片后会跳转至系统自动生成的简版原生推广页）
share_title*	string	简版原生页分享标题，字段长度最小 1 个等宽字符，长度最大 14 个等宽字符（即字段最大长度为 14 个中文字或全角标点，28 个英文字或半角标点。一个等宽字符等价于一个中文，等价于两个英文。）
share_description*	string	简版原生页分享描述，字段长度最小 1 个等宽字符，长度最大 20 个等宽字符（即字段最大长度为 20 个中文字或全角标点，40 个英文字或半角标点。一个等宽字符等价于一个中文，等价于两个英文。）
dynamic_adcreative_spec	struct	动态商品广告属性，当创意为动态商品广告创意时，该字段必填
product_catalog_id*	integer	商品库 id
product_mode*	enum	动态商品广告（DPA）类型，支持单商品动态商品广告（SDPA）和多商品动态商品广告（MDPA），[枚举详情] 枚举列表：{ SINGLE, MULTIPLE }
product_source*	string	动态商品广告所使用的商品信息,可以填入商品系列 id 或者商品 id 字段长度最小 1 字节，长度最大 128 字节
component_id	integer	附加创意组件 id 最小值 1，最大值 4294967295
video_end_page	struct	视频播放结束页，（当前仅支持互动推广页）
end_page_id*	string	视频播放结束页 id 字段长度最小 1 字节，长度最大 20 字节
end_page_type*	enum	视频播放结束页类型，[枚举详情] 枚举列表：{ VIDEO_END_PAGE_TYPE_PLAY_H5 }
webview_url	string	简易原生页嵌入 Webview url,和 simple_canvas_sub_type 配合使用，关系如下:SIMPLE_CANVAS_SUB_TYPE_URL,SIMPLE_CANVAS_SUB_TYPE_SLIDE_UP 时必填，SIMPLE_CANVAS_SUB_TYPE_WEB_STORE 时系统其他填充为 web store 地址，其他情况无效。字段长度最小 0 字节，长度最大 1023 字节
simple_canvas_sub_type	enum	简版原生页子类型(灰度中)，仅在简版原生页下生效，其他情况改字段内容会被忽略，[枚举详情] 枚举列表：{ SIMPLE_CANVAS_SUB_TYPE_UNKNOWN, SIMPLE_CANVAS_SUB_TYPE_DEFAULT, SIMPLE_CANVAS_SUB_TYPE_URL, SIMPLE_CANVAS_SUB_TYPE_SLIDE_UP, SIMPLE_CANVAS_SUB_TYPE_WEB_STORE, SIMPLE_CANVAS_SUB_TYPE_CHOOSE }
floating_zone	struct	浮层卡片创意内容
floating_zone_switch*	boolean	浮层卡片开关可选值：{ true, false }
floating_zone_image_id	string	尺寸：512512，大小：不超过 50 KB，格式：.jpg\|.jpeg\|.png ；
floating_zone_name	string	文案一，字段长度最小 1 个等宽字符，长度最大 8 等宽字符（即字段最大长度为 8 个中文字或全角标点，16 个英文字或半角标点。一个等宽字符等价于一个中文，等价于两个英文。）
floating_zone_desc	string	文案二，字段长度最小 0 个等宽字符，长度最大 6 等宽字符（即字段最大长度为 6 个中文字或全角标点，12 个英文字或半角标点。一个等宽字符等价于一个中文，等价于两个英文。）
floating_zone_button_text	string	按钮文案，字段长度最小 0 个等宽字符，长度最大 4 等宽字符（即字段最大长度为 4 个中文字或全角标点，8 个英文字或半角标点。一个等宽字符等价于一个中文，等价于两个英文。）
floating_zone_type	enum	浮层卡片类型，[枚举详情] 枚举列表：{ FLOATING_ZONE_TYPE_UNKNOWN, FLOATING_ZONE_TYPE_IMAGE_TEXT, FLOATING_ZONE_TYPE_SINGLE_IMAGE, FLOATING_ZONE_TYPE_MULTI_BUTTON }
floating_zone_single_image_id	string	尺寸: 540276 ,大小：不超过 50 KB，格式：.jpg\|.jpeg\|.png ；
marketing_pendant_image_id	string	挂件图，悬浮展示在竖版视频上以展示营销卖点。在 [images 模块] 上传图片后获得该 id 并在参数中传入，上传图片时需指定 image_usage 字段。字段长度最小 1 字节，长度最大 64 字节仅在规格支持时传入，可通过 [创意规格查询工具] 查询字段长度最小 0 字节，长度最大 64 字节
barrage_list	struct[]	弹幕列表数组最小长度 0，最大长度 20
id*	integer	弹幕 id
dynamic_creative_group_used	enum	动态创意分组，使用方法详见[动态创意广告] 默认为不使用组合，功能灰度开放中，如需使用可联系您的客户运营，[枚举详情] 枚举列表：{ NOT_USE_GROUP, VIDEO_IMAGE_GROUP }
countdown_switch	boolean	倒计时组件开关可选值：{ true, false }
app_gift_pack_code	struct	礼包码，微信朋友圈广告创意形式需要填写，礼包码
code	string	礼包码，微信朋友圈广告创意形式需要填写，礼包码字段长度最小 0 字节，长度最大 450 字节
tips	string	礼包码提示，微信朋友圈广告创意形式需要填写，礼包码提示
enable_breakthrough_siteset	boolean	是否支持版位突破，广告版位选择“微信朋友圈”，当广告有机会获得更多曝光与转化时，将可能投放到微信公众号与小程序版位，若不传值默认为 true 可选值：{ true, false }
union_market_spec	struct	厂商下载信息，厂商下载信息，仅可在跳转厂商应用商店（union_market_switch）值为 true 时使用。
union_market_jump_type	enum	厂商直达链接跳转类型，[枚举详情] 枚举列表：{ UNION_MARKET_JUMP_TYPE_DEFAULT, UNION_MARKET_JUMP_TYPE_LANDING_PAGE }
program_creative_info	struct	动态创意（升级版）信息，dynamic_creative_type 为 DYNAMIC_CREATIVE_TYPE_PROGRAM 时必填
material_derive_id	integer	衍生 id，在 [programmed 模块] 创建模板预览获得得该 id 并在参数中传入
bid_mode	enum	出价方式， 1. bid_mode 为 billing_event 升级字段，不可同时输入，升级后直接写入 bid_mode 字段即可； 2. 当投放智能出价广告，可写入 BID_MODE_OCPC/BID_MODE_OCPM。此时，optimization_goal 优化目标字段必填； 3. 当投放非智能出价广告，可写入 BID_MODE_CPC/BID_MODE_CPM/BID_MODE_CPA。此时，optimization_goal 优化目标字段不可填； 4. 针对非微信流量，BID_MODE_CPC 可编辑修改为 BID_MODE_OCPC，BID_MODE_CPM 可编辑修改为 BID_MODE_OCPM，其他修改不可操作。针对微信流量，bid_mode 字段不可修改； 5. 可通过 adcreative_templates/get 接口查询不同情况下支持的出价方式;，[枚举详情] 枚举列表：{ BID_MODE_CPC, BID_MODE_CPA, BID_MODE_CPM, BID_MODE_CPT, BID_MODE_OCPC, BID_MODE_OCPM }
dynamic_creative_type	enum	动态创意类型，[枚举详情] 枚举列表：{ DYNAMIC_CREATIVE_TYPE_COMMON, DYNAMIC_CREATIVE_TYPE_PROGRAM }
head_click_type	enum	头像点击跳转信息，[枚举详情] 枚举列表：{ HEAD_CLICK_TYPE_DEFAULT, HEAD_CLICK_TYPE_CUSTOMIZED, HEAD_CLICK_TYPE_CELEBRITY_ACCOUNT, HEAD_CLICK_TYPE_VIRTUAL_ACCOUNT, HEAD_CLICK_TYPE_LIVE_PROFILE, HEAD_CLICK_TYPE_LIVE_EVENT, HEAD_CLICK_TYPE_BRAND_PROGRAM, HEAD_CLICK_TYPE_CNY_PROFILE }
head_click_spec	struct	头像点击跳转信息，头像点击跳转信息，目前支持跳转搜一搜品牌专区，白名单开放中，如果需要使用请联系您的运营经理
brand_app_id	string	搜一搜品牌形象 app id 字段长度最小 1 字节，长度最大 2048 字节

使用说明

注意：支持动态创意元素的传参使用带_options 后缀的参数。可通过 [创意规格查询工具] 进行查询哪些元素支持动态创意。

请求示例


curl 'https://api.e.qq.com/v1.1/dynamic_creatives/add?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id=<ACCOUNT_ID>' \
-d 'dynamic_creative_name=test' \
-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 'campaign_type=CAMPAIGN_TYPE_NORMAL' \
-d 'promoted_object_type=PROMOTED_OBJECT_TYPE_APP_IOS' \
-d 'page_type=PAGE_TYPE_DEFAULT' \
-d 'site_set=["SITE_SET_TENCENT_NEWS"]' \
-d 'promoted_object_id=1044283059' \
-d 'page_spec={"page_url":"https://www.example.com"}' \
-d 'link_page_spec={
    "mini_program_spec": {
        "mini_program_paths": []
    },
    "mini_game_spec": []
}' \
-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 'share_content_spec=[]' \
-d 'dynamic_adcreative_spec=[]' \
-d 'video_end_page=[]' \
-d 'floating_zone=[]' \
-d 'barrage_list=[]' \
-d 'app_gift_pack_code={
    "code": 0
}' \
-d 'union_market_spec=[]' \
-d 'program_creative_info=[]' \
-d 'head_click_spec=[]'

应答字段

名称	类型	描述
dynamic_creative_id	integer	广告创意 id

应答示例

{
    "code": 0,
    "message": "",
    "message_cn": "",
    "data": {
        "dynamic_creative_id": 123
    }
}

可视化调试工具

问题仍未解决？

请前往腾讯广告反馈中心在线提交问题，我们的人工客服将为你服务

首页

开发文档

最新动态

腾讯广告

广告创意 (Adcreative) V1.1 loading

创建广告创意 全部接口 V1.1 loading

全局参数

特定请求头参数

请求参数

请求示例

场景组合示例

应答字段

应答示例

可视化调试工具

相关阅读

更新广告创意 全部接口 V1.1 loading

全局参数

请求参数

请求示例

应答字段

应答示例

可视化调试工具

相关阅读

获取广告创意 全部接口 V1.1 loading

全局参数

请求参数

请求示例

应答字段

应答示例

可视化调试工具

相关阅读

删除广告创意 全部接口 V1.1 loading

全局参数

请求参数

请求示例

应答字段

应答示例

可视化调试工具

相关阅读

创建动态创意 全部接口 V1.1 loading

全局参数

请求参数

请求示例

应答字段

应答示例

可视化调试工具

广告创意 (Adcreative)

V1.1

loading

创建广告创意
全部接口
V1.1
loading

更新广告创意
全部接口
V1.1
loading

获取广告创意
全部接口
V1.1
loading

删除广告创意
全部接口
V1.1
loading

创建动态创意
全部接口
V1.1
loading