如何在Firebase Analytics自定义事件中传递对象数组参数？

算力阿峰

2026-8-25

解决Firebase Analytics自定义事件传递自定义对象的问题

为什么会出现这个问题

Firebase Analytics对自定义事件的参数有明确限制：

items字段是预定义事件（比如purchase、view_item）专属的，自定义事件里用这个字段不会被解析展示
自定义事件的参数只支持字符串、数字、布尔值这类基础类型，嵌套对象或复杂数组会被直接忽略

三种可行的解决办法

1. 把嵌套对象转成JSON字符串传递

将完整的API详情对象序列化为JSON字符串，作为单个参数值发送，后续分析时再反序列化还原数据：

logEvent(
  analytics,
  'studio_metrics',
  {
    api_details: JSON.stringify({
      url: '/api/get-data',
      method: 'GET',
      status_code: 200,
      request_params: { user_id: 123, role: 'admin' }
    })
  }
)

2. 拆分嵌套对象为扁平参数

如果API详情的结构不复杂，直接把嵌套字段拆成独立的事件参数，这样在调试视图和分析后台都能直接看到具体字段：

logEvent(
  analytics,
  'studio_metrics',
  {
    api_url: '/api/get-data',
    api_method: 'GET',
    api_status_code: 200,
    api_user_id: 123,
    api_user_role: 'admin'
  }
)

3. 结合用户属性传递全局数据

如果有些API相关信息是用户级别的全局数据（比如当前环境、用户权限），可以先设置为用户属性，再在自定义事件里传递其他动态字段：

// 先设置用户属性（全局生效）
setUserProperties(analytics, {
  api_environment: 'production'
});

// 记录自定义事件
logEvent(
  analytics,
  'studio_metrics',
  {
    api_url: '/api/get-data',
    api_status_code: 200
  }
)