微信小程序开发文档 第46页

用户画像 获取小程序新增或活跃用户的画像分布数据。时间范围支持昨天、最近7天、最近30天。其中，新增用户数为时间范围内首次访问小程序的去重用户数，活跃用户数为时间范围内访问过小程序的去重用户数。画像属性包括用户年龄、性别、省份、城市、终端类型、机型。 接口地址： https://api.weixin.qq.com/datacube/getweanalysisappiduserportrait?access_token=ACCESS_TOKEN POST 请求参数说明： 参数 是否必填 说明 begin_date 是 开始日期 end_date 是 结束日期，开始日期与结束日期相差的天数限定为0/6/29，分别表示查询最近1/7/30天数据，end_date允许设置的最大值为昨日 POST 内容示例： { "begin_date" : "2017-06-11", "end_date" : "2017-06-17" } 返回参数说明： 每次请求返回选定的时间范围及以下指标项： 参数 说明 ref_date 时间范围,如： “20170611-20170617” visit_uv_new 新用户 visit_uv 活跃用户 每个指标项下包括的属性： 参数 说明 province 省份，如北京、广东等 city 城市，如北京、广州等 genders 性别，包括男、女、未知 platfomrs 终端类型，包括iPhone, android,其他 devices 机型，如苹果iPhone6, OPPO R9等 ages 年龄，包括17岁以下、18-24岁等区间 每个属性下包括的数据项： 参数 说明 id 属性值id name 属性值名称，与id一一对应。如属性为province时，返回的属性值名称包括“广东”等 value 属性值对应的指标值，如指标为visit_uv,属性为province,属性值为”广东省”，value对应广东地区的活跃用户数 返回数据示例： { "ref_date": "20170611", "visit_uv_new": { "province": [ { "id": 31, "name": "广东省", "value": 215 } ], "city": [ { "id": 3102, "name": "广州", "value": 78 } ], "genders": [ { "id": 1, "name": "男", "value": 2146 } ], "platforms": [ { "id": 1, "name": "iPhone", "value": 27642 } ], "devices": [ { "name": "OPPO R9", "value": 61...

访问分析 获取小程序访问分析数据，数据说明参见访问分析 访问趋势 日趋势 接口地址 https://api.weixin.qq.com/datacube/getweanalysisappiddailyvisittrend?access_token=ACCESS_TOKEN POST 参数说明 参数 是否必填 说明 begin_date 是 开始日期 end_date 是 结束日期，限定查询1天数据，end_date允许设置的最大值为昨日 POST 内容示例： { "begin_date" : "20170313", "end_date" : "20170313" } 返回参数说明： 参数 说明 ref_date 时间： 如： “20170313” session_cnt 打开次数 visit_pv 访问次数 visit_uv 访问人数 visit_uv_new 新用户数 stay_time_uv 人均停留时长 (浮点型，单位：秒) stay_time_session 次均停留时长 (浮点型，单位：秒) visit_depth 平均访问深度 (浮点型) 返回数据示例： { "list": [ { "ref_date": "20170313", "session_cnt": 142549, "visit_pv": 472351, "visit_uv": 55500, "visit_uv_new": 5464, "stay_time_session": 0, "visit_depth": 1.9838 } ] } 周趋势 接口地址 https://api.weixin.qq.com/datacube/getweanalysisappidweeklyvisittrend?access_token=ACCESS_TOKEN POST 参数说明： 参数 是否必填 说明 begin_date 是 开始日期，为周一日期 end_date 是 结束日期，为周日日期，限定查询一周数据 注意：请求json和返回json与天的一致，这里限定查询一个自然周的数据，时间必须按照自然周的方式输入： 如：20170306(周一), 20170312(周日) POST 内容示例： { "begin_date":"20170306", "end_date":"20170312" } 返回参数说明： 参数 说明 ref_date 时间，如：”20170306-20170312″ session_cnt 打开次数（自然周内汇总） visit_pv 访问次数（自然周内汇总） visit_uv 访问人数（自然周内去重） visit_uv_new 新用户数（自然周内去重） stay_time_uv 人均停留时长 (浮点型，单位：秒) stay_time_session 次均停留时长 (浮点型，单位：秒) visit_depth 平均访问深度 (浮点型) 返回内容示例： {...

