友盟自定义事件数据查询

要解决什么问题

移动 App 的埋点往往散落在代码里的 eventName、后台配置的显示名，以及带多层参数的事件体里。产品或数据同学常见诉求是：这个 App 到底上报了哪些自定义事件？某个事件在过去一周触发了多少次、有多少独立设备？参数取值 Top N 是什么、某个取值是否在某段时间抬升？友盟 U-App 把这些数据放在 OpenAPI 里，但接口多、且 eventName 与 eventId 混用容易踩坑。

本技能把查询侧收敛为 7 个只读 GET 接口，统一通过 umeng-cli call 调用，并明确排除写入型 event.create（创建埋点由 uapp-event-manage 负责）。

技能如何工作

所有请求都以 appkey 为应用维度，鉴权走友盟 AK/SK（由 umeng-cli login 缓存）。能力可按四层场景理解：

• 事件清单：event.list 分页列出事件，用 name / displayName 核对是否存在；需要参数列表时，从响应取 id 作为 eventId。
• 事件指标：event.getData 给每日触发次数；event.getUniqueUsers 给按 device 去重的独立用户数日趋势。
• 参数分析：event.param.list（必填 eventId）→ event.param.getValueList（分布）→ event.param.getData（某一取值的日趋势）。
• 参数时长：数值型（计算）事件可用 event.param.getValueDurationList 看参数值使用时长分布。

日期统一 yyyy-MM-dd；趋势接口仅按日返回，无 periodType、无渠道过滤；Top N 与周/月聚合需在客户端对 data[] 排序或求和。中文参数值查询时注意对 paramValueName 做 URL 编码。

边界与注意点

• event.param.list 不能传 eventName，必须先 event.list 解析 eventId。
• 时长分布只对数值型事件有意义；计数型事件应改用取值分布接口。
• 当日数据常有延迟，空结果时可收窄到昨日及以前，并核对事件名大小写。
• 未登录或过期时需 umeng-cli login --no-qr；Agent 宜后台跑登录命令，把链接交给用户在浏览器完成授权。