前言¶
排查小程序指标时,常见的路径是登录友盟后台,手动翻页面、导报表、再拼接对比。这类操作在反复查询时耗时长,也不利于把数据接进调试或自动化流程。
下面介绍的这个 Skill 把友盟小程序统计查询收敛到命令行:通过 umeng-cli call 调用友盟 OpenAPI(gateway.open.umeng.com)的 12 个只读接口,覆盖概况、留存、页面、分享、自定义事件等维度。开发者可以在终端里直接取数,不用再走后台界面。
这是什么¶
「友盟小程序数据问答」是一个数据查询类 Skill,坐标 @user_fc9923d6/uapp-umini,当前版本 1.1.1,由社区开发者 user_fc9923d6 发布维护,分类为 data-analysis。
它解决的问题是:把友盟小程序统计的常用查询固化成一批只读接口,让 Agent 或开发者按自然语言意图直接取指标,而不是在控制台里逐页查找。
核心功能¶
Skill 通过 umeng-cli call 调用友盟 OpenAPI(gateway.open.umeng.com),共 12 个只读接口,按用途分五组:
- 应用概况:小程序整体指标概览
- 累计用户:累计用户数
- 留存:留存表现
- 页面分析:受访页、入口页
- 分享分析:分享概况、页面分享、分享用户
- 自定义事件:事件列表、事件统计、事件属性、属性值分布
所有接口均为只读,不涉及写入或修改数据。
触发方式¶
Skill 内置了触发词,当用户提到以下说法时会被唤起:
- 小程序概况、小程序留存、小程序活跃用户、小程序累计用户
- 页面访问、入口页
- 分享概况、页面分享、分享用户
- 小程序事件、事件属性、属性值分布
安装与启用¶
官方地址:https://api.skillhub.cn/user_fc9923d6/uapp-umini ,SkillHub 页面:https://www.skillhub.cn/skills/user_fc9923d6/uapp-umini 。
安装命令、依赖与配置字段(包括 requires_api_key=true 所需的密钥配置方式)在已抓取的资料中没有列出,请以官方页面的说明为准,不要自行假设配置项名称。
典型用法¶
调用形式为 umeng-cli call,后接友盟 OpenAPI 的接口参数。具体接口名、参数结构与返回字段需要对照友盟 OpenAPI 文档和 Skill 说明确认。
一个可直接核对的示例是查询小程序概况:在终端执行 umeng-cli call,传入对应的概况接口与应用标识,即可拿到概览指标。其余维度的调用方式相同,区别只在接口名与参数。
适用场景与注意¶
适合的场景:
- 需要反复查询小程序概况、留存、页面、分享、事件数据
- 希望在终端或 Agent 流程中直接取数,而不是登录后台
- 需要把友盟统计接入调试或自动化环节
限制与坑:
- 仅适用于小程序、H5、小游戏,不支持 Android / iOS App
- 接口全部为只读,不能做数据写入或修改
- 需要友盟 OpenAPI 的访问凭据,属于
requires_api_key=true的 Skill - 触发词基于中文表述,用其他说法可能需要额外说明意图
结尾¶
这个 Skill 的价值在于把友盟小程序统计的常用查询固化成一批只读 CLI 接口,减少在后台翻页面的重复操作。它的覆盖面集中在小程序/H5/小游戏,App 端数据不在其范围内。
官方地址:https://api.skillhub.cn/user_fc9923d6/uapp-umini