数据分析接口 开发者通过数据分析接口，可获取到小程序的各项数据指标，便于进行数据存储和整理。数据分析详细功能介绍及指标解释参见数据分析文档。 概况 用户访问小程序的详细数据可从访问分析中获取，概况中提供累计用户数等部分指标数据。 概况趋势 接口地址 https://api.weixin.qq.com/datacube/getweanalysisappiddailysummarytrend?access_token=ACCESS_TOKEN 获取 access_token 详见文档 POST 请求参数说明： 参数 是否必填 说明 begin_date 是 开始日期 end_date 是 结束日期，限定查询1天数据，end_date允许设置的最大值为昨日 POST 内容示例： { "begin_date" : "20170313", "end_date" : "20170313" } 返回参数说明： 参数 说明 visit_total 累计用户数 share_pv 转发次数 share_uv 转发人数 返回数据示例： { "list": [ { "ref_date": "20170313", "visit_total": 391, "share_pv": 572, "share_uv": 383 } ] }

wx.requestSubscribeMessage(Object object) 基础库 2.4.4 开始支持，低版本需做兼容处理。 调起客户端小程序订阅消息界面，返回用户订阅消息的操作结果。当用户勾选了订阅面板中的“总是保持以上选择，不再询问”时，模板消息会被添加到用户的小程序设置页，通过 wx.getSetting 接口可获取用户对相关模板消息的订阅状态。 注意事项 一次性模板 id 和永久模板 id 不可同时使用。 低版本基础库2.4.4~2.8.3 已支持订阅消息接口调用，仅支持传入一个一次性 tmplId / 永久 tmplId。 2.8.2 版本开始，用户发生点击行为或者发起支付回调后，才可以调起订阅消息界面。 2.10.0 版本开始，开发版和体验版小程序将禁止使用模板消息 formId。 参数 Object object 属性 类型 默认值 必填 说明 tmplIds Array 是 需要订阅的消息模板的id的集合，一次调用最多可订阅3条消息（注意：iOS客户端7.0.6版本、Android客户端7.0.7版本之后的一次性订阅/长期订阅才支持多个模板消息，iOS客户端7.0.5版本、Android客户端7.0.6版本之前的一次订阅只支持一个模板消息）消息模板id在[微信公众平台(mp.weixin.qq.com)-功能-订阅消息]中配置 success function 否 接口调用成功的回调函数 fail function 否 接口调用失败的回调函数 complete function 否 接口调用结束的回调函数（调用成功、失败都会执行） object.success 回调函数 参数 Object res 属性 类型 说明 errMsg String 接口调用成功时errMsg值为’requestSubscribeMessage:ok’ TEMPLATE_ID String [TEMPLATE_ID]是动态的键，即模板id，值包括’accept’、’reject’、’ban’。’accept’表示用户同意订阅该条id对应的模板消息，’reject’表示用户拒绝订阅该条id对应的模板消息，’ban’表示已被后台封禁。例如 { errMsg: “requestSubscribeMessage:ok”, zun-LzcQyW-edafCVvzPkK4de2Rllr1fFpw2A_x0oXE: “accept”} 表示用户同意订阅zun-LzcQyW-edafCVvzPkK4de2Rllr1fFpw2A_x0oXE这条消息 object.fail 回调函数 参数 Object res 属性 类型 说明 errMsg String 接口调用失败错误信息 errCode Number 接口调用失败错误码 错误码 errCode errMsg 说明 10001 TmplIds can’t be empty 参数传空了 10002 Request list fail 网络问题，请求消息列表失败 10003 Request subscribe fail 网络问题，订阅请求发送失败 10004 Invalid template id 参数类型错误 10005 Cannot show subscribe message UI 无法展示 UI，一般是小程序这个时候退后台了导致的 20001 No template data return, verify the template...

