用户分析
向所有认证公众号开发者开放数据接口。通过数据接口,开发者可以获取与公众平台官网统计模块类似但更灵活的数据,还可根据需要进行高级处理。使用数据接口过程中有任何问题,可以前往微信开放社区 #公众号 专区发帖交流。
在公众号登录授权机制的权限集划分中,用户分析数据接口属于用户管理权限。
请注意:
接口侧的公众号数据的数据库中仅存储了2014年12月1日之后的数据,将查询不到在此之前的日期,即使有查到,也是不可信的脏数据;
请开发者在调用接口获取数据后,将数据保存在自身数据库中,即加快下次用户的访问速度,也降低了微信侧接口调用的不必要损耗。
为确保公众号数据已完成统计和处理,请于每天上午8点后查询公众号前一天的数据。
2020年4月起,新增关注渠道增加'他人转载',之前合并在“其他合计”中。
2020年6月起,新增关注渠道增加'微信广告'、'专辑内账号名称',之前合并在“其他合计”中。
2023年6月起,支付后关注合并在“其他合计”中。
用户分析数据接口指的是用于获得公众平台官网数据统计模块中用户分析数据的接口,具体接口列表如下(暂无用户属性数据接口):
最大时间跨度是指一次接口调用时最大可获取数据的时间范围,如最大时间跨度为7是指最多一次性获取7天的数据。access_token的实际值请通过“获取access_token”来获取。
接口调用请求说明
用户分析数据接口(包括接口列表中的所有接口)需要向相应接口调用地址POST以下示例数据包:
{
"begin_date": "2014-12-02",
"end_date": "2014-12-07"
}
调用参数说明
返回说明
正常情况下,获取用户增减数据接口的返回JSON数据包如下:
{
"list": [
{
"ref_date": "2014-12-07",
"user_source": 0,
"new_user": 0,
"cancel_user": 0
}//后续还有ref_date在begin_date和end_date之间的数据
]
}
正常情况下,获取累计用户数据接口的返回JSON数据包如下:
{
"list": [
{
"ref_date": "2014-12-07",
"cumulate_user": 1217056
}, //后续还有ref_date在begin_date和end_date之间的数据
]
}
返回参数说明
错误时微信会返回错误码等信息,具体错误码查询,请见:全局返回码说明