技能介绍

要解决什么问题

运营或开发在对话里问「过去 7 天活跃怎么样」「哪些页面访问最多」「新用户 7 日留存」，往往需要登录友盟控制台、切到小程序统计再手工对表。本技能把 com.umeng.umini 命名空间下 12 个只读查询接口 封装成 Agent 可执行的 umeng-cli call 流程：用 dataSourceId（AppKey） 和时间参数直接拉数，并用文档里的工作流（概况、累计用户、留存、Top 页面、分享、事件三步链路）组织回答。

技能如何工作

鉴权：未登录或过期时执行 umeng-cli login --no-qr（Agent 宜后台运行，把登录链接给用户）。
概况与趋势：getOverview 支持 5min / hour / day / 7day / 30day，指标含新增、活跃、访次等；H5 需去掉 launch、onceDuration、dailyDuration。
留存：getRetentionByDataSourceId 一次返回 v1–v30 共 9 个窗口；日粒度昨日留存次日才出，文档建议默认用近 7 日区间避免空返。
页面与分享：受访 getVisitPageList、入口 getLandingPageList（带跳出率）、分享趋势 getShareOverview 及页面/用户维度排行。
自定义事件：getEventList → getEventOverview → getEventProvertyList（官方拼写 Proverty）→ getAllPropertyValueCount。

分页统一 pageIndex / pageSize，与 App 侧 page / perPage 不同。

适用边界

仅适用于 微信/支付宝/字节等小程序、微信小游戏、以及部分 H5（html_5）。Android / iOS App 不适用，应改用 umeng-cli-uapp-core-index、umeng-cli-uapp-retention、umeng-cli-uapp-event。全部为只读，不含事件或数据源创建等写入；场景分析类能力在 umeng-cli-uapp-mini-channel。H5 上 getLandingPageList 整体不支持，部分分享/概况字段无 reflowRatio 等。