菜单

数据存储与上报

概述

为保证数据采集的可靠性和优化设备性能，GravityEngine SDK 在 当前平台​​上采用"先存储，后上报"的策略。所有事件触发后首先在本地持久化存储，待服务器确认上报成功后方才删除对应的本地数据。

上报触发条件

1. 手动立即上报

支持主动触发数据上报，适用于需要确保数据及时上报的场景：
// 调用 flush() 上报缓存事件
ge.flush();

2. 关键事件触发上报

当以下重要业务事件发生时，SDK会自动触发全量数据上报：
应用生命周期事件：
  • 应用启动（$AppStart）
  • 应用进入后台（$AppEnd）
核心业务事件：
  • 付费事件（$PayEvent）
  • 用户提现（$UserWithdraw）
  • 广告展示（$AdShow）
  • 用户注册（$AppRegister）

3. 缓存数量触发上报

为防止本地数据积压，SDK会在缓存事件达到20条时自动触发上报：
上报限制：​ 单次API请求最多上传50条事件，超出的数据会自动分批上报。
上一个
进阶功能
下一个
自动采集
最近修改: 2026-01-07Powered by