QA·Debugging·Governance

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

이벤트 설계는 배포 후에 깨집니다. UI 변경, GTM 버전, route 변경, checkout provider 변경, consent banner 변경이 이벤트 발화를 바꾸기 때문입니다.

QA 표면

도구	확인할 것
Realtime report	이벤트가 실제 property에 들어오는지
DebugView	특정 device/browser에서 이벤트와 parameter가 의도대로 발화하는지
Tag Assistant / GTM Preview	tag trigger, dataLayer, consent state
Events report	처리 후 이벤트 수와 추세
BigQuery Export	원시 row, params, 중복 여부

Google 공식 문서는 많은 reports와 explorations가 처리에 24~48시간 걸릴 수 있고, 수집 확인에는 Realtime과 DebugView를 사용할 수 있다고 안내합니다.

항목	통과 기준
Measurement ID	prod/staging ID 혼동 없음
중복 발화	같은 사용자 행동에 이벤트 1회
필수 파라미터	required parameters가 모두 존재
값 형식	snake_case, enum 값, numeric type 일치
PII	URL, title, search term, form field, parameter에 PII 없음
Consent	동의 상태별 수집 동작 확인
Cross-domain	checkout/auth 이동 후 session 단절 없음
Internal traffic	사내/QA 트래픽 처리 기준 확인
BigQuery	다음 export에서 raw row 확인 가능

상황	확인
새 이벤트 추가	event name, timestamp, required parameters
key event 후보	중복 발화와 trigger 조건
GTM 변경	trigger firing condition과 tag sequence
SPA routing	route change마다 `page_view` 중복/누락
form tracking	PII가 parameter로 들어가지 않는지

증상	원인 후보	대응
이벤트가 안 보임	tag 미설치, consent denied, trigger 조건 오류	Tag Assistant, DebugView
파라미터가 비어 있음	dataLayer key 불일치	GTM 변수와 spec 비교
key event가 과다	중복 발화, page reload, retry	idempotency 또는 trigger 조건 보정
보고서에 dimension 없음	custom definition 미등록 또는 처리 지연	등록 후 24~48시간 관찰
BigQuery row 없음	export 지연, event exclusion, table suffix 오류	export 설정과 raw table 확인

원칙	설명
Event owner	이벤트마다 제품/데이터 owner를 둠
Registry first	구현 전에 이벤트 사전을 수정
Backward compatible	기존 보고서를 깨는 변경은 새 event/parameter로 migration
Low cardinality UI	GA4 UI용 dimension은 값 집합을 관리
Raw data audit	BigQuery로 원시 이벤트 표본을 정기 검수