使用 gtag.js 实现自定义维度和指标

Web 开发者可以使用自定义维度和指标来细分并衡量登录和退出的用户之间、网页作者之间或者游戏中的关卡之间的差异。本页介绍了如何向 Google Analytics(分析)发送自定义维度和指标。

要将自定义参数的值发送给 Google Analytics(分析),请将这些参数映射到以下 Google Analytics(分析)自定义维度或指标参数:

自定义参数 数据类型 说明
dimension<Index> string 自定义维度参数(例如 dimension3
metric<Index> string 自定义指标参数(例如 metric8

配置和发送自定义维度

要将自定义参数的值发送到 Google Analytics(分析),您需要将自己网站上的值映射到 Google Analytics(分析)参数。此操作可使用 custom_map 参数来实现。

要向 Google Analytics(分析)发送自定义维度,请更新您媒体资源的 config,以设置维度的 custom_map 参数,然后使用自定义参数发送自定义维度的值:

// Configures custom dimension<Index> to use the custom parameter
// 'dimension_name' for 'GA_MEASUREMENT_ID', where <Index> is a number
// representing the index of the custom dimension.
gtag('config', 'GA_MEASUREMENT_ID', {
  'custom_map': {'dimension<Index>': 'dimension_name'}
});

// Sends the custom dimension to Google Analytics.
gtag('event', 'any_event_name', {'dimension_name': dimension_value});

'GA_MEASUREMENT_ID' 替换为您自己的 Google Analytics(分析)ID。

例如,以下代码段会将自定义维度 dimension2 及其值 55 发送给 Google Analytics(分析):

// Maps 'dimension2' to 'age'.
gtag('config', 'GA_MEASUREMENT_ID', {
  'custom_map': {'dimension2': 'age'}
});

// Sends an event that passes 'age' as a parameter.
gtag('event', 'age_dimension', {'age': 55});

配置和发送自定义指标

要向 Google Analytics(分析)发送自定义指标,请更新您媒体资源的 config,以设置指标的 custom_map 参数,然后使用自定义参数发送自定义指标的值:

// Configures custom metric<Index> to use the custom parameter
// 'metric_name' for GA_MEASUREMENT_ID, where <Index> is a number
// representing the index of the custom metric.
gtag('config', 'GA_MEASUREMENT_ID', {
  'custom_map': {'metric<Index>': 'metric_name'}
});

// Sends the custom dimension to Google Analytics.
gtag('event', 'any_event_name', {'metric_name': metric_value});

'GA_MEASUREMENT_ID' 替换为您自己的 Google Analytics(分析)ID。

例如,以下代码段会将自定义指标 metric5 及其值 1 发送给 Google Analytics(分析):

// Maps 'metric5' to 'avg_page_load_time'.
gtag('config', 'GA_MEASUREMENT_ID', {
  'custom_map': {'metric5': 'avg_page_load_time'}
});

// Sends an event that passes 'avg_page_load_time' as a parameter.
gtag('event', 'load_time_metric', {'avg_page_load_time': 1});

配置和发送自定义维度和自定义指标

您可以更新媒体资源的 config,以同时映射自定义维度和自定义指标:

gtag('config', 'GA_MEASUREMENT_ID', {
   'custom_map': {
     'dimension2': 'age',
     'metric5': 'avg_page_load_time'
   }
});

gtag('event', 'foo', {'age': 55, 'avg_page_load_time': 1});