腾讯广告
  1. 微信原生页
腾讯广告
  • 入门与指南
    • 快速入门
    • 术语介绍和技术准备
    • 业务流程
    • 发起请求
    • 接收应答
    • 接口清单
    • V1.3升级指引
  • 授权认证
    • OAuth授权
      • 获取 Authorization Code
      • 获取 Token
  • 账号管理
    • 广告账号
      • 添加腾讯广告服务商子客
      • 更新腾讯广告广告主信息
      • 查询腾讯广告广告主信息
      • 获取竞价广告账户日预算
      • 查询商务管家账号下广告主信息
      • 查询商务管家或同主体下广告主信息
    • 资质
      • 创建广告主资质
      • 更新广告主资质
      • 获取广告主资质
      • 删除广告主资质
    • 资金账户
      • 发起代理商与子客户之间转账
      • 获取资金账户信息
      • 获取资金账户日结明细
      • 获取资金账户日结明细(新,包含日终结余数据)
      • 获取资金流水
      • 获取微信资金账户信息
      • 获取微信资金账户流水信息
      • 获取实时消耗
      • 服务商当日分账户实时消耗
      • 服务商内部划账
      • 同商务管家子客间转账
      • 资金合并类型同商务管家子客间转账
      • 获取资金合并类型资金账户信息
      • 获取资金合并类型资金账户日结明细
      • 获取资金合并类型资金流水
  • 营销资产
    • 推广目标
      • 创建推广目标
      • 更新推广目标
      • 获取推广目标
      • 删除推广目标
      • 推广目标授权接口
      • 获取授权历史记录
      • 获取 Android 渠道包
    • 落地页
      • 获取落地页列表
      • 获取蹊径落地页模板列表
      • 获取蹊径落地页模板
      • 获取蹊径落地页互动模板配置
      • 蹊径-获取落地页列表
      • 蹊径-基于模板创建落地页
      • 蹊径-基于组件创建落地页
      • 蹊径-创建互动落地页
      • 蹊径-送审落地页
      • 蹊径-删除落地页
      • 生成虚拟人
      • 生成点击特效
      • 生成预览 token
    • 落地页号码包
      • 获取蹊径号码包列表
      • 添加蹊径号码包
      • 更新蹊径号码包
      • 获取蹊径微信号列表
      • 更新蹊径微信号
    • 视频
      • 添加视频文件
      • 获取视频文件
      • 修改视频信息
      • 删除视频
    • 图片
      • 添加图片文件
      • 获取图片信息
      • 修改图片信息
      • 删除图片
    • 品牌形象
      • 创建品牌形象
      • 获取品牌形象列表
    • 互动推广页
      • 获取互动推广页
    • 商品库
      • 创建商品库
      • 获取商品库
      • 添加商品
      • 行业列表
      • 获取商品
      • 获取商品详情
      • 更新商品信息
      • 批量更新商品信息
      • 获取审核失败的商品
      • 获取商品类目
      • 创建商品系列
      • 获取商品系列
    • 动态商品图片
      • 创建用于广告投放的动态广告图片
      • 获取动态广告图片信息
    • 动态商品视频
      • 创建用于广告投放的动态广告视频
    • 微信原生页
      • 基于模板创建微信原生页
        POST
      • 基于组件创建微信原生页
        POST
      • 获取微信落地页列表
        GET
      • 删除微信落地页
        POST
    • 广告应用分包
      • 创建应用分包
      • 更新应用子包版本
      • 查询应用分包列表
    • 优量汇流量包
      • 联盟流量包模块
      • 联盟流量包模块
      • 联盟流量包获取接口
      • 联盟流量包删除接口
    • 资产授权
      • 资产权限授予
      • 资产权限回收
      • 获取待确认接收授权列表接口
      • 资产预授权确认
      • 更新资产授权权限
    • 朋友圈头像昵称跳转页
      • 创建朋友圈头像昵称跳转页
      • 删除朋友圈头像昵称跳转页
      • 获取朋友圈头像昵称跳转页
    • 附加创意
      • 创建表单组件
      • 获取表单组件详情
      • 获取表单组件列表
    • 弹幕
      • 添加弹幕
      • 获取弹幕
      • 查询运营推荐弹幕列表
    • 本地门店
      • 批量录入门店
      • 批量更新门店信息
      • 批量删除门店信息
      • 查询门店信息
      • 解析门店地址
      • 搜索门店
      • 查询微信支付商户号
      • 查询门店类目
    • 创意组件
      • 创建创意组件
      • 更新创意组件
      • 查询创意组件信息
      • 删除创意组件
      • 更新创意组件状态
  • 广告管理
    • 推广计划
      • 创建推广计划
      • 更新推广计划
      • 获取推广计划
      • 删除推广计划
    • 广告组
      • 创建广告组
      • 更新广告组
      • 获取广告组
      • 删除广告组
    • 广告创意
      • 创建广告创意
      • 更新广告创意
      • 获取广告创意
      • 删除广告创意
    • 动态创意
      • 创建动态创意
      • 更新动态创意
      • 获取动态创意
    • 广告
      • 创建广告
      • 更新广告
      • 获取广告
      • 删除广告
    • 定向
      • 创建定向
      • 更新定向
      • 获取定向
      • 删除定向
      • 分享定向
      • 获取定向分享记录
    • 关键词
      • 创建关键词
      • 替换关键词
      • 删除关键词
      • 获取关键词
    • 否定词
      • 新增推广计划否定词
      • 新增广告组否定词
      • 修改推广计划否定词
      • 修改广告组否定词
      • 查询推广计划否定词
      • 查询广告组否定词
    • 批量操作
      • 创建批量请求
      • 更新广告主日限额信息
      • 更新推广计划日限额信息
      • 更新广告组日限额信息
      • 更新推广计划状态
      • 更新广告组状态
      • 更新广告状态
      • 更新广告组投放时间
      • 更新广告组出价
      • 创建批量异步请求任务
      • 获取批量异步请求任务列表
      • 获取批量异步请求任务详情
    • 出价
      • 获取分人群出价标签
  • 创意工具
    • 文案助手
      • 获取广告文案
    • 图片处理
      • 进行图片处理
    • 广告素材预审
      • 获取广告素材预审结果
    • 视频加字幕
      • 创建视频加字幕任务
    • 创建智能调整
      • 创建智能调整任务
    • 视频封面画图
      • 生成视频封面图
    • 词包
      • 获取词包
    • 通配符
      • 获取落地页通配符
    • 创意示例商品
      • 获取创意示例商品列表
    • 动态商品图片模板
      • 获取动态商品图片模板
    • 动态商品视频模板
      • 获取动态商品视频模板
    • 创意工具通用接口
      • 视频工具任务查询
    • 自动生成创意
      • 创建模板预览接口
      • 更新模板预览接口
      • 获取模板预览接口
      • 获取模板列表接口
    • 素材标签
      • 素材标签列表
      • 素材标签保存
  • 数据洞察
    • 广告数据洞察
      • 获取日报表
      • 获取小时报表
      • 获取定向标签报表
      • 落地页报表数据接口
      • 联盟广告位报表接口
      • 视频流失分析接口
      • 创建异步报表任务
      • 获取异步报表任务
      • 获取文件接口
    • 人群数据洞察
      • 人群洞察分析
    • 订单数据
      • 获取订单
      • 更新订单
    • 线索管理平台
      • 获取线索列表
      • 回传线索状态
      • 获取中间号
      • 获取通话结果
      • 获取一个账号下的全部通话结果
      • 获取网络电话 token
      • 网络电话呼叫
      • 外部线索数据导入
      • 外部线索状态更新
      • 更新线索基本信息
      • 获取无效赔付明细
    • 人群价值分析
      • 人群价值分析
  • 人群管理
    • 客服人群
      • 创建客户人群
      • 更新客户人群
      • 更新客户人群
      • 删除客户人群
    • 客户人群数据文件
      • 上传客户人群数据文件
      • 获取客户人群数据文件
    • 客户人群数预估
      • 人群覆盖数预估
    • 人群授权
      • 添加人群授权
      • 获取人群授权信息
    • 标签人群
      • 标签广场标签获取
    • 客户标签
      • 创建客户标签
      • 获取客户标签
      • 更新客户标签
      • 删除客户标签
    • 标签数据文件
      • 上传客户标签人群数据文件
      • 获取客户标签人群文件
    • 用户属性数据源
      • 创建用户属性数据源
      • 更新用户属性数据源
      • 获取用户属性数据源
    • 用户属性数据
      • 上传用户属性数据
  • 数据上报
    • 用户行为数据源
      • 创建用户行为数据源
      • 获取用户行为数据源
      • 获取用户行为数据源报表
      • 添加数据集
      • 获取数据集
      • 数据源分发关系更新
      • 数据源分发关系获取
    • 用户行为数据
      • 上传用户行为数据
    • 属性数据源
      • 创建属性数据源
      • 获取属性数据源
    • 属性数据源schema
      • 创建属性数据源 schema
      • 更新属性数据源 schema
      • 获取属性数据源 Schema
    • 属性数据文件上传
      • 创建属性数据文件上传会话
      • 提交属性数据文件上传会话
      • 上传属性数据文件
  • 附近推
    • 附近推开户
      • 附近推商家开户
      • 更新附近推商家信息
      • 查询附近推商家信息
    • 附近推账户资金
      • 微信服务商子客之间转账
    • 附近推账户资质
      • 添加附近推商家资质
      • 删除附近推商家资质
      • 查询附近推商家资质信息
    • 附近推广告投放
      • 创建广告
      • 拉取广告列表
      • 更新广告
      • 手动结束广告
      • 拉取曝光预估数据
    • 附近推门店
      • 批量录入门店
      • 批量更新门店信息
      • 批量删除门店信息
      • 查询门店信息
      • 解析门店地址
      • 搜索门店
      • 查询微信支付商户号
      • 查询门店类目
  • 审核工具
    • 素材风险检测
      • 获取元素的预审结果
    • 广告申诉复审
      • 发起广告申诉复审
      • 获取广告申诉复审结果
      • 获取广告申诉复审配额
  • 投放辅助工具
    • 定向标签
      • 获取定向标签
      • 获取行为/兴趣/意向标签覆盖人群数
    • 场景定向标签
      • 获取场景定向标签
    • 创意形式
      • 获取创意规格详情
      • 获取创意规格列表
    • 广告投放能力
      • 查询优化目标权限
    • 预估能力
      • 人数预估
      • 获取出价模拟信息
      • 获取当日转化效果预估数据
    • 广告预览
      • 创建预览
      • 获取预览受众
      • 获取广告预览二维码
    • ·异步任务
      • 创建异步任务
      • 获取异步任务
      • 获取文件接口
    • 拆分对比实验
      • 创建拆分对比实验
      • 更新拆分对比实验
      • 删除拆分对比实验
      • 获取拆分对比实验
    • 广告诊断
      • 获取广告诊断信息
    • 广告创意预览
      • 获取广告创意预览
    • 微信广告标签
      • 获取微信广告标签
    • 广告标签
      • 获取广告标签
    • 转化归因
      • 新增转化归因
      • 获取转化归因
    • 微信原生页
      • 获取原生页授权方信息
      • 获取企业微信客服组列表
      • 增加企业微信组件客服组
      • 更新企业微信组件客服组
      • 获取企业微信组件客服列表
      • 更新企业微信组件客服状态
    • 微信公众号账户升级
      • 获取微信公众号账户升级状态
    • 腾讯广告账户报表指标升级
      • 获取腾讯广告平台广告账户升级状态
    • 探索推广工具
      • 查询关键词流量接口
      • 获取关键词推荐结果
      • 查询行业业务点信息
    • 视频号精选评论管理
      • 设置视频号评论管理
    • 游戏特征信息
      • 获取游戏特征标签
      • 新增游戏 app 特征
      • 更新游戏 app 特征
      • 获取游戏 app 特征
  • 附录
    • 更多信息
  1. 微信原生页

