GA4 自定义设置（Custom Definitions）详解

更新时间：2026年5月15号

GA4默认提供了大量维度和指标，例如页面、来源、国家、设备等。但实际业务中，企业往往还需要分析一些属于自己的数据，例如会员等级、按钮名称、商品颜色、文章作者等。

这类数据不会自动出现在GA4报告中，需要通过自定义设置（Custom Definitions）注册后，才能在报告、探索分析及受众中使用。

GA4的自定义设置主要包括三类：

• 自定义维度：用于描述数据属性（文字型数据）。
• 自定义指标：用于统计数值型数据。
• 计算指标：基于已有指标进行公式计算，生成新的分析指标。

自定义维度

自定义维度用于描述数据属性，通常作为报告中的“分类字段”（行维度）使用，例如：来源关键词、城市、页面路径等。

GA4的自定义维度共有三种范围：

范围决定了维度所绑定的数据层级，因此建立前应先确认数据属于用户、事件还是商品。

用户级自定义维度（User-scoped）

用户级自定义维度基于用户属性（User Properties） 建立。

用户属性会跟随用户长期保存，每位用户只需要更新一次即可持续生效，非常适合记录不会频繁变化的信息。

常见用途：

• 用户等级（VIP / 普通用户）
• 登录状态
• 用户 ID 关联属性

例如：

gtag('set', 'user_properties', {
  member_level: 'vip'
});

事件级自定义维度（Event-scoped）

事件级自定义维度基于事件参数建立。

它描述的是某一次事件发生时所携带的信息，因此最常使用。

例如用户点击购买按钮：

gtag('event', 'click', {
  button_name: 'Buy Now',
  button_position: 'Header',
  page_type: 'Product'
});

• button_name
• button_position
• page_type

都属于事件参数，可以注册为事件级自定义维度。

商品级自定义维度（Item-scoped）

商品级自定义维度主要用于GA4电商。

GA4默认已经支持许多商品字段，例如：

dataLayer.push({
  "event": "removeFromCart",
  "ecommerce": {
    "currencyCode": "USD",
    "remove": {
      "products": [{
        "id": "bc823",
        "name": "Fuelworks T-Shirt",
        "price": "92.00",
        "brand": "Fuelworks",
        "category": "T-Shirts",
        "variant": "red",
        "position": 0,
        "quantity": 1
      }]
    }
  }
});

如果需要记录更多商品属性，要增加”color: “black”，具体如下：

dataLayer.push({
  "event": "removeFromCart",
  "ecommerce": {
    "currencyCode": "USD",
    "remove": {
      "products": [{
        "id": "bc823",
        "name": "Fuelworks T-Shirt",
        "price": "92.00",
        "brand": "Fuelworks",
        "category": "T-Shirts",
        "variant": "red",
        "color": "black",
        "position": 0,
        "quantity": 1
      }]
    }
  }
});

随后将item_color注册为商品级自定义维度，即可在GA4电商报告中进行分析。

自定义指标

自定义指标用于统计数值型数据，仅支持事件级范围。

它通常来自事件参数中的数字字段，例如：

• 交易金额（value）
• 订单数量（quantity）
• 停留时长（engagement_time）

例如：

gtag('event', 'page_load', {
  page_load_time: 2.38
});

可将 page_load_time 注册为自定义指标，在探索分析中统计

计算指标

计算指标允许基于已有指标，通过公式生成新的指标，而无需重新埋点。

• 免费版上限：5个
• GA4 360 上限：50个

下面介绍如何用计算指标计算页面平均加载时间。

在Google Analytics 4 中跟踪页面加载时间 里跟踪了每个页面加载时间，如果已采集以下指标：

• Page Load Time（页面加载时间总和）
• Event Count（事件次数）

可以创建计算指标：平均加载时间 = Page Load Time / Event Count

在GA4中点击「管理」——「自定义设置」——「计算指标」——「创建计算指标」，然后做如下配置：

报告如：

配置完成后，即可直接在探索分析和报告中查看每个页面的平均加载时间，而无需修改网站代码。

注意点

使用GA4自定义设置时，需要注意以下几点：

• 新增或修改自定义维度、自定义指标后，一般需要 24～48 小时 才会在报告中显示。
• 自定义定义不会回溯历史数据，仅适用于注册之后收集的新事件。
• 建议建立统一的命名规范，例如全部使用英文小写与底线（snake_case），避免中英文混用。
• 商品级自定义维度必须来自 items 数组中的商品参数，否则无法正常注册。
• 自定义维度与自定义指标均有数量限制，应优先规划重要字段，避免浪费配额。
• 删除自定义定义后，仅会停止在报告中使用，不会删除已收集的原始事件数据，但对应字段将无法继续作为维度或指标使用。