基于Google Tag Manager REST API创建GA4标签及迁移问题求助

一、修复GA4标签创建的请求Payload #

出现的400错误是因为参数key命名不符合GA4标签要求，GTM的GA4标签（类型gaawe）要求用驼峰式参数名，而非下划线分隔格式。正确的请求Payload如下：

{
  "name": "GA4 Tag",
  "type": "gaawe",
  "parameter": [
    {
      "type": "template",
      "key": "measurementId",
      "value": "G-1234567890"
    },
    {
      "type": "template",
      "key": "eventName",
      "value": "page_view"
    },
    {
      "type": "list",
      "key": "customDimensions"
    }
  ]
}

错误原因说明： #

• 原请求使用measurement_id、event_name、custom_dimensions下划线命名，但GA4标签模板要求对应驼峰式的measurementId、eventName、customDimensions
• 无需添加vendorTemplate字段，该字段不属于Tag资源的规范结构，因此会触发"Property does not exist"错误

二、UA到GA4的API迁移步骤 #

• 导出现有UA标签配置：调用GTM API的tags.get接口获取已有的Universal Analytics标签，提取核心配置：UA跟踪ID、绑定的触发器ID、自定义维度/指标设置
• 映射UA配置到GA4格式：把UA配置转换成GA4标签参数，UA跟踪ID替换为GA4的Measurement ID，UA页面视图对应GA4的page_view事件，自定义维度需转换成customDimensions列表格式（示例如下）：

  {
    "type": "map",
    "key": "customDimensions",
    "map": [
      {
        "type": "template",
        "key": "index",
        "value": "1"
      },
      {
        "type": "template",
        "key": "value",
        "value": "{{custom_dimension_1}}"
      }
    ]
  }
  

• 创建GA4标签并关联触发器：用修正后的Payload创建GA4标签，创建时指定triggerId字段绑定原UA标签使用的触发器，或创建后通过tags.update接口关联
• 验证后发布工作区：先通过预览模式验证GA4标签触发逻辑，确认无误后调用workspaces.publish接口发布工作区

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