Analytics

U-App 移动统计 API。三个方法都是同步 void，不返回 Promise。

引用

import { Analytics } from '@unif/react-native-umeng';

方法	签名	返回
onEvent	onEvent(eventId, params?)	void
signIn	signIn(userId, provider?)	void
signOut	signOut()	void

同步 void，不要 await

Analytics.* 全是同步方法，没有 Promise。await Analytics.onEvent(...) 只会 await 一个 undefined，没有意义。

---

Analytics.onEvent(eventId, params?)

自定义事件埋点。

function onEvent(
  eventId: string,
  params?: Record<string, string | number>
): void;

参数	类型	必填	说明
eventId	string	✅	友盟后台定义的事件 ID
params	Record<string, string | number>	—	事件属性；number 值自动 String() stringify（友盟 iOS attributes 强制 NSString）

Analytics.onEvent('share_tap', { source: 'detail', count: 1 }); // count 自动转 '1'

---

Analytics.signIn(userId, provider?)

用户登录账号埋点。

function signIn(userId: string, provider?: string): void;

参数	类型	必填	说明
userId	string	✅	业务用户 ID
provider	string	—	登录方式标识，如 'WX' / 'DD'

---

Analytics.signOut()

用户登出。

function signOut(): void;

---

平台支持

API	iOS	Android
onEvent	✅	✅
signIn	✅	✅
signOut	✅	✅

埋点需要先完成 Common.init() 才会真正上报；未 init 时调用不会崩溃，但数据不上报。

相关

• 统计埋点指南 —— 任务导向用法
• Common API —— 初始化（埋点上报的前提）