gtag.js를 사용한 맞춤 측정기준 및 측정항목

웹 개발자는 맞춤 측정기준 및 측정항목을 사용하여 로그인 및 로그아웃한 사용자, 페이지 작성자 또는 게임 레벨 간의 차이를 분류하고 측정할 수 있습니다. 이 페이지에서는 맞춤 측정기준 및 측정항목을 Google 애널리틱스로 전송하는 방법을 설명합니다.

맞춤 매개변수의 값을 Google 애널리틱스로 전송하려면 매개변수를 다음 맞춤 Google 애널리틱스 측정기준 또는 측정항목 매개변수에 매핑하세요.

맞춤 매개변수	데이터 유형	설명
`dimension<Index>`	`string`	맞춤 측정기준 매개변수(예: `dimension3`)
`metric<Index>`	`string`	맞춤 측정항목 매개변수(예: `metric8`)

맞춤 측정기준 구성 및 전송

맞춤 매개변수의 값을 Google 애널리틱스로 전송하려면 웹사이트의 값을 Google 애널리틱스 매개변수에 매핑해야 합니다. 이 작업은 custom_map 매개변수를 사용하여 실행할 수 있습니다.

맞춤 측정기준을 Google 애널리틱스로 전송하려면 속성의 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'를 자체 애널리틱스 ID로 대체합니다.

예를 들어 다음 스니펫은 값이 55인 맞춤 측정기준 dimension2를 Google 애널리틱스로 전송합니다.

// 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 애널리틱스로 전송하려면 속성의 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'를 자체 애널리틱스 ID로 대체합니다.

예를 들어 다음 스니펫은 값이 1인 맞춤 측정항목 metric5를 Google 애널리틱스로 전송합니다.

// 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});