Skip to main content
本文说明 Flutter SDK 采集哪些数据、如何上报,以及如何控制采集范围。所有事件都写入 source: "flutter"

事件类型

自动采集的上下文

每个事件会自动附带以下上下文(由原生层采集):
  • 应用信息serviceversionenv,以及 application_id
  • 设备信息:设备型号、操作系统与版本、屏幕尺寸
  • 会话信息session.id,按 sessionSamplingRate 采样
  • 连接信息:网络类型(如可用)
  • 用户信息:通过 setUserInfo 设置的 usr.id / usr.name / usr.email

手动埋点

除了自动采集,你可以手动记录事件与属性。

采样与控制

数据脱敏

通过事件映射器(event mapper)可以在事件上报前修改或丢弃数据,用于脱敏或过滤噪声。详见 高级配置

上报行为

  • SDK 在原生层做批量缓存,按 batchSizeuploadFrequency 分批上报
  • 网络不可用时事件会持久化到本地,恢复后重试
  • 上报地址默认为站点对应地址(FlashcatSite.cnbrowser.flashcat.cloud),私有化可通过 customEndpoint 覆盖