본문으로 바로가기
리옵트 핸드북
리옵트 핸드북
GA4 고급 애널리틱스 설계

측정 아키텍처

측정 전략계정·속성·스트림 아키텍처데이터 수집 기반Consent·Privacy·PII 거버넌스

이벤트 설계

이벤트 분류 체계이벤트·파라미터 설계Key events & 퍼널SaaS 이벤트 플레이북Ecommerce & Revenue 이벤트

분석 활용

Reports·Explorations·AudiencesBigQuery Export 모델링QA·Debugging·Governance템플릿

부록

참고 자료검증 리포트업데이트 내역
핸드북›GA4 고급 애널리틱스›템플릿

템플릿

GA4 이벤트 스펙, custom definition registry, key event checklist, QA checklist 템플릿

핵심 요약

  • 이 장의 표는 그대로 복사해 이벤트 설계 문서나 analytics changelog의 기본 양식으로 씁니다.
  • 이벤트 스펙 템플릿은 event name, business question, trigger, owner, parameters, key event, BigQuery impact, QA steps, privacy review, rollout date를 한 장에 담습니다.
  • custom definition registry는 name·scope·source parameter·type·allowed values·owner·used in으로 정의 대상과 허용 값을 통제합니다.
  • key event checklist와 QA checklist는 중복 발화·필수 파라미터·PII·consent·cross-domain·BigQuery row를 도구별로 점검합니다.
  • BigQuery staging view와 이벤트 변경 로그 템플릿으로 UNNEST 기반 flatten 뷰와 Changed/Reason/QA/Impact 형식의 changelog를 표준화합니다.

이 장의 표는 그대로 복사해 이벤트 설계 문서나 analytics changelog의 기본 양식으로 씁니다.

이벤트 스펙 템플릿

FieldValue
Event name
Business question
Trigger
Owner
Required parameters
Optional parameters
Recommended/custom 판단
Custom definitions needed
Key eventYes/No
BigQuery model impact
QA steps
Privacy review
Rollout date

이벤트 사전 템플릿

JourneyEventTriggerRequired parametersOptional parametersKey eventOwner
Acquisitioncta_clickCTA 클릭cta_id, cta_location, cta_intentvariantNoGrowth
Signupsign_up가입 완료methodsource_surface선택Product
Activationactivation_completeactivation 조건 충족activation_type, plantrial_day, roleYesProduct/Data

Custom definition registry

NameScopeSource parameter/propertyTypeAllowed valuesOwnerUsed in
cta_locationEventcta_locationDimensionhero, pricing, footerGrowthLead funnel
activation_typeEventactivation_typeDimensionfirst_project_created, first_runProductActivation report
latency_msEventlatency_msMetricnumericEngineeringPerformance analysis
account_tierUseraccount_tierDimensionfree, pro, team, enterpriseDataSegment reports

Key event checklist

CheckPass
사업 성공과 직접 연결된다
중복 발화 방지 기준이 있다
필수 파라미터가 안정적이다
광고/audience에 써도 의미 왜곡이 적다
key event limit 안에서 우선순위가 높다
기존 report/dashboard 영향도를 확인했다

QA checklist

CheckToolPass
Prod/staging Measurement ID 분리GA4 Admin/GTM
이벤트 1회 발화DebugView
필수 파라미터 존재DebugView/BigQuery
PII 없음URL, dataLayer, DebugView
Consent state별 동작 확인GTM Preview
Cross-domain session 유지Realtime/DebugView
BigQuery raw row 확인BigQuery
Custom definition 등록 확인GA4 Admin

BigQuery staging view 템플릿

CREATE OR REPLACE VIEW `my_project.analytics_mart.stg_ga4_events` AS
SELECT
  event_date,
  TIMESTAMP_MICROS(event_timestamp) AS event_ts,
  user_pseudo_id,
  user_id,
  event_name,
  (SELECT value.string_value FROM UNNEST(event_params) WHERE key = 'page_location') AS page_location,
  (SELECT value.string_value FROM UNNEST(event_params) WHERE key = 'source_surface') AS source_surface,
  (SELECT value.string_value FROM UNNEST(event_params) WHERE key = 'plan') AS plan,
  (SELECT value.string_value FROM UNNEST(event_params) WHERE key = 'activation_type') AS activation_type,
  (SELECT value.double_value FROM UNNEST(event_params) WHERE key = 'value') AS value
FROM `my_project.analytics_123456789.events_*`;

이벤트 변경 로그 템플릿

### YYYY-MM-DD

Changed:
- Added `activation_complete`

Reason:
- Activation funnel requires a stable value moment after signup.

QA:
- DebugView checked on staging.
- Realtime checked on production.
- BigQuery row confirmed in `events_YYYYMMDD`.

Impact:
- New custom dimensions: `activation_type`, `plan`.
- New key event candidate: `activation_complete`.

관련 문서

이벤트·파라미터 설계

이벤트명, 파라미터, user property, custom dimensions/metrics, GA4 limits를 설계 규칙으로 바꾸기

QA·Debugging·Governance

Realtime, DebugView, Tag Assistant, BigQuery를 이용한 GA4 이벤트 품질 관리

그래프 중심 오케스트레이션

Vercel 엔터프라이즈 AI 플랫폼 · LangGraph 스타일의 graph/state-machine 사고방식을 Vercel의 code-first orchestration으로 매핑하는 방법을 정리합니다.

On this page

이벤트 스펙 템플릿이벤트 사전 템플릿Custom definition registryKey event checklistQA checklistBigQuery staging view 템플릿이벤트 변경 로그 템플릿