您的位置：首页 > 移动开发 > 微信开发

小程序文档整理之 -- API（数据分析）

2017-08-29 09:46 483 查看
开发者通过数据分析接口，可获取到小程序的各项数据指标，便于进行数据存储和整理。数据分析详细功能介绍及指标解释参见数据分析文档。

常规分析

概况

用户访问小程序的详细数据可从访问分析中获取，概况中提供累计用户数等部分指标数据。

概况趋势

接口地址

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
101b2
请求参数说明：

参数是否必填说明
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'
})
内容来自用户分享和网络整理，不保证内容的准确性，如有侵权内容，可联系管理员处理 点击这里给我发消息
标签： 
相关文章推荐
新的分享
章节导航