명세를 한 행씩 작성합니다
event_name과 함께 각 필드의 업무 의미, 예시, 자료형, 허용 범위를 적습니다. 같은 필드가 어떤 화면에서는 숫자이고 다른 화면에서는 설명 문장이면 합산과 비교가 어려워집니다. 실제 개인정보를 예시값으로 쓰지 않고 테스트 전용 값을 사용합니다.
표시와 계산을 나눕니다
가정한 예로 견적 화면의 ‘월 120만 원부터’는 금액, 기간, 최소값 여부가 섞인 표현입니다. 분석에서 금액을 비교하려면 어떤 항목을 포함한 숫자인지와 월 기준인지, 확정 계약인지 예상 견적인지 구분해야 합니다. 화면 문구가 바뀔 때마다 분석 분류가 새 값으로 늘어나지 않게 안정적인 코드를 둘 수 있습니다.
허용값과 경계값
선택형 필드는 승인된 코드 목록을 사용하고 임의의 사용자 입력을 그대로 보내지 않습니다. 숫자에는 음수·소수·최댓값·계산 실패를 어떻게 다룰지 정합니다. 값이 수집되지 않은 상태와 업무상 해당 없음은 의미가 다르므로 같은 빈칸으로 합치기 전에 사용 목적을 확인합니다.
검증하는 방법
- 기본 선택과 사용자 변경 후의 이벤트를 확보합니다.
- 실제 전송값의 자료형과 키 이름을 명세와 비교합니다.
- 미선택·0·최댓값 등 경계 시나리오를 시험합니다.
- 보고서에서 필요한 분류와 수치가 해석 가능한지 확인합니다.
브라우저 콘솔에 올바른 객체가 보이는 것과 분석 도구가 그 필드를 수집하고 보고하는 것은 다릅니다. 디버그 수집과 보고서 설정을 구분해 점검하고 등록되지 않은 필드가 즉시 모든 보고서에 나온다고 기대하지 않습니다.
변경을 관리합니다
필드의 의미를 바꿀 때는 기존 이름을 그대로 사용해 과거와 현재를 섞어도 되는지 검토합니다. 원화 금액이던 필드를 할인율로 바꾸는 식의 재사용은 피하고 변경일과 버전을 남깁니다. 완료 기준은 전송 성공만이 아니라 해당 값을 모르는 운영자도 명세를 보고 보고서를 바르게 읽을 수 있는 상태입니다.
자주 묻는 질문
- 화면에 보이는 가격 문자열을 그대로 보내면 안 되나요?
- 표시 문자열에는 통화 기호·쉼표·단위가 포함될 수 있습니다. 분석에 필요한 숫자와 통화 또는 가격 기준을 별도로 정의하고 수집 도구가 기대하는 자료형에 맞추는 편이 좋습니다.
- 값이 없으면 0으로 채우면 되나요?
- 0은 실제 측정값일 수 있습니다. 미선택·미수집·계산 불가를 어떤 방식으로 구분할지 정하고, 누락을 0으로 바꿔 평균이나 합계를 왜곡하지 않도록 합니다.
공식 참고자료와 작성 기준
공식 문서는 도구·검색 기능의 근거이며, 위의 점검 순서와 완료 기준은 현랩의 실무 설계 제안입니다. 예시를 실제 고객의 성과나 검색엔진의 보장으로 해석하지 않습니다.