핸드북 › GA4 고급 애널리틱스 › 이벤트·파라미터 설계 이벤트·파라미터 설계 이벤트명, 파라미터, user property, custom dimensions/metrics, GA4 limits를 설계 규칙으로 바꾸기
핵심 요약
이벤트가 보이는 것과 분석할 수 있는 것은 다릅니다. 보고서·탐색에서 쓸 파라미터는 custom dimensions나 custom metrics로 등록해야 합니다.
파라미터는 event context, quantitative value, user/account segment, item metadata, debug/ops로 분류하고 각각 event/user/item scope를 맞게 고릅니다.
GA4 limits(user properties 25개, event-scoped custom dimensions/metrics 각 50개, key events 30개)를 설계 제약으로 삼아 등록 대상을 추립니다.
낮은 cardinality 값은 UI·BigQuery 모두 적합하지만, raw URL·search term·식별자처럼 높은 cardinality 값은 UI 등록을 피하고 BigQuery에 보관합니다.
이벤트 스펙에는 event name, trigger, owner, required/optional parameters, custom definition, key event 여부, QA rule, privacy note를 명시합니다.
GA4에서 "이벤트가 보인다"와 "분석할 수 있다"는 다릅니다.
보고서와 탐색에서 쓸 파라미터는 custom dimensions나 custom metrics로 등록해야 하고, scope와 cardinality를 잘못 잡으면 분석 표면이 확 좁아집니다.
분류 예시 등록 기준 Event context surface, step, method, variant보고서에서 자주 필터링하면 event-scoped custom dimension Quantitative value value, latency_ms, seat_count수치 집계가 필요하면 custom metric User/account segment role, industry, account_tier사용자 속성으로 지속되어야 하면 user property Item metadata item_id, item_name, item_categoryecommerce events의 items 배열 또는 item-scoped 확장 Debug/ops error_code, schema_versionBigQuery 분석 중심이면 UI 등록을 아낄 수 있음
Scope 언제 쓰나 예시 Event-scoped dimension 이벤트 순간의 문맥 cta_location, activation_type, checkout_stepEvent-scoped metric 이벤트 순간의 수치 latency_ms, credit_used, seat_countUser-scoped dimension 사용자의 안정적 세그먼트 account_tier, user_role, company_size_bucketItem-scoped data 상품/플랜/아이템 단위 분석 item_id, item_category, billing_cycle
제한 설계 해석 Event name 길이 제한 이벤트명을 짧고 의미 있게 유지 Event parameters per event 제한 모든 문맥을 한 이벤트에 몰지 않음 User properties 25개 제한 account/user segment를 엄선 Event-scoped custom dimensions 50개 제한 보고서에서 볼 파라미터만 등록 Event-scoped custom metrics 50개 제한 BigQuery 전용 수치는 UI 등록을 아낌 Key events 30개 제한 사업 성공 이벤트만 key event로 승격
값 유형 GA4 UI 등록 BigQuery 보관 이유 낮은 cardinality 적합 적합 plan, role, step, variant 중간 cardinality 선택 적합 content_type, feature_name 높은 cardinality 비추천 적합 raw URL, search term, user-entered text 식별자 UI 비추천 해시/대체키만 제한적으로 privacy와 cardinality 리스크
필드 설명 Event name GA4에 전송할 이름 Trigger 언제 발화하는지 Owner 이벤트 정의 책임자 Required parameters 없으면 분석이 깨지는 필수 문맥 Optional parameters 있으면 좋은 문맥 Custom definition GA4 UI 등록 여부 Key event key event 승격 여부 QA rule DebugView/Realtime/BigQuery 확인 기준 Privacy note PII, consent, retention 관련 주의
필드 값 Event name activation_completeTrigger 사용자가 첫 workspace를 만들고 핵심 기능을 한 번 실행했을 때 Required parameters activation_type, plan, source_surfaceOptional parameters trial_day, role, schema_versionCustom definition activation_type, plan, source_surfaceKey event 예, activation이 north-star funnel에 포함될 때 QA rule DebugView에서 1회만 발화, BigQuery에서 user/account 조인 가능 Privacy note workspace name, email, raw prompt를 보내지 않음
보고서에 안 보이는 파라미터
이벤트와 함께 파라미터를 보내도 GA4 UI의 standard report나 exploration에서 모든 파라미터를 바로 쓰지는
못합니다. 자주 분석할 파라미터는 custom dimensions나 custom metrics로 등록하고, 나머지는 BigQuery 분석용으로
돌리는 식으로 나눕니다.
관련 문서 템플릿 GA4 이벤트 스펙, custom definition registry, key event checklist, QA checklist 템플릿
SaaS 이벤트 플레이북 가입, 온보딩, activation, pricing, checkout, retention용 GA4 이벤트 사전 템플릿
국가 배포·현지화 운영 Android 앱 엔터프라이즈 운영 · country rollout, pre-registration, custom store listings, 번역 운영 기준
크리에이티브 실험 Android 앱 엔터프라이즈 운영 · store listing experiments와 custom store listings를 운영하는 기준
AI Gateway 제어면 Vercel 엔터프라이즈 AI 플랫폼 · AI Gateway를 모델 라우팅, 비용, 정책, 자격 증명 관리를 중앙화하는 제어면으로 운영하는 방법을 정리합니다.