# 数据统计接口介绍

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

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

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. 广告分析的使用指南

# 接口列表

# 用户数据

接口名称 请求路径 描述
获取用户增减数据 /datacube/getusersummary 本接口用于获取用户增减数据分析数据
获取累计用户数据 /datacube/getusercumulate 本接口用于获取用户累计数据分析数据

# 图文数据

接口名称 请求路径 描述
获取图文群发每日数据 /datacube/getarticlesummary 本接口用于获取某天所有被阅读过的群发文章当天的阅读数据
获取图文阅读分时数据 /datacube/getuserreadhour 本接口用于获取图文阅读分时数据
获取图文转发分时数据 /datacube/getusersharehour 本接口用于获取图文转发分时数据
获取图文阅读概况数据 /datacube/getuserread 本接口用于获取图文阅读概括数据
获取图文群发总数据 /datacube/getarticletotal 获取群发文章从群发日起的总量统计数据
获取图文转发概况数据 /datacube/getusershare 本接口用于获取图文转发概况数据
获取发表内容每日阅读数据 /datacube/getarticleread 本接口用于获取某天所有被阅读过的发表内容的阅读指标
获取发表内容每日分享数据 /datacube/getarticleshare 本接口用于获取某天所有被分享过的发表内容的分享指标
获取发表内容概况总数据 /datacube/getbizsummary 本接口用于获取圈选日期内,该账号下发表内容汇总的概览数据
获取发表内容发表详细数据 /datacube/getarticletotaldetail 本接口用于获取 圈选日期内 所有发表内容的详细数据

# 消息数据

接口名称 请求路径 描述
获取消息发送概况数据 /datacube/getupstreammsg 本接口用于获取消息发送概况数据
获取消息发送月数据 /datacube/getupstreammsgmonth 本接口用于获取消息发送月数据
获取消息发送分布周数据 /datacube/getupstreammsgdistweek 本接口用于获取消息发送分布周数据
获取消息发送分布月数据 /datacube/getupstreammsgdistmonth 本接口用于获取消息发送分布月数据
获取消息发送分时数据 /datacube/getupstreammsghour 本接口用于获取消息发送分时统计数据
获取消息发送周数据 /datacube/getupstreammsgweek 本接口用于获取消息发送周数据
获取消息发送分布数据 /datacube/getupstreammsgdist 本接口用于获取消息发送分布数据

# 接口数据

接口名称 请求路径 描述
获取被动回复概要数据 /datacube/getinterfacesummary 本接口用于获取被动回复概要数据
获取被动回复分布数据 /datacube/getinterfacesummaryhour 本接口用于获取被动回复分布数据