基于模板创建微信原生页

开发环境
开发环境
POST
/v1.3/wechat_pages/add

请求参数#

标有*的参数为必填项
名称类型描述
account_id*integer广告主帐号 id,有操作权限的帐号 id,不支持代理商 id
page_name*string落地页名称 字段长度最小 1 字节,长度最大 120 字节
page_template_id*integer落地页模板 id
page_elements_spec_list*struct[]组件素材内容,组件的同步顺序与原生页的展示顺序一致,即第一个同步组件为顶部展示元素 数组最大长度 40
element_type*enum原生页中组件类型,[枚举详情] 枚举列表:{ IMAGE, VIDEO, TEXT, BUTTON, FORM, CAROUSEL, ELEMENT_TYPE_UNSUPPORTED, CARD_ROTATE_IMAGE, SHELF, FLOAT_BUTTON, GOODS, COMMON_COMPONENT, SWIPE_WEBVIEW, WEBVIEW, ANIMATE_FLOAT_BUTTON }
image_specstruct图片组件元素
image_id_list*string[]图片 id 列表 数组最小长度 1,最大长度 6 字段长度最小 1 字节,长度最大 64 字节
video_specstruct视频组件元素
video_id*int64视频 id,通过 [videos 模块] 上传视频后获得
text_specstruct文本组件元素
text*string文本内容 字段长度最小 1 字节,长度最大 30720 字节
button_specstruct按钮组件元素
titlestring按钮文案,具体长度以线下模板文档为主,审核规范:原生页当含有 app_android_spec 或 app_ios_spec 元素时, 下载按钮文案必须含有“安装”或“下载”才允许使用 字段长度最小 1 字节,长度最大 120 字节
urlstring跳转链接的 url,按钮组件元素时传入,支持通配符形式%%target_url_mobile%% 字段长度最小 1 字节,长度最大 1023 字节
link_specstruct外链信息
title*string按钮文案 字段长度最小 1 字节,长度最大 120 字节
urlstring跳转链接的 url,按钮组件元素时传入,支持通配符形式%%target_url_mobile%% 字段长度最小 1 字节,长度最大 1023 字节
deep_link_android_specstructAndroid 应用信息元素
deep_link_urlstring应用直达页 url 字段长度最小 0 字节,长度最大 2048 字节
app_android_id*stringAndroid 应用 id 字段长度最小 1 字节,长度最大 128 字节
deep_link_ios_specstructiOS 应用信息元素
deep_link_urlstring应用直达页 url 字段长度最小 0 字节,长度最大 2048 字节
app_ios_id*stringiOS 应用 id 字段长度最小 1 字节,长度最大 128 字节
mini_program_specstruct小程序信息,微信小程序信息
mini_program_id*string小程序 id 字段长度最小 1 字节,长度最大 384 字节
mini_program_path*string小程序路径 字段长度最小 1 字节,长度最大 2048 字节
app_ios_specstructiOS 应用信息元素
deep_link_urlstring应用直达页 url,支持通配符形式%%target_url_ios%% 字段长度最小 0 字节,长度最大 2048 字节
app_ios_id*stringiOS 应用 id 字段长度最小 1 字节,长度最大 128 字节
app_android_specstructAndroid 应用信息元素
deep_link_urlstring应用直达页 url,支持通配符形式%%target_url_android%% 字段长度最小 0 字节,长度最大 2048 字节
app_android_id*stringAndroid 应用 id 字段长度最小 1 字节,长度最大 128 字节
app_android_channel_package_idstringAndroid 应用渠道包 id,当前特指投放腾讯开放平台安卓应用的渠道包 id,从推广目标模块的读取接口可以获取 字段长度最小 0 字节,长度最大 128 字节
app_market_packagestring厂商应用商店包名,不为空则开启厂商应用商店下载 字段长度最小 0 字节,长度最大 512 字节
mini_program_specstruct小程序信息,微信小程序信息
title*string按钮文案 字段长度最小 1 字节,长度最大 120 字节
mini_program_id*string小程序 id 字段长度最小 1 字节,长度最大 384 字节
mini_program_path*string小程序路径 字段长度最小 1 字节,长度最大 2048 字节
mini_program_pathsstring[]小程序落地页 path 列表 数组最小长度 1,最大长度 255 字段长度最小 1 字节,长度最大 2048 字节
mini_game_program_specstruct小游戏信息,微信小游戏信息
title*string按钮文案 字段长度最小 1 字节,长度最大 120 字节
mini_game_program_id*string小程序 id 字段长度最小 1 字节,长度最大 384 字节
mini_game_program_pathstring小游戏监控参数,需以英文字符?开头,如:?channel=xxxx,字段长度最小 1 个等宽字符,长度最大 250 个等宽字符(即字段最大长度为 250 个中文字或全角标点,500 个英文字或半角标点。一个等宽字符等价于一个中文,等价于两个英文。) 字段长度最小 0 字节,长度最大 750 字节
fengye_specstruct枫叶信息
title*string按钮文案 字段长度最小 1 字节,长度最大 120 字节
fengye_id*string枫叶落地页 id 字段长度最小 1 字节,长度最大 384 字节
card_specstruct卡券信息
title*string按钮文案 字段长度最小 1 字节,长度最大 120 字节
card_id*string微信卡券 id 字段长度最小 1 字节,长度最大 384 字节
follow_specstruct关注公众号信息
title*string按钮文案 字段长度最小 1 字节,长度最大 120 字节
service_specstruct客服组建信息
title*string按钮文案 字段长度最小 1 字节,长度最大 120 字节
wecom_specstruct企业微信组件信息
title*string企业微信组件标题字段长度最小 1 个等宽字符,长度最大 10 个等宽字符(即字段最大长度为 10 个中文字或全角标点,20 个英文字或半角标点。) 字段长度最小 1 字节,长度最大 64 字节
groupidinteger企业微信组件客服组 id, [获取企业微信组件客服组] 最小值 0,最大值 9999999999
setidinteger地理位置集 id. groupid 或 setid 必填一个 最小值 0,最大值 9999999999
use_iconinteger是否在 button 组件下开启 icon 图标(0:不使用; 1:使用),灰度开放中 最小值 0,最大值 1
tel_specstruct电话组件信息
title*string电话组件标题字段长度最小 1 个等宽字符,长度最大 10 个等宽字符(即字段最大长度为 10 个中文字或全角标点,20 个英文字或半角标点。) 字段长度最小 1 字节,长度最大 64 字节
phone_numstring电话组件标题字段长度最小 1 个等宽字符,长度最大 12 个等宽字符(即字段最大长度为 10 个中文字或全角标点,20 个英文字或半角标点。) 字段长度最小 1 字节,长度最大 64 字节
form_specstruct表单组件元素
title*string按钮文案,具体长度以线下模板文档为主,按钮文案 字段长度最小 1 字节,长度最大 30 字节
element_shelfstruct图文复合组件
shelf_specstruct[]图文复合组件按钮信息,支持一行一个和一行两个 数组最大长度 32
shelf_button_spec*struct按钮信息
link_specstruct外链信息
title*string按钮文案 字段长度最小 1 字节,长度最大 120 字节
urlstring跳转链接的 url,按钮组件元素时传入,支持通配符形式%%target_url_mobile%% 字段长度最小 1 字节,长度最大 1023 字节
deep_link_android_specstructAndroid 应用信息元素
deep_link_urlstring应用直达页 url 字段长度最小 0 字节,长度最大 2048 字节
app_android_id*stringAndroid 应用 id 字段长度最小 1 字节,长度最大 128 字节
deep_link_ios_specstructiOS 应用信息元素
deep_link_urlstring应用直达页 url 字段长度最小 0 字节,长度最大 2048 字节
app_ios_id*stringiOS 应用 id 字段长度最小 1 字节,长度最大 128 字节
app_download_specstruct应用下载信息
title*string按钮文案,审核规范:原生页当含有 app_android_spec 或 app_ios_spec 元素时, 下载按钮文案必须含有“安装”或“下载”才允许使用 字段长度最小 1 字节,长度最大 120 字节
app_ios_specstructiOS 应用信息元素
deep_link_urlstring应用直达页 url,支持通配符形式%%target_url_ios%% 字段长度最小 0 字节,长度最大 2048 字节
app_ios_id*stringiOS 应用 id 字段长度最小 1 字节,长度最大 128 字节
app_android_specstructAndroid 应用信息元素
deep_link_urlstring应用直达页 url,支持通配符形式%%target_url_android%% 字段长度最小 0 字节,长度最大 2048 字节
app_android_id*stringAndroid 应用 id 字段长度最小 1 字节,长度最大 128 字节
app_android_channel_package_idstringAndroid 应用渠道包 id,当前特指投放腾讯开放平台安卓应用的渠道包 id,从推广目标模块的读取接口可以获取 字段长度最小 0 字节,长度最大 128 字节
app_market_packagestring厂商应用商店包名,不为空则开启厂商应用商店下载 字段长度最小 0 字节,长度最大 512 字节
mini_program_specstruct小程序信息,微信小程序信息
title*string按钮文案 字段长度最小 1 字节,长度最大 120 字节
mini_program_id*string小程序 id 字段长度最小 1 字节,长度最大 384 字节
mini_program_path*string小程序路径 字段长度最小 1 字节,长度最大 2048 字节
mini_program_pathsstring[]小程序落地页 path 列表 数组最小长度 1,最大长度 255 字段长度最小 1 字节,长度最大 2048 字节
wecom_specstruct企业微信组件信息
title*string企业微信组件标题字段长度最小 1 个等宽字符,长度最大 10 个等宽字符(即字段最大长度为 10 个中文字或全角标点,20 个英文字或半角标点。) 字段长度最小 1 字节,长度最大 64 字节
groupidinteger企业微信组件客服组 id, [获取企业微信组件客服组] 最小值 0,最大值 9999999999
setidinteger地理位置集 id. groupid 或 setid 必填一个 最小值 0,最大值 9999999999
image_id_list*string图片 id,通过 [images 模块] 上传图片后获得 字段长度最小 1 字节,长度最大 64 字节
title*string图文复合标题文案 悬浮组件:字段长度最小 1 个等宽字符,长度最大 10 个等宽字符(即字段最大长度为 10 个中文字或全角标点,20 个英文字或半角标点。) 单排货架组件:字段长度最小 1 个等宽字符,长度最大 12 个等宽字符(即字段最大长度为 12 个中文字或全角标点,24 个英文字或半角标点。) 双排货架组件:字段长度最小 1 个等宽字符,长度最大 10 个等宽字符(即字段最大长度为 10 个中文字或全角标点,20 个英文字或半角标点。) 字段长度最小 1 字节,长度最大 120 字节
desc*string图文复合描述文案 悬浮组件:字段长度最小 1 个等宽字符,长度最大 14 个等宽字符(即字段最大长度为 14 个中文字或全角标点,28 个英文字或半角标点。) 单排货架组件:字段长度最小 1 个等宽字符,长度最大 15 个等宽字符(即字段最大长度为 15 个中文字或全角标点,30 个英文字或半角标点。) 双排货架组件:字段长度最小 1 个等宽字符,长度最大 12 个等宽字符(即字段最大长度为 12 个中文字或全角标点,24 个英文字或半角标点。) 字段长度最小 1 字节,长度最大 120 字节
element_floatstruct悬浮组件
image_id_list*string图片 id,通过 [images 模块] 上传图片后获得 字段长度最小 1 字节,长度最大 64 字节
title*string图文复合标题文案 悬浮组件:字段长度最小 1 个等宽字符,长度最大 10 个等宽字符(即字段最大长度为 10 个中文字或全角标点,20 个英文字或半角标点。) 单排货架组件:字段长度最小 1 个等宽字符,长度最大 12 个等宽字符(即字段最大长度为 12 个中文字或全角标点,24 个英文字或半角标点。) 双排货架组件:字段长度最小 1 个等宽字符,长度最大 10 个等宽字符(即字段最大长度为 10 个中文字或全角标点,20 个英文字或半角标点。) 字段长度最小 1 字节,长度最大 120 字节
desc*string图文复合描述文案 悬浮组件:字段长度最小 1 个等宽字符,长度最大 14 个等宽字符(即字段最大长度为 14 个中文字或全角标点,28 个英文字或半角标点。) 单排货架组件:字段长度最小 1 个等宽字符,长度最大 15 个等宽字符(即字段最大长度为 15 个中文字或全角标点,30 个英文字或半角标点。) 双排货架组件:字段长度最小 1 个等宽字符,长度最大 12 个等宽字符(即字段最大长度为 12 个中文字或全角标点,24 个英文字或半角标点。) 字段长度最小 1 字节,长度最大 120 字节
float_button_spec*struct悬浮组件按钮
link_specstruct外链信息
title*string按钮文案 字段长度最小 1 字节,长度最大 120 字节
urlstring跳转链接的 url,按钮组件元素时传入,支持通配符形式%%target_url_mobile%% 字段长度最小 1 字节,长度最大 1023 字节
deep_link_android_specstructAndroid 应用信息元素
deep_link_urlstring应用直达页 url 字段长度最小 0 字节,长度最大 2048 字节
app_android_id*stringAndroid 应用 id 字段长度最小 1 字节,长度最大 128 字节
deep_link_ios_specstructiOS 应用信息元素
deep_link_urlstring应用直达页 url 字段长度最小 0 字节,长度最大 2048 字节
app_ios_id*stringiOS 应用 id 字段长度最小 1 字节,长度最大 128 字节
app_download_specstruct应用下载信息
title*string按钮文案,审核规范:原生页当含有 app_android_spec 或 app_ios_spec 元素时, 下载按钮文案必须含有“安装”或“下载”才允许使用 字段长度最小 1 字节,长度最大 120 字节
app_ios_specstructiOS 应用信息元素
deep_link_urlstring应用直达页 url,支持通配符形式%%target_url_ios%% 字段长度最小 0 字节,长度最大 2048 字节
app_ios_id*stringiOS 应用 id 字段长度最小 1 字节,长度最大 128 字节
app_android_specstructAndroid 应用信息元素
deep_link_urlstring应用直达页 url,支持通配符形式%%target_url_android%% 字段长度最小 0 字节,长度最大 2048 字节
app_android_id*stringAndroid 应用 id 字段长度最小 1 字节,长度最大 128 字节
app_android_channel_package_idstringAndroid 应用渠道包 id,当前特指投放腾讯开放平台安卓应用的渠道包 id,从推广目标模块的读取接口可以获取 字段长度最小 0 字节,长度最大 128 字节
app_market_packagestring厂商应用商店包名,不为空则开启厂商应用商店下载 字段长度最小 0 字节,长度最大 512 字节
mini_program_specstruct小程序信息,微信小程序信息
title*string按钮文案 字段长度最小 1 字节,长度最大 120 字节
mini_program_id*string小程序 id 字段长度最小 1 字节,长度最大 384 字节
mini_program_path*string小程序路径 字段长度最小 1 字节,长度最大 2048 字节
mini_program_pathsstring[]小程序落地页 path 列表 数组最小长度 1,最大长度 255 字段长度最小 1 字节,长度最大 2048 字节
mini_game_program_specstruct小游戏信息,微信小游戏信息
title*string按钮文案 字段长度最小 1 字节,长度最大 120 字节
mini_game_program_id*string小程序 id 字段长度最小 1 字节,长度最大 384 字节
mini_game_program_pathstring小游戏监控参数,需以英文字符?开头,如:?channel=xxxx,字段长度最小 1 个等宽字符,长度最大 250 个等宽字符(即字段最大长度为 250 个中文字或全角标点,500 个英文字或半角标点。一个等宽字符等价于一个中文,等价于两个英文。) 字段长度最小 0 字节,长度最大 750 字节
fengye_specstruct枫叶信息
title*string按钮文案 字段长度最小 1 字节,长度最大 120 字节
fengye_id*string枫叶落地页 id 字段长度最小 1 字节,长度最大 384 字节
card_specstruct卡券信息
title*string按钮文案 字段长度最小 1 字节,长度最大 120 字节
card_id*string微信卡券 id 字段长度最小 1 字节,长度最大 384 字节
follow_specstruct关注公众号信息
title*string按钮文案 字段长度最小 1 字节,长度最大 120 字节
service_specstruct客服组建信息
title*string按钮文案 字段长度最小 1 字节,长度最大 120 字节
wecom_specstruct企业微信组件信息
title*string企业微信组件标题字段长度最小 1 个等宽字符,长度最大 10 个等宽字符(即字段最大长度为 10 个中文字或全角标点,20 个英文字或半角标点。) 字段长度最小 1 字节,长度最大 64 字节
groupidinteger企业微信组件客服组 id, [获取企业微信组件客服组] 最小值 0,最大值 9999999999
setidinteger地理位置集 id. groupid 或 setid 必填一个 最小值 0,最大值 9999999999
element_goodsstruct商品组件
goods_button_spec*struct商品按钮
title*string按钮文案 字段长度最小 1 字节,长度最大 120 字节
element_swipestruct上划组件元素
jump_url*string上划组件跳转链接 字段长度最小 0 字节,长度最大 1023 字节
swipe_text*string上划组件文案,字段长度最小 1 个等宽字符,长度最大 10 等宽字符(即字段最大长度为 10 个中文字或全角标点,20 个英文字或半角标点。一个等宽字符等价于一个中文,等价于两个英文。) 字段长度最小 1 字节,长度最大 30 字节
element_webviewstructwebview 组件元素
url*stringwebview 链接 字段长度最小 0 字节,长度最大 1023 字节
element_animate_floatstruct动画悬浮组件,灰度开放中
image_id_list*string图片 id,通过 [images 模块] 上传图片后获得 字段长度最小 1 字节,长度最大 64 字节
title*string图文复合标题文案 悬浮组件:字段长度最小 1 个等宽字符,长度最大 10 个等宽字符(即字段最大长度为 10 个中文字或全角标点,20 个英文字或半角标点。) 单排货架组件:字段长度最小 1 个等宽字符,长度最大 12 个等宽字符(即字段最大长度为 12 个中文字或全角标点,24 个英文字或半角标点。) 双排货架组件:字段长度最小 1 个等宽字符,长度最大 10 个等宽字符(即字段最大长度为 10 个中文字或全角标点,20 个英文字或半角标点。) 字段长度最小 1 字节,长度最大 120 字节
desc*string图文复合描述文案 悬浮组件:字段长度最小 1 个等宽字符,长度最大 14 个等宽字符(即字段最大长度为 14 个中文字或全角标点,28 个英文字或半角标点。) 单排货架组件:字段长度最小 1 个等宽字符,长度最大 15 个等宽字符(即字段最大长度为 15 个中文字或全角标点,30 个英文字或半角标点。) 双排货架组件:字段长度最小 1 个等宽字符,长度最大 12 个等宽字符(即字段最大长度为 12 个中文字或全角标点,24 个英文字或半角标点。) 字段长度最小 1 字节,长度最大 120 字节
animate_float_button_spec*struct动画悬浮组件按钮
link_specstruct外链信息
title*string按钮文案 字段长度最小 1 字节,长度最大 120 字节
urlstring跳转链接的 url,按钮组件元素时传入,支持通配符形式%%target_url_mobile%% 字段长度最小 1 字节,长度最大 1023 字节
deep_link_android_specstructAndroid 应用信息元素
deep_link_urlstring应用直达页 url 字段长度最小 0 字节,长度最大 2048 字节
app_android_id*stringAndroid 应用 id 字段长度最小 1 字节,长度最大 128 字节
deep_link_ios_specstructiOS 应用信息元素
deep_link_urlstring应用直达页 url 字段长度最小 0 字节,长度最大 2048 字节
app_ios_id*stringiOS 应用 id 字段长度最小 1 字节,长度最大 128 字节
app_download_specstruct应用下载信息
title*string按钮文案,审核规范:原生页当含有 app_android_spec 或 app_ios_spec 元素时, 下载按钮文案必须含有“安装”或“下载”才允许使用 字段长度最小 1 字节,长度最大 120 字节
app_ios_specstructiOS 应用信息元素
deep_link_urlstring应用直达页 url,支持通配符形式%%target_url_ios%% 字段长度最小 0 字节,长度最大 2048 字节
app_ios_id*stringiOS 应用 id 字段长度最小 1 字节,长度最大 128 字节
app_android_specstructAndroid 应用信息元素
deep_link_urlstring应用直达页 url,支持通配符形式%%target_url_android%% 字段长度最小 0 字节,长度最大 2048 字节
app_android_id*stringAndroid 应用 id 字段长度最小 1 字节,长度最大 128 字节
app_android_channel_package_idstringAndroid 应用渠道包 id,当前特指投放腾讯开放平台安卓应用的渠道包 id,从推广目标模块的读取接口可以获取 字段长度最小 0 字节,长度最大 128 字节
app_market_packagestring厂商应用商店包名,不为空则开启厂商应用商店下载 字段长度最小 0 字节,长度最大 512 字节
follow_specstruct关注公众号信息
title*string按钮文案 字段长度最小 1 字节,长度最大 120 字节
mini_program_specstruct小程序信息,微信小程序信息
title*string按钮文案 字段长度最小 1 字节,长度最大 120 字节
mini_program_id*string小程序 id 字段长度最小 1 字节,长度最大 384 字节
mini_program_path*string小程序路径 字段长度最小 1 字节,长度最大 2048 字节
mini_program_pathsstring[]小程序落地页 path 列表 数组最小长度 1,最大长度 255 字段长度最小 1 字节,长度最大 2048 字节
mini_game_program_specstruct小游戏信息,微信小游戏信息
title*string按钮文案 字段长度最小 1 字节,长度最大 120 字节
mini_game_program_id*string小程序 id 字段长度最小 1 字节,长度最大 384 字节
mini_game_program_pathstring小游戏监控参数,需以英文字符?开头,如:?channel=xxxx,字段长度最小 1 个等宽字符,长度最大 250 个等宽字符(即字段最大长度为 250 个中文字或全角标点,500 个英文字或半角标点。一个等宽字符等价于一个中文,等价于两个英文。) 字段长度最小 0 字节,长度最大 750 字节
fengye_specstruct枫叶信息
title*string按钮文案 字段长度最小 1 字节,长度最大 120 字节
fengye_id*string枫叶落地页 id 字段长度最小 1 字节,长度最大 384 字节
card_specstruct卡券信息
title*string按钮文案 字段长度最小 1 字节,长度最大 120 字节
card_id*string微信卡券 id 字段长度最小 1 字节,长度最大 384 字节
service_specstruct客服组建信息
title*string按钮文案 字段长度最小 1 字节,长度最大 120 字节
wecom_specstruct企业微信组件信息
title*string企业微信组件标题字段长度最小 1 个等宽字符,长度最大 10 个等宽字符(即字段最大长度为 10 个中文字或全角标点,20 个英文字或半角标点。) 字段长度最小 1 字节,长度最大 64 字节
groupidinteger企业微信组件客服组 id, [获取企业微信组件客服组] 最小值 0,最大值 9999999999
setidinteger地理位置集 id. groupid 或 setid 必填一个 最小值 0,最大值 9999999999
share_content_spec*struct微信原生页分享信息
share_title*string原生页分享标题,字段长度最小 1 个等宽字符,长度最大 14 个等宽字符(即字段最大长度为 14 个中文字或全角标点,28 个英文字或半角标点。一个等宽字符等价于一个中文,等价于两个英文。)
share_description*string原生页分享描述,字段长度最小 1 个等宽字符,长度最大 20 个等宽字符(即字段最大长度为 20 个中文字或全角标点,40 个英文字或半角标点。一个等宽字符等价于一个中文,等价于两个英文。)
使用说明
1.
不同模板要求同步的组件顺序,填写的组件字段以及字段要求不同,具体请参见模板说明文档。
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/v1.3/wechat_pages/add' \
--header 'access_token;' \
--header 'timestamp;' \
--header 'nonce;' \
--data-urlencode 'account_id=<ACCOUNT_ID>' \
--data-urlencode 'page_name=test name' \
--data-urlencode 'page_template_id=<PAGE_TEMPLATE_ID>' \
--data-urlencode 'page_elements_spec_list=[{"element_type":"IMAGE","image_spec":{"image_id_list":["4152626:583dfc8e7f53a58db8293622b78a3c7f"]}},{"element_type":"BUTTON","button_spec":{"title":"拼多多模板 1","url":"http://jd.com","app_ios_spec":{"deep_link_url":"pinduoduo://com.xunmeng.pinduoduo/goods.html?goods_id=3163709495&_p_ads_channel=weixin&_p_launch_type=adv&_p_ads_set=shangxiang&account_id=wx95c952f67a727090","app_ios_id":"1044283059"},"app_android_spec":{"deep_link_url":"pinduoduo://com.xunmeng.pinduoduo/goods.html?goods_id=3163709495&_p_ads_channel=weixin&_p_launch_type=adv&_p_ads_set=shangxiang&account_id=wx95c952f67a727090","app_android_id":"1104790111","app_android_channel_package_id":"72243366;000116083635303838333533"}}},{"element_type":"IMAGE","image_spec":{"image_id_list":["1613822"]}},{"element_type":"IMAGE","image_spec":{"image_id_list":["1613374"]}},{"element_type":"BUTTON","button_spec":{"title":"拼多多模板 1","url":"http://jd.com","app_ios_spec":{"deep_link_url":"pinduoduo://com.xunmeng.pinduoduo/goods.html?goods_id=3163709495&_p_ads_channel=weixin&_p_launch_type=adv&_p_ads_set=shangxiang&account_id=wx95c952f67a727090","app_ios_id":"1044283059"},"app_android_spec":{"deep_link_url":"pinduoduo://com.xunmeng.pinduoduo/goods.html?goods_id=3163709495&_p_ads_channel=weixin&_p_launch_type=adv&_p_ads_set=shangxiang&account_id=wx95c952f67a727090","app_android_id":"1104790111","app_android_channel_package_id":"72243366;000116083635303838333533"}}},{"element_type":"IMAGE","image_spec":{"image_id_list":["1613374"]}},{"element_type":"BUTTON","button_spec":{"title":"拼多多模板 1","url":"http://jd.com","app_ios_spec":{"deep_link_url":"pinduoduo://com.xunmeng.pinduoduo/goods.html?goods_id=3163709495&_p_ads_channel=weixin&_p_launch_type=adv&_p_ads_set=shangxiang&account_id=wx95c952f67a727090","app_ios_id":"1044283059"},"app_android_spec":{"deep_link_url":"pinduoduo://com.xunmeng.pinduoduo/goods.html?goods_id=3163709495&_p_ads_channel=weixin&_p_launch_type=adv&_p_ads_set=shangxiang&account_id=wx95c952f67a727090","app_android_id":"1104790111","app_android_channel_package_id":"72243366;000116083635303838333533"}}}]' \
--data-urlencode 'share_content_spec={"share_title":"分享标题","share_description":"分享描述信息"}' \
--data-urlencode 'share_title=' \
--data-urlencode 'share_description='
响应示例响应示例
{
    "code": 0,
    "message": "",
    "message_cn": "",
    "data": {
        "page_id": 1
    }
}

