如何通过GTM动态传递自定义事件参数至Google Analytics 4？

方案1：用自定义JS变量自动捕获所有参数 #

无需开发人员修改代码，直接在GTM内完成配置：

1. 启用内置变量：进入GTM「变量」→「内置变量」，勾选「Data Layer - Last Event」，该变量用于获取触发当前标签的dataLayer事件对象。
2. 创建自定义JS变量：新增「自定义JavaScript」变量（可命名为Dynamic Event Params），代码如下：

function() {
  const eventData = {{Data Layer - Last Event}};
  const params = {};
  // 遍历事件对象，排除event字段，提取所有自定义参数
  for (const key in eventData) {
    if (key !== 'event') {
      params[key] = eventData[key];
    }
  }
  return params;
}

3. 配置GA4标签：编辑「Google Analytics: GA4 Event」标签，找到「事件参数」区域，点击「添加参数」→「从变量导入」，选择刚才创建的Dynamic Event Params变量。GTM会自动解析变量返回的键值对，将所有自定义参数传递给GA4。

方案2：统一包装自定义参数（推荐，更规范） #

如果可以协调开发人员调整代码，把所有自定义参数统一放到一个字段里，避免和dataLayer其他内置字段冲突：

1. 修改前端代码：

dataLayer.push({
    event: 'CA:some-event',
    custom_params: {
        a: 1, // 自定义参数
        b: 2  // 自定义参数
    }
})

2. 创建数据层变量：在GTM中新增「数据层变量」，变量名设为custom_params，数据层版本选择「Version 2」。
3. 配置GA4标签：同样在GA4标签的「事件参数」区域，从变量导入custom_params变量，即可自动传递所有自定义参数。

关键注意事项 #

• GA4后台需对应创建自定义参数（路径：「管理」→「自定义定义」→「创建自定义参数」），否则参数会被收集但无法直接在标准报告中展示（未定义的参数会出现在「事件参数」列表，可后续补充配置）。
• 参数名需符合GA4规则：仅包含字母、数字、下划线，不能以数字开头，长度不超过256字符。
• 测试时可通过GTM预览模式查看标签参数，同时在GA4「实时」报告中确认事件和参数是否正常接收。

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