검증 리포트
GA4 고급 애널리틱스 설계 핸드북의 구조·링크·근거 검증 결과
2026-10-23 공식 근거 재검증
Google 공식 변경내역·BigQuery schema·Measurement Protocol 문서를 대조하고 계산 예제의 경계 조건을 검토했습니다.
| 검증 항목 | 반영 결과 |
|---|---|
| 기능 현행화 | 7~10월 공지와 속성별 제공·MP filter 예외 반영 |
| 코호트 SQL | 가입 이후 이벤트만 선택; 7일 완료 분모; 속성 시간대·스캔 제한 |
| dbt 모델 | 가입 후 유효 activation 집계; 원본 식별자 null 허용 |
| 데이터 처리 | daily 재계산 창·360 completeness·consent raw 차이 |
| SQL 계산 검증 | 본문 SQL을 DuckDB 방언으로 변환해 합성 데이터 10가지 경계 조건 실행·기대값 일치 |
| 실행 경계 | 실제 GA4 속성·BigQuery 작업은 실행하지 않음 |
SQL 검증은 가입 전 활성화, 7일 경계, 중복 이벤트, 한국 시간대, 관측 기간 미완료, null 식별자 등을 포함합니다. 로컬 방언 변환 결과의 계산 검증이며 BigQuery 실행·비용·권한 검증을 대신하지 않습니다.
Google Analytics 변경내역 · BigQuery Export · Export schema · Measurement Protocol 검증.
이전 검증 기록
아래는 이전 검증 당시 기록입니다.
검증 기준일
2026-05-10 KST
검증 범위
| 항목 | 기준 |
|---|---|
| 문서 구조 | meta.json 선언과 실제 MDX 파일 일치 여부 |
| 공식 근거 | Google Analytics Help 중심 근거 사용 |
| 대상 적합성 | 초급 튜토리얼이 아니라 고급 설계·활용 중심인지 |
| 내부 연결 | 기존 brand-marketing 장과 중복/링크 정합성 |
| 앱 검증 | handbook registry, typecheck, build |
근거 매핑
| 핸드북 장 | 주요 공식 근거 |
|---|---|
| 계정·속성·스트림 아키텍처 | Set up Analytics, account structure |
| 데이터 수집 기반 | Enhanced Measurement, cross-domain, data subsets |
| Consent·Privacy·PII 거버넌스 | Consent type, PII best practices, data collection |
| 이벤트 분류 체계 | Recommended events, Custom events |
| 이벤트·파라미터 설계 | Custom dimensions/metrics, configuration/event limits |
| Key events & 퍼널 | Create/modify key events, Report on key events |
| Ecommerce & Revenue | Ecommerce events, Recommended events |
| BigQuery Export 모델링 | BigQuery Export setup/schema |
| QA·Debugging·Governance | Confirm data collection, DebugView |
설계 검증
| 항목 | 결과 | 메모 |
|---|---|---|
| 계정/속성/스트림 구조 | 반영 | legal owner, product boundary, stream, timezone/currency 기준 포함 |
| 이벤트 선택 알고리즘 | 반영 | 자동 수집 → enhanced → recommended → custom 순서 |
| Custom definitions | 반영 | event/user/item scope와 limits 반영 |
| Consent/PII | 반영 | consent type, PII 유입 경로, data redaction, 광고 연동 책임 포함 |
| Key event | 반영 | key event limit과 create/modify event 주의 포함 |
| SaaS 이벤트 사전 | 반영 | acquisition, signup, activation, revenue, retention |
| BigQuery 분석 | 반영 | dataset/table 구조, event_params flatten SQL 포함 |
| QA | 반영 | Realtime, DebugView, Tag Assistant, BigQuery 체크 |
검증 한계
- 실제 GA4 property를 생성하거나 실측 데이터를 연결하지 않았습니다.
- 공식 문서 UI 명칭은 Google Analytics 제품 업데이트에 따라 바뀔 수 있습니다.
- 법률·개인정보보호 판단은 일반 설계 주의사항이며, 법률 자문을 대체하지 않습니다.
실행 검증 기록
| 날짜 | 명령 | 결과 |
|---|---|---|
| 2026-05-10 | yarn workspace handbook check:books-registry | 통과 |
| 2026-05-10 | yarn workspace handbook check:ga4-advanced-analytics | 통과 |
| 2026-05-10 | yarn workspace handbook lint | 통과 |
| 2026-05-10 | yarn workspace handbook typecheck | 통과 |
| 2026-05-10 | yarn workspace handbook build | 통과 |
| 2026-05-10 | yarn workspace handbook check:dates | 새 GA4 핸드북은 신규 파일이라 SKIP — no git history; 기존 다른 핸드북 21개 날짜 경고로 전체 exit code 1 |