본문으로 바로가기
리옵트 핸드북
리옵트 핸드북
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으로 매핑하는 방법을 정리합니다.

QA·Debugging·Governance

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

참고 자료

GA4 고급 애널리틱스 설계 핸드북의 공식 근거 링크 모음

On this page

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