TrackEvent

接口

单条埋点事件,5 个必填字段 + 可选扩展

签名

interface TrackEvent {
    event_name: string
    uuid: string
    session_id: string
    page_path: string
    device: string
    user_id?: string | undefined
    geo?: string | undefined
    value?: number | undefined
    timestamp?: number | undefined
}

成员

名称类型描述
event_namestring事件名称,如 page_view / click / scroll
uuidstring设备指纹(FingerprintJS 生成),跨会话稳定,必填
session_idstring会话标识
page_pathstring页面路径,如 /home
devicestring设备类型:mobile / tablet / desktop,未识别时为 unknown
user_id可选string | undefined业务用户标识,由 getPreParams 提供,可选
geo可选string | undefined地理位置,服务端通过请求上下文自动注入,客户端无需填写
value可选number | undefined事件数值,如点击次数、购买金额
timestamp可选number | undefinedUnix 毫秒时间戳,服务端会自动补全

源码

packages/pulsar/src/types.ts:2