友盟渠道与版本分析

要解决什么问题

移动应用在友盟 U-App 里往往按渠道（应用商店、预装包等）和版本号拆分统计。产品或数据同学常见需求是：某一天各渠道/版本谁的新增、活跃、启动更好；某个渠道或新版本上线后，过去一周、一月指标是否抬升或回落。友盟 OpenAPI 接口多、参数约束细（日期格式、单渠道单版本、URL 编码、分页差异），直接在对话里拼请求容易漏字段或选错接口。

本技能把 U-App 渠道与版本相关的只读查询收敛成固定工作流：先确认 appkey 与 umeng-cli 登录态，再通过 umeng-cli call 调用 5 个 GET 接口。

技能如何工作

能力分两类场景：

• 单日快照：umeng.uapp.getChannelData（支持 page / perPage）拉渠道维度的活跃、新增、总用户占比、启动等；umeng.uapp.getVersionData 拉版本维度的活跃、新增与总用户占比（无分页，且版本单日结构不含 launch）。
• 趋势分析：在 startDate～endDate 内，用 getLaunchesByChannelOrVersion、getActiveUsersByChannelOrVersion、getNewUsersByChannelOrVersion 看启动、活跃、新增；periodType 为 daily / weekly / monthly，可用 channels 或 versions 各传一个做过滤。

鉴权走友盟 AK/SK（umeng-aksk），由 umeng-cli login 缓存凭证。接口不提供服务端排序或 Top N，排名需在 Agent 侧对返回列表排序；渠道名含中文或空格时需对参数做 urlEncode。

边界与注意点

• 仅限只读查询，不含创建应用、埋点事件等写入接口；「今日」实时汇总不在本技能范围。
• getChannelData 可分页；getVersionData 与三个趋势接口均不分页，对比多个渠道/版本需多次调用后自行聚合。
• 总用户数 totalUser 仅单日快照直接给出，没有独立的总用户趋势接口，需多日快照拼接。
• 未登录或过期时需 umeng-cli login --no-qr；Agent 宜后台执行以便先展示登录链接。