如何通过Google Tag Manager API为GA4事件标签传递事件参数

你遇到的问题是通过GTM API创建GA4事件标签时，eventParameters的子项格式不符合要求导致报错。错误提示翻译为：

"vendorTemplate.parameter.eventParameters[0]: 值无效。\n"

问题核心在于GA4事件参数在GTM API的结构中，每个参数需要以嵌套键值对对象的形式定义，而非直接将参数名设为子项的key。以下是修正后的代码：

{
  "name": "test2",
  "type": "gaawe",
  "parameter": [
    {
      "type": "template",
      "key": "eventName",
      "value": "hey"
    },
    {
      "type": "tagReference",
      "value": "LocalTag",
      "key": "measurementId"
    },
    {
      "type": "list",
      "key": "eventParameters",
      "list": [
        {
          "type": "map",
          "parameter": [
            {
              "type": "template",
              "key": "name",
              "value": "page_title"
            },
            {
              "type": "template",
              "key": "value",
              "value": "{{Page Title}}"
            }
          ]
        }
      ]
    }
  ]
}

关键修改说明： #

• 将原eventParameters列表中子项的type从template改为map，因为每个参数是包含name和value的复合对象
• 每个参数子项内部通过parameter数组定义两个必填项：name（GA4接收的参数名称）和value（参数值，支持GTM变量如{{Page Title}}）

修改后调用GTM API即可成功创建带有效事件参数的GA4标签，参数会正常传递至GA4。后续你可以基于这个结构扩展，实现GA4迁移中触发器与标签的自动化创建。

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