Firebase Analytics上报大写电商事件报错21相关问题咨询

• 预设电商事件如果要使用Firebase官方的电商专属分析能力，必须使用官方规定的小写命名，不能用自定义大写命名。你使用的ITEM_VIEW会被系统识别为普通自定义事件，而非官方item_view电商事件，无法匹配官方针对电商事件预设的参数解析逻辑，包括对items字段的特殊处理规则。
• 普通自定义事件命名没有强制要求全小写，但官方规范明确要求事件名只能包含字母、数字和下划线，且以字母开头，建议统一遵循小写加下划线的命名规则，避免不必要的解析异常。如果坚持使用自定义大写的电商事件名，就无法使用官方电商事件的专属统计能力，需要完全按照普通自定义事件的参数规则上报。

• 不管是官方预设事件还是普通自定义事件，都不支持直接传入数组类型的顶层参数，这就是你收到错误21的核心原因。
• 只有官方预设的电商事件中items参数是特殊例外：只要你使用官方规定的事件名（比如item_view、view_item_list、select_item等）上报，系统会自动识别items字段的数组结构并做特殊解析，不需要额外处理。
• 如果坚持使用自定义大写事件名，需要把items数组拆解为多个独立参数上报，或者将数组序列化后以字符串类型传入，这种情况下无法使用Firebase控制台的电商专属分析功能。

你使用的invertase封装的RN Firebase SDK已经内置了所有官方预设事件的常量，建议直接调用对应常量上报，示例代码如下：

import analytics from '@react-native-firebase/analytics';

// 正确上报示例
await analytics().logEvent(analytics.EventName.ViewItem, {
  screen_name: 'option_detail',
  category: 'categorie1',
  sub_category: 'achat_options',
  currency: 'EUR',
  value: 5,
  items: [
    {
      item_id: 'id1',
      item_name: 'option1',
      item_category: 'options',
      price: 5
    }
  ],
  platform: 'android'
});

注意：上报参数的键名也建议遵循官方规范，比如示例中的screenName建议改为官方要求的screen_name，避免参数识别失败。

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