友盟 App 基础指标与智能巡检

解决的问题

友盟应用数据分散在新增、活跃、启动、留存、渠道等指标中，工程师排查异动时常需要人工拉取多接口、核对日期与 APPKEY。umeng-api 把这些查询封装成可复用的 Python SDK 调用，适合在脚本、内部工具或 Agent 工作流中读取指定应用的基础统计与异常点报告。

工作方式

• 认证加载：优先读取代码传入参数，其次读取 umeng-config.json，最后回退到环境变量，避免把 apiKey、apiSecurity 散落在业务代码中。
• 指标查询：围绕目标 APPKEY 和日期，调用友盟 UApp API 获取新增用户、活跃用户、启动次数、使用时长、留存率、渠道与版本数据。
• 异常巡检：在基础指标之外，查询异常点检测与异动归因报告，帮助定位指标波动可能对应的业务原因。
• 错误处理：区分 aop.ApiError、aop.AopError 与 ValueError，便于判断是网关返回、客户端请求前失败，还是认证配置缺失。

适用边界

该技能依赖有效的友盟账号、应用 APPKEY 和 API 凭证，不替代应用监控告警系统，也不保证绕过友盟 API 的调用频率限制。涉及敏感凭证时应避免硬编码，并将配置文件纳入 .gitignore、控制文件权限。