Unity应用中Google Analytics GAv4插件的数据缓存时长是多少

核心缓存规则 #

GA4 for Unity插件底层直接复用了对应平台的Firebase Analytics原生SDK，Android端的缓存逻辑由原生Firebase SDK实现，官方未直接在Unity插件文档中说明的规则如下：

• 本地缓存事件上限默认值为2000条：若用户离线阶段产生的事件总数超过该阈值，最早生成的未上报事件会被直接丢弃，这是离线数据丢失的最常见诱因。
• 缓存事件默认过期时长为14天：缓存在本地的事件如果超过14天仍未成功上报，会被SDK自动清理，不会再触发上报。
• 上报规则：网络恢复后SDK会自动触发批量上报，默认每60秒尝试上报一次，每次最多上报100条缓存事件。

自定义调整方案 #

如果你的使用场景中用户离线时长、单离线周期事件量超过默认阈值，可以通过修改Android端配置调整参数：

1. 调整缓存事件最大数量
   在Unity项目导出的Android工程AndroidManifest.xml的<application>节点下添加如下配置，最大值可设置为10000：

<meta-data android:name="google_analytics_max_event_cache_size" android:value="5000" />

2. 调整缓存事件过期时长
   同样在AndroidManifest.xml的<application>节点下添加如下配置，单位为秒，最大值可设置为60天（5184000秒）：

<meta-data android:name="google_analytics_event_ttl_seconds" android:value="2592000" />

注意事项 #

• 调大缓存上限和过期时长会增加设备本地存储空间占用，建议结合业务实际场景评估合理数值，不要盲目设置最大值。
• 若你的用户常规离线时长超过30天，建议额外在业务层实现埋点事件本地备份逻辑，进一步降低数据丢失概率。

内容的提问来源于stack exchange，提问作者HrLarsen