GA4的items参数能否添加自定义参数并同步至BigQuery？

结论 #

可以在GA4事件的items参数内正常使用自定义参数，且数据可同步至BigQuery，查询不到数据通常是未完成配置全流程导致的，具体操作及注意事项如下：

操作步骤 #

1. 确认上报格式正确性 #

GA4 items数组的每个元素支持直接平铺添加自定义参数，gtag上报示例如下：

gtag('event', 'view_item_list', {
  item_list_name: '推荐商品列表',
  items: [
    {
      item_id: '24',
      item_name: 'exampleName',
      price: '12345',
      item_list_name: 'listName',
      // 下方为自定义参数
      customKey00: 'customValue00',
      customKey01: 'customValue01'
    }
  ]
});

你观察到的GTM请求中k0~v0/k1~v1的序列化格式符合GA4的请求规范，上报格式无问题。

2. 注册item级自定义维度 #

item级自定义参数不会自动同步到BigQuery，需要先在GA4后台完成注册：

• 进入GA4后台「管理」-「自定义设置」-「自定义维度」
• 点击「创建自定义维度」，维度范围选择商品（Item），维度名称、事件参数填写你上报时使用的自定义参数名（大小写需完全匹配）
• 最多可注册10个item级自定义维度，符合官方限制要求
• 配置完成后新上报的数据会在24-48小时后入库，配置前上报的历史数据无法回溯

3. BigQuery查询方法 #

GA4导出到BigQuery的表中，item级自定义参数存储在items.item_custom_dimensions数组字段中，查询示例如下：

SELECT
  event_name,
  items.item_id,
  items.item_name,
  -- 提取自定义参数值
  (SELECT value.string_value FROM UNNEST(items.item_custom_dimensions) WHERE key = 'customKey00') AS customKey00,
  (SELECT value.string_value FROM UNNEST(items.item_custom_dimensions) WHERE key = 'customKey01') AS customKey01
FROM
  `你的项目ID.你的GA4数据集.events_*`,
  UNNEST(items) AS items
WHERE
  _TABLE_SUFFIX BETWEEN '20240101' AND '20240107'
  AND event_name = 'view_item_list'

注意事项 #

• 若使用GTM的GA4事件标签，需要在标签配置的「商品参数」模块中添加对应的自定义参数，确保参数被正常读取上报
• 自定义参数值如果是数值类型，查询时需将value.string_value替换为value.int_value或value.float_value

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