# GA4 맞춤 측정기준 등록하기

이벤트 택소노미에 설계한 파라미터를 GA4 보고서에서 보이게 하려면 ‘맞춤 측정기준’으로 등록해야 합니다. 등록 화면 진입부터 입력 필드별 의미, 그리고 ‘파라미터 이름 = 측정기준 이름’ 원칙까지 단계별로 설명합니다.

- 카테고리: 이벤트 택소노미
- 소요 시간: 약 6분
- 난이도: 입문
- 업데이트: 2026.05.18
- 원문: /wiki/playbook/ga4-event-taxonomy-checklist/how-to-register-ga4-custom-dimensions

## 목차

- [왜 등록해야 하나요](#why)
- [1단계 · 맞춤 정의 진입](#step-1)
- [2단계 · 만들기 버튼 클릭](#step-2)
- [3단계 · 입력 필드](#step-3)
- [4단계 · 범위 선택](#step-4)
- [5단계 · 이름 컨벤션](#step-5)
- [6단계 · 설명 작성](#step-6)
- [7단계 · 저장](#step-7)
- [8단계 · 한도](#step-8)
- [자주 묻는 질문](#faq)

이벤트 택소노미에서 설계한 파라미터를 GA4가 ‘이해할 수 있는 측정기준’으로 만들어 주는 단계가 **맞춤 측정기준(Custom Dimension) 등록**입니다. 이 작업을 하지 않으면 GA4가 이벤트는 받아도 보고서에는 그 파라미터가 보이지 않습니다. 이 글은 등록 화면 진입부터 입력 필드 의미, 그리고 ‘**파라미터 이름 = 측정기준 이름**’이라는 우리 컨벤션까지 한 번에 정리합니다.

## 왜 등록해야 하나요

GA4는 ‘**표준 매개변수**’(예: `page_location`, `page_title`)는 자동으로 보고서에 노출하지만, 우리가 택소노미에서 직접 만든 ‘**맞춤 매개변수**’(예: `gnb_name`, `list_position`)는 등록을 거쳐야만 측정기준으로 인식합니다.

등록 절차는 단순합니다 — 관리 화면의 ‘맞춤 정의’에 우리가 보낸 파라미터를 그대로 ‘**이런 이름의 측정기준으로 쓸 거예요**’ 라고 알려 주면 됩니다. 화면 한 번에, 한 파라미터당 한 번 등록하면 끝입니다.

## 1단계. 관리 → 맞춤 정의로 진입

GA4 좌측 하단의 톱니바퀴(**관리**)를 누르고, ‘**데이터 표시 → 맞춤 정의**’로 들어갑니다. 이미 등록된 측정기준이 있으면 목록으로 표시되고, 아무것도 없으면 ‘**맞춤 측정기준 만들기**’ 버튼만 우측 상단에 보입니다.

![GA4 관리 화면의 ‘맞춤 정의’ 페이지. 좌측 사이드 메뉴에 ‘관리 / 내 환경설정 / 계정 설정 / 속성 설정 / 데이터 표시’ 트리가 있고 ‘데이터 표시 → 맞춤 정의’가 활성화되어 있다. 우측 본문에는 ‘맞춤 측정기준 / 맞춤 측정항목 / 계산된 측정항목’ 세 탭이 있고, 표 헤더(측정기준 이름·설명·범위·사용자 속성/매개변수·마지막 변경일) 아래에 항목이 없는 빈 상태가 보이며, 우측 상단에 파란색 ‘맞춤 측정기준 만들기’ 버튼이 강조되어 있다.](/wiki-assets/playbook/how-to-register-ga4-custom-dimensions/01-custom-def-hub.png)

> ‘관리 → 데이터 표시 → 맞춤 정의’ 화면. 우측 상단의 ‘맞춤 측정기준 만들기’를 누르면 등록 폼이 열립니다.

## 2단계. ‘맞춤 측정기준 만들기’ 버튼 클릭

버튼을 누르면 우측에서 입력 패널이 슬라이드로 열립니다. 한 번에 한 파라미터씩 등록하는 모양이라, 여러 파라미터가 있다면 같은 작업을 반복합니다.

![GA4의 ‘새 맞춤 측정기준’ 입력 패널이 우측에서 슬라이드로 열려 있는 모습. 패널 상단에 ‘새 맞춤 측정기준’ 제목과 닫기(X) 아이콘이 있고, 입력 필드로 ‘측정기준 이름’·‘범위(드롭다운: 이벤트)’·‘설명’·‘이벤트 매개변수 선택’ 네 가지가 세로로 배치되어 있으며, 모든 필드가 비어 있다. 상단에 ‘고유 값이 많은 맞춤 측정기준을 만들면 보고서에 부정적인 영향을 미칠 수 있습니다’ 경고 배너가 노란색으로 표시되어 있다.](/wiki-assets/playbook/how-to-register-ga4-custom-dimensions/02-form-empty.png)

> 새 맞춤 측정기준 입력 폼. 네 가지 필드만 채우면 됩니다 — 측정기준 이름·범위·설명·이벤트 매개변수.

## 3단계. 네 가지 필드 — 무엇을 어떻게 채우나

입력은 단순하지만, 각 필드가 GA4 보고서에서 어떻게 보이게 되는지를 먼저 이해해 두면 결정이 빨라집니다.

| 필드 | 의미 | 채우는 값 |
| --- | --- | --- |
| 측정기준 이름 | GA4 보고서의 측정기준 목록에 표시될 이름 | **파라미터 이름과 동일하게** (아래 컨벤션 참고) |
| 범위 | 이 값이 ‘어느 레벨’에 부여되는 정보인지 | **이벤트 / 사용자 / 항목** 중 하나 — 택소노미의 ‘파라미터 수준(level)’과 동일하게 |
| 설명 | 이 측정기준이 무엇을 뜻하는지(다른 운영자 참고용) | **택소노미 문서의 파라미터 설명 그대로 복사** |
| 이벤트 매개변수 | 실제 GA4가 받는 매개변수 키 | 코드에서 보내는 그 키 그대로 (예: `gnb_name`) |

## 4단계. 범위(Scope) — 택소노미의 ‘수준’과 동일하게

범위 드롭다운에는 세 가지 옵션이 있습니다 — **이벤트 · 사용자 · 항목**. 이 셋은 ‘[파라미터의 수준(level)](/wiki/playbook/ga4-event-taxonomy-checklist/what-is-ga4-parameter-levels)’ 글에서 다룬 세 자리와 정확히 같습니다. 택소노미에서 ‘이벤트 레벨’로 설계한 파라미터는 여기서도 ‘이벤트’를, ‘사용자 레벨’ 파라미터는 ‘사용자’를, `items` 안에 들어가는 파라미터는 ‘항목’을 고릅니다.

![GA4 맞춤 측정기준 등록 폼의 ‘범위’ 드롭다운이 펼쳐진 모습. 세 가지 옵션 — ‘이벤트(현재 선택, 체크 표시)’, ‘사용자’, ‘항목’이 위에서 아래로 표시되어 있다.](/wiki-assets/playbook/how-to-register-ga4-custom-dimensions/04-scope-dropdown.png)

> 범위 드롭다운의 세 옵션. 이벤트·사용자·항목은 택소노미의 파라미터 수준과 1:1로 대응됩니다 — 잘못 고르면 같은 파라미터인데도 GA4 보고서에서 다른 자리에 들어가 보입니다.

## 5단계. ‘측정기준 이름 = 파라미터 이름’ 컨벤션

가장 흔히 발생하는 운영 사고는 **측정기준 이름을 한글로 또는 사람이 읽기 좋게 임의로 지어 두는 것**입니다. 예를 들어 코드에서는 `gnb_name` 매개변수로 보내고, GA4에는 ‘GNB 메뉴명’이라는 측정기준 이름으로 등록해 두면 — 분석가 입장에서는:

- 택소노미 시트에선 `gnb_name`이라고 부르고
- BigQuery에선 `event_params.key='gnb_name'`으로 꺼내고
- GA4 보고서에선 ‘GNB 메뉴명’이라는 이름으로 잡혀 있는

세 곳의 이름이 달라 ‘같은 데이터’인지 매번 mental mapping을 해야 합니다. 시간이 지나면 헷갈리고, 신규 입사자는 더 혼란스럽습니다. 그래서 Hurdlers의 컨벤션은 단순합니다 — **‘측정기준 이름’도 코드 키와 똑같이 영문 snake_case**로 둡니다.

![GA4 맞춤 측정기준 등록 폼에 예시 값이 채워진 모습. 측정기준 이름은 ‘gnb_name’, 범위는 ‘이벤트’, 설명은 ‘사용자가 클릭한 GNB 메뉴의 이름. 예) 쇼핑·브랜드·이벤트.’, 이벤트 매개변수도 ‘gnb_name’으로 입력되어 있다. 측정기준 이름과 이벤트 매개변수가 동일한 키임을 시각적으로 보여 준다.](/wiki-assets/playbook/how-to-register-ga4-custom-dimensions/03-form-filled.png)

> 등록 직전의 폼. ‘측정기준 이름’과 ‘이벤트 매개변수’가 모두 `gnb_name`으로 동일한 점이 핵심입니다.

이 컨벤션을 따르면 — 보고서에서 `gnb_name`이라는 측정기준이 보일 때, 그것이 코드의 `gnb_name` 키, 택소노미의 `gnb_name` 행과 같은 것이라는 점이 자명해집니다. SQL을 쓰는 분석가도 BI 도구를 쓰는 분석가도 같은 단어로 같은 데이터를 찾을 수 있습니다.

## 6단계. 설명 — 택소노미 문서 그대로 복사

‘설명’ 필드는 GA4 관리 화면 외에 다른 운영자가 ‘이 측정기준이 뭐였더라’ 싶을 때 들어와 보는 자리입니다. 이때 가장 큰 권위는 ‘**택소노미 시트의 파라미터 설명**’입니다 — 사용 시점·예시값·주의사항이 가장 충실히 정리되어 있기 때문.

그래서 이 필드는 직접 다시 쓰지 말고, **택소노미 시트의 ‘설명’ 열을 그대로 복사·붙여넣기** 하는 것을 원칙으로 합니다. 시트가 단일 원본(source of truth)이 되고, GA4의 ‘설명’은 그 사본일 뿐입니다.

## 7단계. 저장 — 한 번 누르면 끝, 다만 보고서엔 24시간 후

네 필드를 채우고 우측 상단 **‘저장’**을 누르면 등록이 완료됩니다. 다만 GA4 보고서에 이 측정기준이 ‘선택 가능한 차원’으로 나타나는 데는 보통 **24~48시간**이 걸립니다. 등록한 다음 날 분석가가 “보고서에 안 보여요”라고 묻기 전에 한 마디 — “하루 정도 기다리면 보입니다” — 만 전달해 두면 됩니다.

## 8단계. 한도 — 무한정 만들 수는 없습니다

GA4 표준 속성 기준, 한 속성에 만들 수 있는 맞춤 측정기준 수는 다음과 같습니다.

| 범위 | 한도(표준 속성) | 한도(GA360) |
| --- | --- | --- |
| 이벤트 범위 | 50개 | 125개 |
| 사용자 범위 | 25개 | 100개 |
| 항목(items) 범위 | 10개 | 10개 |

한도에 가까워질수록 ‘**정말 분석에 필요한가**’를 한 번 더 묻습니다. 택소노미에 있는 모든 파라미터를 다 등록할 필요는 없습니다 — GA4 화면에서 측정기준으로 직접 보고 싶을 때만 등록하면 됩니다. 등록하지 않은 매개변수는 BigQuery export에는 여전히 들어와서 SQL로는 분석 가능합니다.

## 자주 묻는 질문

### 측정기준 이름을 한글로 짓고 싶은데 안 되나요?

물리적으로는 가능합니다. 하지만 위에서 다룬 것처럼 — 택소노미·코드·BigQuery·GA4 보고서 네 곳의 이름이 달라지면 같은 데이터를 식별하는 비용이 늘고, 신규 입사자가 헷갈립니다. ‘한글 라벨’이 꼭 필요하면 별도로 ‘분석가용 사용 설명서’를 만들어 매핑 표를 따로 둡니다 — 측정기준 자체 이름은 코드 키 그대로 두는 것이 안전합니다.

### 한 번 등록한 측정기준의 이름을 나중에 바꿀 수 있나요?

측정기준 이름과 설명은 수정 가능합니다. 다만 **이벤트 매개변수 키와 범위는 한 번 정하면 변경할 수 없습니다** — 키를 바꾸려면 측정기준을 보관처리(아카이브)하고 같은 키로 새로 등록해야 하고, 보고서에서 과거 데이터와 분리됩니다. 그래서 ‘처음 등록할 때 키와 범위를 신중히’가 가장 중요합니다.

### 설명에 한글을 써도 되나요?

네, 설명 필드는 한글이 좋습니다. 화면에서 ‘이게 무슨 의미인지’를 즉시 알아볼 수 있어야 하니까요. 키와 이름은 영문 snake_case로 두되, 설명만은 택소노미 시트의 한글 설명을 그대로 옮겨 옵니다.

### 택소노미에 있는 매개변수를 모두 등록해야 하나요?

아니요. GA4 보고서·탐색에서 ‘측정기준으로 직접 선택해서 보고 싶은 것’만 등록하면 됩니다. 등록하지 않은 매개변수도 BigQuery export에는 그대로 들어와 있어 SQL 분석에는 영향이 없습니다. 한도(이벤트 50개)가 있으므로 ‘선별’이 오히려 좋은 운영입니다.

### ‘고유 값이 많은 측정기준은 부정적 영향’ 경고는 뭔가요?

등록 폼 상단에 노란색 경고로 나타나는 안내입니다. **카디널리티(고유 값 수)가 매우 큰 측정기준** — 예를 들어 사용자 ID·세션 ID·검색어처럼 값이 매번 바뀌는 것 — 을 GA4 표준 측정기준으로 등록하면, 그 데이터는 보고서에서 ‘(other)’로 묶여 버립니다. 이런 종류는 BigQuery로만 분석하는 편이 좋습니다([BigQuery로 들어오는 GA4 데이터](/wiki/playbook/bigquery-checklist/what-is-ga4-data-in-bigquery) 참고).

## Navigation

- [전체 플레이북 Markdown sitemap](/wiki/playbook/sitemap.md)

### 이벤트 택소노미

- [이벤트 택소노미](/wiki/playbook/ga4-event-taxonomy-checklist)
- [로그와 이벤트](/wiki/playbook/ga4-event-taxonomy-checklist/what-is-logs-and-events)
- [이벤트의 구조](/wiki/playbook/ga4-event-taxonomy-checklist/what-is-event-structure)
- [이벤트 택소노미의 정의와 CASE STUDY](/wiki/playbook/ga4-event-taxonomy-checklist/ga4-event-taxonomy-case-study)
- [이벤트 택소노미 문서 — 설계 담당자용](/wiki/playbook/ga4-event-taxonomy-checklist/event-taxonomy-document-for-designers-guide)
- [이벤트 택소노미 문서 — 개발자용](/wiki/playbook/ga4-event-taxonomy-checklist/how-to-implement-event-taxonomy-for-developers)
- [Data Layer와 GTM — 이벤트 태깅의 큰 그림](/wiki/playbook/ga4-event-taxonomy-checklist/data-layer-and-gtm-guide)
- [GA4 이벤트의 종류](/wiki/playbook/ga4-event-taxonomy-checklist/what-is-ga4-event-types)
- [이벤트 이름과 표기법](/wiki/playbook/ga4-event-taxonomy-checklist/how-to-name-ga4-events)
- [주요이벤트와 서브이벤트](/wiki/playbook/ga4-event-taxonomy-checklist/key-events-vs-sub-events)
- [이벤트 이름 설계의 세분성(granularity)](/wiki/playbook/ga4-event-taxonomy-checklist/how-to-decide-event-granularity)
- [파라미터 이름과 표기법](/wiki/playbook/ga4-event-taxonomy-checklist/how-to-name-ga4-parameters)
- [파라미터의 타입(type)](/wiki/playbook/ga4-event-taxonomy-checklist/how-to-choose-ga4-parameter-types)
- [파라미터의 수준(level)](/wiki/playbook/ga4-event-taxonomy-checklist/what-is-ga4-parameter-levels)
- [GA4 맞춤 측정기준 등록하기](/wiki/playbook/ga4-event-taxonomy-checklist/how-to-register-ga4-custom-dimensions) (현재 문서)
- [GA4 전자상거래란?](/wiki/playbook/ga4-event-taxonomy-checklist/what-is-ga4-ecommerce)
- [전자상거래 이벤트를 이해하기 위한 프로그래밍 지식](/wiki/playbook/ga4-event-taxonomy-checklist/ecommerce-event-programming-guide)
- [전자상거래 리포트 100% 이해하기](/wiki/playbook/ga4-event-taxonomy-checklist/ga4-ecommerce-reports-guide)