이벤트·파라미터 설계 이벤트명, 파라미터, user property, custom dimensions/metrics, GA4 limits를 설계 규칙으로 바꾸기
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 분석용으로
보관하는 식으로 나눕니다.