如何从GTM向GA4传递嵌套event_data对象，避免[object Object]或字符串存储

我正在使用Google Tag Manager（GTM）将Google Analytics 4（GA4）集成到Web项目中，通过{{event}}、{{custom_trigger}}、{{event_data}}等自定义变量实现动态事件追踪，捕获各类事件及关联数据。

我向dataLayer推送的event_data有时为嵌套对象，示例如下：

dataLayer.push({
  event: "custom_event",
  event_data: {
    user: {
      id: "123",
      type: "premium"
    },
    action: "clicked"
  }
});

通过GTM自定义事件标签发送event_data至GA4时，嵌套属性（如user）会显示为[object Object]，无法保留结构。使用JSON.stringify(event_data)虽能保留结构，但GA4会将其存储为字符串，导致无法在GA4报表或BigQuery中查询单个嵌套字段。

我需要一种从GTM向GA4传递嵌套对象的方法，满足：

1. 保留嵌套结构；
2. 既不被扁平化，也不存储为单个字符串；
3. 嵌套属性可在GA4或BigQuery中单独访问。

补充信息：我了解GA4架构偏好扁平参数，但电商、用户特征等场景中嵌套对象十分实用。我使用GTM标准GA4事件标签，通过变量映射动态字段。请问是否有自动扁平化对象的推荐模式，或GA4支持的嵌套数据处理方法？

GA4本身不支持直接接收嵌套对象作为事件参数，需通过结构化扁平化处理，既保证字段可单独查询，又能在BigQuery中还原嵌套结构。以下是两种可行方案：

方案1：推送dataLayer前自动扁平化对象 #

在页面脚本中加入扁平化函数，提前将嵌套对象转换为GA4支持的点分隔式参数，推送后GTM可直接映射，GA4会自动识别为嵌套结构。

编写扁平化函数并使用：

function flattenObject(obj, prefix = '') {
  return Object.keys(obj).reduce((acc, key) => {
    const pre = prefix.length ? `${prefix}.` : '';
    if (typeof obj[key] === 'object' && obj[key] !== null && !Array.isArray(obj[key])) {
      Object.assign(acc, flattenObject(obj[key], pre + key));
    } else {
      acc[pre + key] = obj[key];
    }
    return acc;
  }, {});
}

// 推送示例
const eventData = {
  user: {
    id: "123",
    type: "premium"
  },
  action: "clicked"
};

const flattenedData = flattenObject(eventData);
dataLayer.push({
  event: "custom_event",
  ...flattenedData
});

推送后dataLayer数据结构变为：

{
  event: "custom_event",
  "user.id": "123",
  "user.type": "premium",
  action: "clicked"
}

在GTM的GA4事件标签中，直接将user.id、user.type作为参数名，映射对应的变量即可。BigQuery导出时，这些点分隔参数会自动还原为嵌套对象结构。

方案2：在GTM中用自定义JS变量扁平化 #

若无法修改页面推送代码，可在GTM内创建自定义JavaScript变量处理嵌套对象：

1. 创建新的「自定义JavaScript」变量，命名为{{flattened_event_data}}
2. 输入以下代码：

function() {
  const flatten = (obj, prefix = '') => {
    return Object.keys(obj).reduce((acc, key) => {
      const pre = prefix ? `${prefix}.` : '';
      if (typeof obj[key] === 'object' && obj[key] !== null && !Array.isArray(obj[key])) {
        Object.assign(acc, flatten(obj[key], pre + key));
      } else {
        acc[pre + key] = obj[key];
      }
      return acc;
    }, {});
  };
  const eventData = {{event_data}};
  return eventData ? flatten(eventData) : {};
}

3. 在GA4事件标签中，选择「添加参数」→「使用变量」，选中{{flattened_event_data}}，GTM会自动将所有扁平化后的参数映射到事件中。

注意事项 #

• GA4单事件最多支持25个参数，嵌套字段过多时需筛选核心字段推送；
• 电商场景的items数组属于GA4原生支持的结构化参数，无需扁平化，直接在GTM电商标签中映射即可；
• BigQuery导出时，点分隔参数会自动转换为嵌套JSON结构，可直接通过user.id这类语法查询单个字段。

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