求助：如何使用gtag.js在页面浏览时发送自定义维度？

开发者阿泽

2026-5-19

用gtag.js在页面浏览时发送自定义维度的具体操作方法

我之前也踩过这个坑，Google的迁移指南确实没把这个点讲透，给你整理了几个亲测有效的操作方式，照着来就行：

前提准备

首先你得在Google Analytics后台创建好对应的自定义维度，一定要记下它的索引编号——比如你创建的第一个自定义维度对应dimension1，第二个是dimension2，这个编号是后续代码里的关键，不能填错。

方法一：和Pageview请求合并发送（推荐）

这是最常用的方式，把自定义维度和页面浏览请求合并成一次发送，减少不必要的网络请求：

// 替换成你的GA跟踪ID，以及对应的维度索引和值
gtag('config', 'UA-XXXXXXXXX-X', {
  'dimension1': '付费用户', // 这里的dimension1对应你后台的维度索引
  'page_title': '首页',
  'page_path': '/'
});

解释：在gtag('config')的第三个参数里，直接添加自定义维度的键值对，GA会自动把这个维度和pageview数据一起上报。

方法二：设置全局维度，后续所有请求自动附带

如果这个维度在用户整个会话中都有效（比如用户的会员等级），可以先全局设置，之后的pageview、事件等所有上报都会自动带上这个维度：

// 先设置全局自定义维度
gtag('set', {
  'dimension2': 'VIP会员'
});

// 之后发送pageview，会自动附带上面的维度
gtag('config', 'UA-XXXXXXXXX-X');

方法三：动态获取维度值后再发送Pageview

如果维度值需要从页面元素、接口或者其他动态逻辑中获取，可以先设置维度，再触发pageview：

// 比如从页面元素中获取维度值
const userType = document.querySelector('.user-type').textContent;

// 设置自定义维度
gtag('set', {
  'dimension3': userType
});

// 发送pageview
gtag('config', 'UA-XXXXXXXXX-X');