# 数据统计接口介绍

向所有认证服务号开发者开放数据接口。通过数据接口,开发者可以获取与公众平台官网统计模块类似但更灵活的数据,还可根据需要进行高级处理。使用数据接口过程中有任何问题,可以前往微信开放社区 微信开放社区 专区发帖交流。

在服务号登录授权机制的权限划分逻辑如下:

1.用户分析数据接口属于用户管理权限 2.图文分析数据接口属于群发与通知权限 3.消息分析数据接口属于消息管理权限

# 使用说明

# 1. 通用注意事项

  1. 接口侧的服务号数据的数据库中仅存储了2014年12月1日之后的数据,将查询不到在此之前的日期,即使有查到,也是不可信的脏数据;
  2. 请开发者在调用接口获取数据后,将数据保存在自身数据库中,即加快下次用户的访问速度,也降低了微信侧接口调用的不必要损耗。
  3. 为确保服务号数据已完成统计和处理,请于每天上午8点后查询服务号前一天的数据。

# 2. 用户分析的注意事项

  1. 2020年4月起,新增关注渠道增加'他人转载',之前合并在“其他合计”中。
  2. 2020年6月起,新增关注渠道增加'微信广告'、'专辑内账号名称',之前合并在“其他合计”中。
  3. 2023年6月起,支付后关注合并在“其他合计”中。

# 3. 图文分析的注意事项

  1. 额外注意,获取图文群发每日数据接口的结果中,只有中间页阅读人数+原文页阅读人数+分享转发人数+分享转发次数+收藏次数 >=3的结果才会得到统计,过小的阅读量的图文消息无法统计。
  2. 2020年2月28日起,获取图文统计数据(getuserread)、图文统计分时数据(getuserreadhour)数据接口的结果中,中间页阅读、分享统一提供user_source字段,用于区分<传播渠道>与<全部>数据,详见参数说明;额外注意,原文页阅读、收藏,只在图文统计数据(getuserread)中提供,并只提供<全部>数据。

# 3. 广告分析的使用指南

# 接口列表

# 用户数据

接口名称英文名请求路径
获取用户增减数据getusersummary/datacube/getusersummary
获取累计用户数据getusercumulate/datacube/getusercumulate

# 图文数据

接口名称英文名请求路径
获取图文群发每日数据getarticlesummary/datacube/getarticlesummary
获取图文阅读分时数据getuserreadhour/datacube/getuserreadhour
获取图文转发分时数据getusersharehour/datacube/getusersharehour
获取图文阅读概况数据getuserread/datacube/getuserread
获取图文群发总数据getarticletotal/datacube/getarticletotal
获取图文转发概况数据getusershare/datacube/getusershare

# 消息数据

接口名称英文名请求路径
获取消息发送概况数据getupstreammsg/datacube/getupstreammsg
获取消息发送月数据getupstreammsgmonth/datacube/getupstreammsgmonth
获取消息发送分布周数据getupstreammsgdistweek/datacube/getupstreammsgdistweek
获取消息发送分布月数据getupstreammsgdistmonth/datacube/getupstreammsgdistmonth
获取消息发送分时数据getupstreammsghour/datacube/getupstreammsghour
获取消息发送周数据getupstreammsgweek/datacube/getupstreammsgweek
获取消息发送分布数据getupstreammsgdist/datacube/getupstreammsgdist

# 接口数据

接口名称英文名请求路径
获取被动回复概要数据getinterfacesummary/datacube/getinterfacesummary
获取被动回复分布数据getinterfacesummaryhour/datacube/getinterfacesummaryhour