技能介绍

要解决什么问题

移动产品团队日常要看的不只是 DAU，还有新增/活跃用户是否在安装或活跃后的第 N 天回来。友盟 U-App 把这类指标收敛在 OpenAPI umeng.uapp.getRetentions 里，但参数语义（留存窗口、type、版本/渠道过滤）和响应里的 retentionRate[] 索引并不直观，Agent 也容易把「尚未到期的窗口」误读成 0% 留存。

技能如何工作

本技能只覆盖一个只读 GET 接口，通过 umeng-cli call 发起请求；鉴权走友盟 AK/SK，由 umeng-cli login 缓存，无需手填密钥。

留存趋势：给定 appkey 与 startDate/endDate，按日/周/月（periodType）拉取区间内每条记录的 5 个留存窗口。
维度对比：channel 与 version 各只能传一个；多版本或多渠道对比需在客户端循环调用并对齐日期。
留存类型：type=newUser（默认，新增用户留存）或 activeUser（活跃用户留存）。

响应中 retentionInfo[].retentionRate 是定长 5 元组，索引与窗口固定对应：[0] 次日、[1] 3 日、[2] 7 日、[3] 14 日、[4] 30 日；值为 0～1 的小数，展示时通常乘 100 转为百分比。想看哪个窗口是客户端后处理，不是请求参数。

边界与注意点

数据不含今日；越靠近查询日的中长窗口可能为 null/0，需区分「未到期」与「真实为零」。
无论 type 为何，totalInstallUser 始终表示当日安装/新增用户数作分母；活跃基数应配合 umeng-cli-uapp-core-index 的 getActiveUsers。
枚举版本/渠道列表不在本技能内，请用 umeng-cli-uapp-channel-version 的 getVersionData / getChannelData；含空格或中文的 channel 需 URL 编码。