请求参数

Header 参数
access_token
string 
必需
以Query Parameter方式在请求路径中传递。 授权令牌,完成 OAuth 2.0 授权后获得,参考授权认证章节。
默认值:
<ACCESS_TOKEN>
timestamp
string 
必需
以Query Parameter方式在请求路径中传递。 当前的时间戳,单位为秒,允许客户端请求最大时间误差为300秒。
MarketingAPI 所使用的时间戳,若无特殊说明,均为秒级时间戳
MarketingAPI 所使用的时区为GMT+8,例如当时间戳为1494840119时,表示 2018-05-15 17:21:59
默认值:
<TIMESTAMP>
nonce
string 
必需
以Query Parameter方式在请求路径中传递。 随机字串标识,不超过32个字符,由调用方自行生成,需保证全局唯一性。
默认值:
<NONCE>
Body 参数application/x-www-form-urlencoded
account_id
integer 
必需
广告主帐号 id,有操作权限的帐号 id,不支持代理商 id
示例值:
<ACCOUNT_ID>
page_name
string 
必需
落地页名称
字段长度最小 1 字节,长度最大 120 字节
示例值:
test name
page_template_id
integer 
落地页模板 id
必需
示例值:
<PAGE_TEMPLATE_ID>
page_elements_spec_list
string 
必需
组件素材内容,组件的同步顺序与原生页的展示顺序一致,即第一个同步组件为顶部展示元素
数组最大长度 40
示例值:
[{"element_type":"IMAGE","image_spec":{"image_id_list":["4152626:583dfc8e7f53a58db8293622b78a3c7f"]}},{"element_type":"BUTTON","button_spec":{"title":"拼多多模板 1","url":"http://jd.com","app_ios_spec":{"deep_link_url":"pinduoduo://com.xunmeng.pinduoduo/goods.html?goods_id=3163709495&_p_ads_channel=weixin&_p_launch_type=adv&_p_ads_set=shangxiang&account_id=wx95c952f67a727090","app_ios_id":"1044283059"},"app_android_spec":{"deep_link_url":"pinduoduo://com.xunmeng.pinduoduo/goods.html?goods_id=3163709495&_p_ads_channel=weixin&_p_launch_type=adv&_p_ads_set=shangxiang&account_id=wx95c952f67a727090","app_android_id":"1104790111","app_android_channel_package_id":"72243366;000116083635303838333533"}}},{"element_type":"IMAGE","image_spec":{"image_id_list":["1613822"]}},{"element_type":"IMAGE","image_spec":{"image_id_list":["1613374"]}},{"element_type":"BUTTON","button_spec":{"title":"拼多多模板 1","url":"http://jd.com","app_ios_spec":{"deep_link_url":"pinduoduo://com.xunmeng.pinduoduo/goods.html?goods_id=3163709495&_p_ads_channel=weixin&_p_launch_type=adv&_p_ads_set=shangxiang&account_id=wx95c952f67a727090","app_ios_id":"1044283059"},"app_android_spec":{"deep_link_url":"pinduoduo://com.xunmeng.pinduoduo/goods.html?goods_id=3163709495&_p_ads_channel=weixin&_p_launch_type=adv&_p_ads_set=shangxiang&account_id=wx95c952f67a727090","app_android_id":"1104790111","app_android_channel_package_id":"72243366;000116083635303838333533"}}},{"element_type":"IMAGE","image_spec":{"image_id_list":["1613374"]}},{"element_type":"BUTTON","button_spec":{"title":"拼多多模板 1","url":"http://jd.com","app_ios_spec":{"deep_link_url":"pinduoduo://com.xunmeng.pinduoduo/goods.html?goods_id=3163709495&_p_ads_channel=weixin&_p_launch_type=adv&_p_ads_set=shangxiang&account_id=wx95c952f67a727090","app_ios_id":"1044283059"},"app_android_spec":{"deep_link_url":"pinduoduo://com.xunmeng.pinduoduo/goods.html?goods_id=3163709495&_p_ads_channel=weixin&_p_launch_type=adv&_p_ads_set=shangxiang&account_id=wx95c952f67a727090","app_android_id":"1104790111","app_android_channel_package_id":"72243366;000116083635303838333533"}}}]
share_content_spec
string 
必需
微信原生页分享信息
示例值:
{"share_title":"分享标题","share_description":"分享描述信息"}
share_title
string 
必需
原生页分享标题,字段长度最小 1 个等宽字符,长度最大 14 个等宽字符(即字段最大长度为 14 个中文字或全角标点,28 个英文字或半角标点。一个等宽字符等价于一个中文,等价于两个英文。)
share_description
string 
必需
原生页分享描述,字段长度最小 1 个等宽字符,长度最大 20 个等宽字符(即字段最大长度为 20 个中文字或全角标点,40 个英文字或半角标点。一个等宽字符等价于一个中文,等价于两个英文。)

返回响应

🟢200成功
application/json
Body
code
integer 
必需
message
string 
必需
message_cn
string 
必需
data
object 
必需
page_id
integer 
落地页 id
必需
修改于 2023-11-02 07:38:31
上一页
创建用于广告投放的动态广告视频
下一页
基于组件创建微信原生页
Built with