Performance 基础库 2.11.0 开始支持，低版本需做兼容处理。 Performance 对象，用于获取性能数据及创建性能监听器 方法： PerformanceObserver Performance.createObserver(function callback) 基础库 2.11.0 开始支持，低版本需做兼容处理。 创建全局性能事件监听器 参数 function callback 返回值 PerformanceObserver Array Performance.getEntries() 基础库 2.11.0 开始支持，低版本需做兼容处理。 该方法返回当前缓冲区中的所有性能数据 返回值 Array Array Performance.getEntriesByName(string name, string entryType) 基础库 2.11.0 开始支持，低版本需做兼容处理。 获取当前缓冲区中所有名称为 [name] 且类型为 [entryType] 的性能数据 参数 string name string entryType 返回值 Array Array Performance.getEntriesByType(string entryType) 基础库 2.11.0 开始支持，低版本需做兼容处理。 获取当前缓冲区中所有类型为 [entryType] 的性能数据 参数 string entryType 返回值 Array Performance.setBufferSize(number size) 基础库 2.11.0 开始支持，低版本需做兼容处理。 设置缓冲区大小， 默认缓冲 30 条性能数据 参数 number size

wx.getPerformance() 基础库 2.11.0 开始支持，低版本需做兼容处理。 获取当前小程序性能相关的信息。 目前支持获取以下几类性能指标： 类别 名称 (entryType) 指标 路由 navigation route, appLaunch 渲染 render firstRender 脚本 script evaluateScript route: 路由性能 appLaunch: 小程序启动耗时 firstRender: 页面首次渲染耗时 evaluateScript: 注入脚本耗时 示例代码 const performance = wx.getPerformance() const observer = performance.createObserver((entryList) => { console.log(entryList.getEntries()) }) observer.observe({ entryTypes: ['render', 'script'] })

wx.reportPerformance(Number id, Number value, String|Array dimensions) 基础库 2.9.2 开始支持，低版本需做兼容处理。 小程序测速上报。使用前，需要在小程序管理后台配置。  参数 Number id 指标 id Number value 需要上报的数值 String|Array dimensions 自定义维度 (选填) 示例代码 wx.reportPerformance(1101, 680) wx.reportPerformance(1101, 680, 'custom')

