能否将UTM参数传入Firebase Analytics用户维度并映射至BigQuery字段？

当然可行！Firebase Analytics本身就支持将首次用户获取时的UTM参数同步到BigQuery对应的user_dim.traffic_source字段中，只要配置正确，就能自动完成映射。下面是具体的实现步骤和注意事项：

一、核心原理 #

user_dim.traffic_source.user_acquired_source、user_acquired_medium、user_acquired_campaign这三个字段，存储的是用户首次安装并打开应用时的流量来源信息。Firebase会自动识别带标准UTM参数的安装链接，并将这些参数值填充到上述字段中，随后同步到BigQuery。

二、具体实现步骤 #

1. 确保应用商店链接携带标准UTM参数 #

你的Google Play和App Store推广链接必须严格使用标准UTM参数命名：

• utm_source：标识流量来源（比如google、facebook）
• utm_medium：标识流量媒介（比如cpc、social）
• utm_campaign：标识推广活动（比如summer_sale_2024）

示例链接：

• Android：https://play.google.com/store/apps/details?id=com.your.app&utm_source=facebook&utm_medium=social&utm_campaign=summer_promo
• iOS：https://apps.apple.com/us/app/your-app/id123456789?utm_source=google&utm_medium=cpc&utm_campaign=fall_launch

2. 验证Firebase Analytics的自动追踪配置 #

Firebase Analytics默认会自动捕获首次打开时的UTM参数，你只需要确保：

• 应用已经正确集成Firebase Analytics（Android和iOS端的初始化代码都已添加）
• 自动事件追踪处于开启状态（默认开启，可在Firebase控制台「Analytics」→「设置」→「自动事件追踪」中确认）

3. 测试UTM参数捕获效果 #

用带UTM参数的链接安装并打开应用，通过以下方式验证：

• 使用Firebase控制台的「DebugView」：实时查看first_open事件的参数，确认utm_source、utm_medium、utm_campaign是否被正确捕获
• 查看Firebase控制台的「用户获取」报告：筛选对应UTM参数的用户，确认数据是否正常统计

4. 确认BigQuery同步配置 #

如果已经开启Firebase到BigQuery的导出功能，数据会定期（通常每小时）同步到BigQuery的数据集。你可以在BigQuery中查询对应表，验证user_dim.traffic_source下的三个字段是否已填充UTM参数值。

三、关键注意事项 #

• 仅首次打开有效：user_acquired_*字段只记录用户第一次安装打开应用时的流量信息，后续打开带UTM参数的链接不会更新这些字段（后续的UTM参数会出现在event_params中的相关事件里）
• 卸载重装的情况：如果用户卸载后重装应用，且使用同一个Firebase用户ID（比如绑定了Google/Apple账号），user_acquired_*字段会保留首次获取的信息；如果是全新设备或清除应用数据，则会作为新用户重新捕获UTM参数
• 标准参数必须严格匹配：Firebase只会识别utm_source、utm_medium、utm_campaign这三个标准参数，自定义参数（比如utm_custom）不会被映射到上述字段

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