友盟自定义事件管理

要解决什么问题

在友盟里上线埋点前，需要先在控制台（或 OpenAPI）里登记自定义事件：eventName 英文标识、eventDisplayName / displayName 中文展示名，App 还可选计数 vs 计算类型。小程序侧没有「单条创建」接口，单事件也要走批量 API；App 侧则没有批量创建，只能循环单创。创建前若未查重，容易重复 eventName 或误建不可撤销的定义——友盟 不提供 事件删除、重命名、改显示名。

技能如何工作

本技能围绕 umeng-cli call，在 com.umeng.uapp（Android / iOS / 鸿蒙等 App）与 com.umeng.umini（微信等小程序、H5）之间按 platform 自动分流，共四个接口：

• 写入：umeng.uapp.event.create（App 单事件）；umeng.umini.batchCreateEvent（小程序单条或批量，eventList 传 JSON）
• 只读：umeng.uapp.event.list、umeng.umini.getEventList（创建前重复预检、创建后 --verify 式回查）

典型流程：先确认 appkey 或 dataSourceId（应用清单属 umeng-cli-uapp-assets），本地校验 eventName 正则 ^[a-zA-Z0-9_]+$ 与显示名禁字符，列表预检 → 向用户复述并二次确认 → 写入 → 延迟 3–5 秒再列表核对。失败时透传 msg，不自动重试写入；批量失败可建议 N=1 逐个定位。

边界与注意点

• 只做事件定义管理；触发次数、独立用户、参数分布等统计查询归 umeng-cli-uapp-event。
• App 中文显示名由 CLI 内部 urlEncode；小程序 displayName 传原文即可。
• 鉴权为 umeng-aksk，依赖 umeng-cli login；未登录时在后台跑 umeng-cli login --no-qr 把链接给用户。
• 写入不可逆，务必在调用前完成命名规范与人工确认。