wx.checkIsSupportSoterAuthentication(OBJECT) 基础库 1.5.0 开始支持，低版本需做兼容处理 获取本机支持的 SOTER 生物认证方式 Object参数说明： 参数 类型 必填 说明 success Function 否 接口调用成功的回调函数 fail Function 否 接口调用失败的回调函数 complete Function 否 接口调用结束的回调函数（调用成功、失败都会执行） success返回参数说明： 参数名 类型 说明 supportMode StringArray 该设备支持的可被SOTER识别的生物识别方式 errMsg String 接口调用结果 supportMode 有效值： 值 说明 fingerPrint 指纹识别 facial 人脸识别（暂未支持） speech 声纹识别（暂未支持） 示例代码： wx.checkIsSupportSoterAuthentication({ success(res) { // res.supportMode = [] 不具备任何被SOTER支持的生物识别方式 // res.supportMode = ['fingerPrint'] 只支持指纹识别 // res.supportMode = ['fingerPrint', 'facial'] 支持指纹识别和人脸识别 }})

wx.getWeRunData(OBJECT) 基础库 1.2.0 开始支持，低版本需做兼容处理 获取用户过去三十天微信运动步数，需要先调用 wx.login 接口。 OBJECT参数说明： 参数名 类型 必填 说明 success Function 否 接口调用成功的回调函数 fail Function 否 接口调用失败的回调函数 complete Function 否 接口调用结束的回调函数（调用成功、失败都会执行） success返回参数说明： 参数名 类型 说明 errMsg String 调用结果 encryptedData String 包括敏感数据在内的完整用户信息的加密数据，详细见加密数据解密算法 iv String 加密算法的初始向量，详细见加密数据解密算法 示例代码： wx.getWeRunData({ success(res) { const encryptedData = res.encryptedData } }) encryptedData 解密后为以下 json 结构，详见加密数据解密算法 属性 类型 说明 stepInfoList ObjectArray 用户过去三十天的微信运动步数 stepInfo 结构如下 属性 类型 说明 timestamp Number 时间戳，表示数据对应的时间 step Number 微信运动步数 { "stepInfoList": [ { "timestamp": 1445866601, "step": 100 }, { "timestamp": 1445866602, "step": 100 } ] }

获取二维码 通过后台接口可以获取小程序任意页面的二维码，扫描该二维码可以直接进入小程序对应的页面。目前微信支持两种二维码，小程序码（左），小程序二维码（右），如下所示： 可以使用开发工具 1.02.1803130 及以后版本通过二维码编译功能调试所获得的二维码 获取小程序码 我们推荐生成并使用小程序码，它具有更好的辨识度。目前有两个接口可以生成小程序码，开发者可以根据自己的需要选择合适的接口。 接口A: 适用于需要的码数量较少的业务场景 接口地址： https://api.weixin.qq.com/wxa/getwxacode?access_token=ACCESS_TOKEN 获取 access_token 详见文档 POST 参数说明 参数 类型 默认值 说明 path String   不能为空，最大长度 128 字节 width Int 430 二维码的宽度 auto_color Bool false 自动配置线条颜色，如果颜色依然是黑色，则说明不建议配置主色调 line_color Object {“r”:”0″,”g”:”0″,”b”:”0″} auth_color 为 false 时生效，使用 rgb 设置颜色 例如 {“r”:”xxx”,”g”:”xxx”,”b”:”xxx”} 注意：通过该接口生成的小程序码，永久有效，数量限制见文末说明，请谨慎使用。用户扫描该码进入小程序后，将直接进入 path 对应的页面。 接口B：适用于需要的码数量极多，或仅临时使用的业务场景 接口地址： https://api.weixin.qq.com/wxa/getwxacodeunlimit?access_token=ACCESS_TOKEN 获取 access_token 详见文档 POST 参数说明 参数 类型 默认值 说明 scene String   最大32个可见字符，只支持数字，大小写英文以及部分特殊字符：!#$&'()*+,/:;=?@-._~，其它字符请自行编码为合法字符（因不支持%，中文无法使用 urlencode 处理，请使用其他编码方式） page String   必须是已经发布的小程序页面，例如 “pages/index/index” ,如果不填写这个字段，默认跳主页面 width Int 430 二维码的宽度 auto_color Bool false 自动配置线条颜色，如果颜色依然是黑色，则说明不建议配置主色调 line_color Object {“r”:”0″,”g”:”0″,”b”:”0″} auto_color 为 false 时生效，使用 rgb 设置颜色 例如 {“r”:”xxx”,”g”:”xxx”,”b”:”xxx”} 注意：通过该接口生成的小程序码，永久有效，数量暂无限制。用户扫描该码进入小程序后，开发者需在对应页面获取的码中 scene 字段的值，再做处理逻辑。使用如下代码可以获取到二维码中的 scene 字段的值。调试阶段可以使用开发工具的条件编译自定义参数 scene=xxxx 进行模拟，开发工具模拟时的 scene 的参数值需要进行 urlencode // 这是首页的 js Page({ onLoad: function(options) { // options 中的 scene 需要使用 decodeURIComponent 才能获取到生成二维码时传入的 scene var scene = decodeURIComponent(options.scene)...