经过10多天的微信公众平台数据接口内测,现在正式对所有认证公众号开放了。微信公众平台数据接口正式向所有已微信认证(通过资质认证即可)的服务号和订阅号开放。通过数据接口,公众号开发者可以便利地获取更详细、更灵活的运营数据。
1、用户分析数据接口
通过该接口可以获取公众号的用户增减数据和累计用户数据。
2、图文分析数据接口
通过该接口可以获取公众号群发的图文消息的阅读、分享、收藏等数据。
3、消息分析数据接口
通过该接口可以获取用户向公众号发送消息的数据,包括消息发送人数、次数,以及消息发布次数的分布等。
4、接口分析数据接口
通过该接口可以获取公众号在通过接口响应用户消息时的性能数据,包括接口回复次数、耗时等。
微信公众平台数据接口开发者文档
微信公众平台于2015年1月6日启动了数据接口的邀请内测。通过数据接口,开发者可以获取与公众平台官网统计模块类似但更灵活的数据,还可根据需要进行高级处理。
邀请内测期间,为保证服务质量,数据接口仅向第三方平台开发者开放。在微信开放平台接入公众号登录授权即可成为第三方平台开发者,第三方平 台可帮助运营者管理公众号,帮助已授权公众号调用数据接口。在公众号登录授权机制的权限集划分中,用户分析数据接口属于用户管理权限集。
向所有公众号开发者开放数据接口的时间将另行通知。
请注意:
1、接口侧的公众号数据的数据库中仅存储了2014年12月1日之后的数据,将查询不到在此之前的日期,即使有查到,也是不可信的脏数据; 2、请开发者在调用接口获取数据后,将数据保存在自身数据库中,即加快下次用户的访问速度,也降低了微信侧接口调用的不必要损耗。
用户分析数据接口指的是用于获得公众平台官网数据统计模块中用户分析数据的接口,具体接口列表如下(暂无用户属性数据接口):
接口名称 | 最大时间跨度 | 接口调用地址(必须使用https) |
---|---|---|
获取用户增减数据(getusersummary) | 7 | https://api.weixin.qq.com/datacube/getusersummary?access_token=ACCESS_TOKEN |
获取累计用户数据(getusercumulate) | 7 | https://api.weixin.qq.com/datacube/getusercumulate?access_token=ACCESS_TOKEN |
最大时间跨度是指一次接口调用时最大可获取数据的时间范围,如最大时间跨度为7是指最多一次性获取7天的数据。access_token的实际值请通过“获取access_token”来获取。
接口调用请求说明
用户分析数据接口(包括接口列表中的所有接口)需要向相应接口调用地址POST以下示例数据包:
{ "begin_date": "2014-12-02", "end_date": "2014-12-07" }
调用参数说明
参数 | 是否必须 | 说明 |
---|---|---|
access_token | 是 | 调用接口凭证 |
begin_date | 是 | 获取数据的起始日期,begin_date和end_date的差值需小于“最大时间跨度”(比如最大时间跨度为1时,begin_date和end_date的差值只能为0,才能小于1),否则会报错 |
end_date | 是 | 获取数据的结束日期,end_date允许设置的最大值为昨日 |
返回说明
正常情况下,获取用户增减数据接口的返回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之间的数据 ] }
返回参数说明
参数 | 说明 |
---|---|
ref_date | 数据的日期 |
user_source | 用户的渠道,数值代表的含义如下: 0代表其他 30代表扫二维码 17代表名片分享 35代表搜号码(即微信添加朋友页的搜索) 39代表查询微信公众帐号 43代表图文页右上角菜单 |
new_user | 新增的用户数量 |
cancel_user | 取消关注的用户数量,new_user减去cancel_user即为净增用户数量 |
cumulate_user | 总用户量 |