Flutter应用中Firebase Authentication影响Google Ads推广数据留存问题

一、问题根本原因 #

1. 用户标识切换导致数据断联
   Firebase Analytics默认用设备ID作为未登录用户的标识，登录后会自动切换为Firebase Auth的用户UID。如果推广数据（如gclid、campaign等参数）仅关联在设备ID对应的用户属性或事件中，登录后用UID查询自然无法获取之前的推广数据。

2. 登录触发Analytics会话重置
   部分场景下，Firebase Auth登录操作会触发Analytics的用户身份重置，若未提前留存推广参数，这些数据会被直接清空，后续上报的事件也就无法关联原推广来源。

3. 推广数据未持久化存储
   登录前捕获的推广数据如果仅存于内存，登录后页面/组件重建会导致数据丢失，后续上报事件时没有附加这些参数，最终表现为事件数据为0。

二、确保登录后推广数据完整保留的方案 #

• 本地持久化推广参数
  在用户首次打开APP捕获到推广参数后，立刻用SharedPreferences或Hive等本地存储工具保存，避免仅存于内存。示例代码：

// 捕获并存储推广参数
final prefs = await SharedPreferences.getInstance();
final gclid = await FirebaseAnalytics.instance.getSessionParameter('gclid');
if (gclid != null) {
  await prefs.setString('saved_gclid', gclid);
  await prefs.setString('saved_campaign', await FirebaseAnalytics.instance.getSessionParameter('campaign'));
}

• 登录后关联推广数据到用户属性
  登录成功后，从本地存储读取推广参数，设置为Firebase用户的自定义属性，确保后续所有事件都能关联这些推广信息：

// 登录后绑定用户属性
final prefs = await SharedPreferences.getInstance();
final gclid = prefs.getString('saved_gclid');
if (gclid != null) {
  await FirebaseAnalytics.instance.setUserProperty(name: 'gclid', value: gclid);
  await FirebaseAnalytics.instance.setUserProperty(name: 'campaign', value: prefs.getString('saved_campaign'));
}

• 禁止登录时重置Analytics数据
  调用setUserId时传入resetAnalyticsData: false，避免清空之前的会话数据，让原推广数据与新用户ID关联：

await FirebaseAnalytics.instance.setUserId(id: user.uid, resetAnalyticsData: false);

• 上报事件主动携带推广参数
  后续所有自定义事件上报时，主动从本地读取推广参数并附加到事件参数中：

// 带推广数据上报事件
final prefs = await SharedPreferences.getInstance();
await FirebaseAnalytics.instance.logEvent(
  name: 'user_click_button',
  parameters: {
    'gclid': prefs.getString('saved_gclid'),
    'campaign': prefs.getString('saved_campaign'),
    'button_name': 'submit'
  },
);

• 验证数据关联有效性
  登录后可在Firebase控制台的Analytics事件列表中，检查事件是否携带推广参数；或在用户属性板块查看是否存在对应的推广字段，确认数据关联是否成功。

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