如何通过gtag.js传递参数使其在Google Data Studio中显示为维度

1. 先在Google Analytics后台配置自定义维度 #

不管你用的是UA（旧版）还是GA4（新版），都需要先在后台把要追踪的自定义属性注册为自定义维度，否则Data Studio无法识别：

• UA操作步骤：
  • 进入「管理」→「自定义定义」→「自定义维度」
  • 点击「+ 新建自定义维度」，填写维度名称（比如Layout Category），范围选「事件」，保存后会得到一个索引（比如dimension1）
• GA4操作步骤：
  • 进入「管理」→「自定义定义」→「自定义维度」
  • 点击「创建自定义维度」，填写维度名称，范围选「事件」，输入事件参数名称（比如layout_category，要和代码里的参数名完全一致），保存即可

2. 修改gtag代码传递自定义属性 #

把你的自定义属性作为事件参数传递，对应后台的配置：

UA版本代码示例： #

window.gtag('event', 'Old Layout', {
    event_category: 'Layout changes',
    event_action: 'change layout',
    event_label: 'switch to old layout',
    event_value: $(this).prop('checked'),
    // 用后台拿到的索引绑定自定义属性值
    dimension1: 'Layout changes'
});

GA4版本代码示例： #

window.gtag('event', 'old_layout', { // GA4推荐事件名用小写+下划线格式
    event_category: 'Layout changes',
    event_action: 'change layout',
    event_label: 'switch to old layout',
    event_value: $(this).prop('checked'),
    // 直接传递自定义参数，名称要和GA4后台的参数名一致
    layout_category: 'Layout changes',
    layout_checked_status: $(this).prop('checked')
});

3. 在Data Studio中更新数据源并选择维度 #

• 打开你的Data Studio报告，找到关联的Google Analytics数据源
• 点击「刷新字段」，等待数据源同步完成（数据有延迟，可能需要1-24小时）
• 之后添加图表时，就能在维度列表里找到你配置的自定义维度了

关键注意点 #

• UA中自定义维度的索引必须和后台创建的完全匹配，不能填错
• GA4不需要索引，只要代码里的参数名和后台自定义维度的参数名一致就行
• 事件名在GA4里尽量用小写字母、数字和下划线，避免空格和特殊字符，防止识别异常

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