向所有成为流量主的公众号、小程序、小游戏开发者开放数据接口。通过数据接口,开发者可以获取与公众平台官网统计模块类似但更灵活的数据,还可根据需要进行高级处理。
请注意:
接口侧数据库中仅存储了2016年1月1日之后的数据,将无法查询到此前的数据,即使查到,也是不可信的脏数据;
建议开发者在调用接口获取数据后,将数据保存在自身数据库中,以最大化访问的效率,也降低微信侧接口调用的不必要损耗;
由于数据量较大, 所有接口采取分页获取的方式, 每页最大获取量为90。(eg:total_num 为100,则当page = 1,page_size = 10,则返回前10条;page = 1,page_size = 20,则返回前20条;page = 2,page_size = 10,则返回第11条到第20条)
广告位枚举值变更说明
- 由于多个接口都使用了广告位参数,为保证体验的一致性和参数的可读性,我们做了一些变更,所有接口均支持以 广告位类型名称(ad_slot) 传递参数,回包时新增这个名称来代表相关含义。此前的参数 slot_id 也可继续使用并回传。具体为:
广告位类型名称(ad_slot) | 广告位类型 |
---|---|
SLOT_ID_BIZ_BOTTOM | 公众号底部广告 |
SLOT_ID_BIZ_MID_CONTEXT | 公众号文中广告 |
SLOT_ID_BIZ_VIDEO_END | 公众号视频后贴 |
SLOT_ID_BIZ_SPONSOR | 公众号互选广告 |
SLOT_ID_BIZ_CPS | 公众号返佣商品 |
SLOT_ID_WEAPP_BANNER | 小程序banner |
SLOT_ID_WEAPP_REWARD_VIDEO | 小程序激励视频 |
SLOT_ID_WEAPP_INTERSTITIAL | 小程序插屏广告 |
SLOT_ID_WEAPP_VIDEO_FEEDS | 小程序视频广告 |
SLOT_ID_WEAPP_VIDEO_BEGIN | 小程序视频前贴 |
SLOT_ID_WEAPP_BOX | 小程序格子广告 |
SLOT_ID_WEAPP_TEMPLATE | 小程序原生模板广告 |
SLOT_ID_WEAPP_COVER | 封面广告 |
广告分析接口目前可用于获得“公众平台 → 流量主 → 数据统计”页面展示的部分广告数据和“公众平台 → 流量主 → 财务管理”页面展示的部分收入数据,与小程序相关的接口列表如下:
接口名称 | 用途 | 最大时间跨度 | 接口调用地址(必须使用https) |
---|---|---|---|
publisher_adpos_general | 获取小程序广告汇总数据 | 90天 | https://api.weixin.qq.com/publisher/stat?action=publisher_adpos_general&access_token=ACCESS_TOKEN |
publisher_adunit_general | 获取小程序广告细分数据 | 90天 | https://api.weixin.qq.com/publisher/stat?action=publisher_adunit_general&access_token=ACCESS_TOKEN |
get_adunit_list | 获取小程序广告位清单 | 无 | https://api.weixin.qq.com/publisher/stat?action=get_adunit_list&access_token=ACCESS_TOKEN |
publisher_settlement | 获取小程序结算收入数据及结算主体信息 | 无 | https://api.weixin.qq.com/publisher/stat?action=publisher_settlement&access_token=ACCESS_TOKEN |