开发者通过数据分析接口,可获取到小程序的各项数据指标,便于进行数据存储和整理。数据分析详细功能介绍及指标解释参见数据分析文档。
常规分析
概况
用户访问小程序的详细数据可从访问分析中获取,概况中提供累计用户数等部分指标数据。
概况趋势
接口地址
https://api.weixin.qq.com/datacube/getweanalysisappiddailysummarytrend?access_token=ACCESS_TOKEN
获取 access_token 详见文档
POST 请求参数说明:
| 参数 | 是否必填 | 说明 |
|---|---|---|
| begin_date | 是 | 开始日期 |
| end_date | 是 | 结束日期,限定查询1天数据,end_date允许设置的最大值为昨日 |
{ "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 } ]}访问分析
访问趋势
日趋势
接口地址
https://api.weixin.qq.com/datacube/getweanalysisappiddailyvisittrend?access_token=ACCESS_TOKEN
POST 请求参数说明:
| 参数 | 是否必填 | 说明 |
|---|---|---|
| begin_date | 是 | 开始日期 |
| end_date | 是 | 结束日期,限定查询1天数据,end_date允许设置的最大值为昨日 |
{ "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 | 平均访问深度 (浮点型) |
周趋势
接口地址
https://api.weixin.qq.com/datacube/getweanalysisappidweeklyvisittrend?access_token=ACCESS_TOKEN
POST 请求参数说明:
| 参数 | 是否必填 | 说明 |
|---|---|---|
| begin_date | 是 | 开始日期,为周一日期 |
| end_date | 是 | 结束日期,为周日日期,限定查询一周数据 |
注意:请求json和返回json与天的一致,这里限定查询一个自然周的数据,时间必须按照自然周的方式输入: 如:20170306(周一), 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/getweanalysisappidmonthlyvisittrend?access_token=ACCESS_TOKEN
| 参数 | 是否必填 | 说明 |
|---|---|---|
| begin_date | 是 | 开始日期,为自然月第一天 |
| end_date | 是 | 结束日期,为自然月最后一天,限定查询一个月数据 |
注意:请求json和返回json与天的一致,这里限定查询一个自然月的数据,时间必须按照自然月的方式输入: 如:20170201(月初), 20170228(月末)
返回参数说明:
| 参数 | 说明 |
|---|---|
| ref_date | 时间,如:”201702” |
| session_cnt | 打开次数(自然月内汇总) |
| visit_pv | 访问次数(自然月内汇总) |
| visit_uv | 访问人数(自然月内去重) |
| visit_uv_new | 新用户数(自然月内去重) |
| stay_time_uv | 人均停留时长 (浮点型,单位:秒) |
| stay_time_session | 次均停留时长 (浮点型,单位:秒) |
| visit_depth | 平均访问深度 (浮点型) |
访问分布
接口地址
https://api.weixin.qq.com/datacube/getweanalysisappidvisitdistribution?access_token=ACCESS_TOKEN
POST 请求参数说明:
| 参数 | 是否必填 | 说明 |
|---|---|---|
| begin_date | 是 | 开始日期 |
| end_date | 是 | 结束日期,限定查询1天数据,end_date允许设置的最大值为昨日 |
返回参数说明:
| 参数 | 说明 |
|---|---|
| ref_date | 时间,如:”20170313” |
| list | 存入所有类型的指标情况 |
返回数据示例:{ "ref_date": "20170313", //时间 "list": [//存入所有类型的指标情况 { //分布类型 "index": "access_source_session_cnt"//访问来源分布 "item_list": [//分布数据列表 { "key": 1, //小程序历史列表 "value": 5 }, 1:小程序历史列表 2:搜索 3:会话 4:二维码 5:公众号主页 6:聊天顶部 7:系统桌面 8:小程序主页 9:附近的小程序 10:其他 11:模板消息 12:客服消息 13: 公众号菜单 14: APP分享 15: 支付完成页 16: 长按识别二维码 17:相册选取二维码 18: 公众号文章 ] }, { "index": "access_staytime_info",//访问时长分布 "item_list": [ { "key": 1,//访问时长 0-2s "value": 4511 }, 1: 0-2s 2: 3-5s 3: 6-10s 4: 11-20s 5: 20-30s 6: 30-50s 7: 50-100s 8: > 100s ] }, { "index": "access_depth_info",//访问深度的分布 "item_list": [ { "key": 1,//平均访问深度 1页 "value": 43201 }, 1: 1页 2: 2页 3: 3页 4: 4页 5: 5页 6: 6-10页 7: >10页 ] } ]}访问留存
日留存
接口地址
https://api.weixin.qq.com/datacube/getweanalysisappiddailyretaininfo?access_token=ACCESS_TOKEN
POST 请求参数说明:
| 参数 | 是否必填 | 说明 |
|---|---|---|
| begin_date | 是 | 开始日期 |
| end_date | 是 | 结束日期,限定查询1天数据,end_date允许设置的最大值为昨日 |
返回参数说明:
| 参数 | 说明 |
|---|---|
| visit_uv_new | 新增用户留存 |
| visit_uv | 活跃用户留存 |
返回数据示例:{ "ref_date": "20170313", "visit_uv_new": [ { "key": 0,//标识,0开始,0表示当天,1表示1天后,依此类推,key取值分别是:0,1,2,3,4,5,6,7,14,30 "value": 5464//key对应日期的新增用户数/活跃用户数(key=0时)或留存用户数(k>0时) } ], "visit_uv": [ { "key": 0, "value": 55500 } ]}周留存
接口地址
https://api.weixin.qq.com/datacube/getweanalysisappidweeklyretaininfo?access_token=ACCESS_TOKEN
POST 请求参数说明:
| 参数 | 是否必填 | 说明 |
|---|---|---|
| begin_date | 是 | 开始日期,为周一日期 |
| end_date | 是 | 结结束日期,为周日日期,限定查询一周数据 |
注意:请求json和返回json与天的一致,这里限定查询一个自然周的数据,时间必须按照自然周的方式输入: 如:20170306(周一), 20170312(周日)
返回参数说明:
| 参数 | 说明 |
|---|---|
| ref_date | 时间,如:”20170306-20170312” |
| visit_uv_new | 新增用户留存 |
| visit_uv | 活跃用户留存 |
返回数据示例:{ "ref_date": "20170313", "visit_uv_new": [ { "key": 0,//标识,0开始,0表示当周,1表示1周后,依此类推,key取值分别是:0,1,2,3,4 "value": 5464//key对应日期的新增用户数/活跃用户数(key=0时)或留存用户数(k>0时) } ], "visit_uv": [ { "key": 0, "value": 55500 } ]}月留存
接口地址
https://api.weixin.qq.com/datacube/getweanalysisappidmonthlyretaininfo?access_token=ACCESS_TOKEN
POST 请求参数说明:
| 参数 | 是否必填 | 说明 |
|---|---|---|
| begin_date | 是 | 开始日期,为自然月第一天 |
| end_date | 是 | 结束日期,为自然月最后一天,限定查询一个月数据 |
注意:请求json和返回json与天的一致,这里限定查询一个自然月的数据,时间必须按照自然月的方式输入: 如:20170201(月初), 20170228(月末)
返回参数说明:
| 参数 | 说明 |
|---|---|
| ref_date | 时间,如:”201702” |
| visit_uv_new | 新增用户留存 |
| visit_uv | 活跃用户留存 |
返回数据示例:{ "ref_date": "20170313", "visit_uv_new": [ { "key": 0,//标识,0开始,0表示当月,1表示1月后,key取值分别是:0,1 "value": 5464//key对应日期的新增用户数/活跃用户数(key=0时)或留存用户数(k>0时) } ], "visit_uv": [ { "key": 0, "value": 55500 } ]}访问页面
接口地址
https://api.weixin.qq.com/datacube/getweanalysisappidvisitpage?access_token=ACCESS_TOKEN
POST 请求参数说明:
| 参数 | 是否必填 | 说明 |
|---|---|---|
| begin_date | 是 | 开始日期 |
| end_date | 是 | 结束日期,限定查询1天数据,end_date允许设置的最大值为昨日 |
注意:请求json和返回json与天的一致,这里限定查询一个自然月的数据,时间必须按照自然月的方式输入: 如:20170201(月初), 20170228(月末)
返回参数:
返回数据示例:{ "ref_date": "20170313", "list": [ { "page_path": "pages/main/main.html",//页面路径 "page_visit_pv": 213429,//访问次数 "page_visit_uv": 55423,//访问人数 "page_staytime_pv": 8.139198,//次均停留时长 "entrypage_pv": 117922,//进入页次数 "exitpage_pv": 61304,//退出页次数 "page_share_pv": 180,//转发次数 "page_share_uv": 166//转发人数 }, { "page_path": "pages/linedetail/linedetail.html", "page_visit_pv": 155030, "page_visit_uv": 42195, "page_staytime_pv": 35.462395, "entrypage_pv": 21101, "exitpage_pv": 47051, "page_share_pv": 47, "page_share_uv": 42 } ]}用户画像
获取小程序新增或活跃用户的画像分布数据。时间范围支持昨天、最近7天、最近30天。其中,新增用户数为时间范围内首次访问小程序的去重用户数,活跃用户数为时间范围内访问过小程序的去重用户数。画像属性包括用户年龄、性别、省份、城市、终端类型、机型。
接口地址: https://api.weixin.qq.com/datacube/getweanalysisappiduserportrait?access_token=ACCESS_TOKEN
POST 请求参数说明:
{ "begin_date" : "2017-06-11",//(必要)开始日期 "end_date" : "2017-06-17"//(必要)结束日期,开始日期与结束日期相差的天数限定为0/6/29,分别表示查询最近1/7/30天数据,end_date允许设置的最大值为昨日}返回参数说明:
{ "ref_date": "20170611",//时间范围,如: "20170611-20170617" "visit_uv_new": { //新用户,visit_uv 活跃用户 "province": [//省份 {//每个属性下包括的数据项: "id": 31,//属性值id "name": "广东省",//属性值名称,与id一一对应。如属性为province时,返回的属性值名称包括“广东”等 "value": 215//属性值对应的指标值,如指标为visit_uv,属性为province,属性值为"广东省”,value对应广东地区的活跃用户数 } ], "city": [//城市 { "id": 3102, "name": "广州", "value": 78 } ], "genders": [//性别 { "id": 1, "name": "男", "value": 2146 } ], "platforms": [//终端类型,包括iPhone, android,其他 { "id": 1, "name": "iPhone", "value": 27642 } ], "devices": [//机型,如苹果iPhone6, OPPO R9等 { "name": "OPPO R9", "value": 61 } ], "ages": [//年龄,包括17岁以下、18-24岁等区间 { "id": 1, "name": "17岁以下", "value": 151 } ] }}1、由于部分用户属性数据缺失,属性值可能出现 “未知”。
2、机型数据无 id 字段,暂只提供用户数最多的 top20。
自定义分析
wx.reportAnalytics(eventName, data)自定义数据上报
自定义分析数据上报接口。使用前,需要在小程序管理后台自定义分析中新建事件,配置好事件名与字段。
wx.reportAnalytics('purchase', //eventNamef(必要),事件名{//data(必要)上报的自定义数据。key为配置中的字段名,value为上报的数据 price: 120, color: 'red'})














