React Native Firebase Analytics自定义商品级参数未在Debug View显示求助

排查步骤及修复方案 #

1. 先确认上报代码的写法是否正确 #

GA4要求商品级参数必须直接嵌套在items数组的每个商品对象里，要是你把item_condition放在事件的根级别参数里，就只会出现在事件级的Parameters标签，不会显示在Items标签下。正确的上报代码应该是这样：

analytics().logEvent('add_to_cart', {
  items: [
    {
      item_id: '123',
      item_name: '测试商品',
      item_condition: 'new', // 这个参数必须在item对象内部
      price: 99.99,
      quantity: 1
    }
  ]
});

先核对你的代码，别把参数放错位置了。

2. 检查GA4自定义维度的配置细节 #

虽然你说已经配了Item作用域的自定义维度，但再仔细核对这几点：

• 自定义维度的参数名称要和你上报的item_condition完全一致，大小写也不能错
• 作用域必须选商品（Item），不能选事件或用户
• 配置保存后，GA4需要一点时间同步，别刚改完就急着测试，等个10-20分钟再看Debug View

3. 考虑版本兼容性问题 #

你用的是@react-native-firebase/analytics 14.2.1版本，这个旧版本可能存在商品级自定义参数的解析bug。可以试试：

• 升级到15.x及以上的稳定版本（注意和你的React Native版本匹配）
• 要是暂时没法升级，换个参数名试试，比如改成item_custom_condition，有些旧版本对非默认的item参数支持有问题

4. 确认Debug View的显示规则 #

Debug View的Items标签只显示GA4默认的商品属性（比如item_id、price这些），以及已经正确映射为商品级自定义维度的参数。如果自定义维度还没同步好，或者映射错了，就只会在事件级Parameters里显示原始参数。多等会儿再触发事件测试。

5. 查看原生日志验证上报数据 #

用Android Studio的Logcat或者Xcode控制台，查看Firebase Analytics上报的原始日志，确认item_condition是不是真的在items数组的每个item对象里。如果日志里没有，那就是你的RN代码有问题；如果日志里有但GA4没解析，大概率是版本或配置的问题。

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