[🛠] 블로그 통계 대시보드 오염 정리하기

✨ GPT-5.5의 요약 　

공개 통계 페이지에서 방문과 조회수를 섞어 보이던 문제를 바로잡고, 30분 세션 기준 방문 수와 페이지 열림 기준 조회수를 분리해 모바일에서도 읽히는 대시보드로 고친 기록.

공개 블로그 통계 페이지를 만들고 나서 바로 찝찝한 부분이 보였다.

숫자는 나오고 있었다.

그런데 숫자의 이름이 너무 쉽게 섞였다.

방문자, 방문, 조회수, 세션, page view. 블로그 화면에서는 비슷해 보이는 말이다. 하지만 실제 집계에서는 전부 다르다. 특히 공개 카운터에서 이걸 흐리게 써버리면, 숫자가 있어도 믿기 어렵다.

처음에는 “오늘 조회수”, “이번 달 조회수”, “전체 조회수”처럼 단순하게 가도 될 것 같았다. 그런데 사이드바에서 보여주고 싶은 값은 사실 글이 몇 번 열렸는지가 아니라, 오늘 블로그에 몇 번 방문이 있었는지에 가까웠다.

그래서 구조를 다시 나눴다.

방문
-> 30분 비활동 기준 세션

조회수
-> 페이지나 글이 열린 횟수

4943은 방문 수가 아니었다

가장 먼저 고쳐야 했던 건 baseline의 의미였다.

기존 Google Analytics에서 가져온 4943 같은 값은 screenPageViews였다. 말 그대로 페이지 조회수다. 이걸 전체 방문자 수나 전체 방문 수처럼 보여주면 틀린 숫자가 된다.

그래서 Worker와 문서를 같이 정리했다.

totalPageViews
-> GA screenPageViews baseline + D1 page views

totalSessions
-> GA sessions baseline + D1 sessions

방문과 조회수를 같은 baseline에 얹으면 안 된다. 그래서 세션 baseline을 별도로 seed하는 route도 추가했다.

/admin/seed-session-baseline

GitHub Actions의 Worker 배포 흐름에도 세션 baseline seed 단계를 넣었다. Worker 코드만 배포되고 baseline이 비어 있으면 공개 화면의 전체 방문 수가 이상하게 보일 수 있기 때문이다.

/track 응답을 바로 쓰게 했다

처음 구조는 조금 돌아갔다.

클라이언트가 /track으로 카운트를 올리고, 다시 /analytics를 읽어서 화면을 채우는 느낌이었다. 이러면 방금 방문한 값이 바로 화면에 반영되지 않을 수 있다. 캐시와 순서 때문에 사용자는 “방금 들어왔는데 왜 오늘 방문이 그대로지?”라고 볼 수 있다.

그래서 /track 응답이 최신 analytics payload를 같이 돌려주게 했다.

흐름은 이렇게 바뀌었다.

페이지 로드
-> POST /track
-> Worker가 세션/조회수 반영
-> 같은 응답에 최신 analytics 포함
-> 클라이언트가 그 payload로 사이드바와 현재 글 조회수 렌더링

이후 주기적 refresh는 그대로 /analytics를 읽는다.

즉 첫 화면에서는 방금 반영된 값을 우선 쓰고, 그 뒤에는 읽기 API로 최신 상태를 따라간다.

세션은 페이지 이동마다 늘어나면 안 된다

조회수는 글을 이동할 때마다 늘 수 있다.

하지만 방문은 다르다. 같은 사람이 블로그 안에서 글을 세 개 읽었다고 방문이 세 번이면 이상하다. 그래서 Worker에 sessions 테이블을 추가하고, visitor hash의 마지막 활동 시간을 기준으로 세션을 이어 붙였다.

기준은 30분이다.

마지막 활동 이후 30분 이내
-> 같은 세션

30분 초과
-> 새 세션

이 기준 덕분에 사이드바의 오늘/이번 달/전체 방문 수는 page view보다 덜 흔들린다. 반대로 글별 조회수는 여전히 page path 기준으로 올라간다.

다국어 페이지도 같은 원칙을 따른다.

/daily-review/.../와 /en/daily-review/.../는 같은 글의 다른 언어판이다. 조회수 key는 canonical path로 맞추고, 같은 세션 안에서 언어를 바꿨다고 방문 수가 또 늘어나지 않게 했다.

대시보드는 표처럼 다시 짰다

처음 통계 페이지는 KPI 카드와 막대 리스트 중심이었다.

나쁘지는 않았지만, 방문과 조회수를 같이 보여주기 시작하니 구조가 애매해졌다. 카드가 늘어나면 모바일에서 길어지고, 어떤 숫자가 어느 기간의 방문인지 조회수인지 한눈에 안 들어왔다.

그래서 상단 비교 영역을 표에 가깝게 바꿨다.

기간        방문        조회수
선택 기간   n           n
오늘        n           n
이번 달     n           n
전체        n           n

여기서도 전체는 두 줄로 나눴다.

전체
-> 2026/06/09 이후 직접 집계

전체
-> 2026/06/09 이전 통계 포함

이 둘은 의미가 다르다.

직접 집계는 D1에 공개 가능한 차원까지 쌓이기 시작한 이후의 값이다. 이전 통계 포함 값은 GA baseline을 더한 공개 총합이다. 이걸 한 줄에 섞으면 전체 숫자가 커 보이기는 하지만, 세부 차원과 맞지 않는다.

그래서 대시보드 문구도 분리했다.

방문: 30분 내 재방문 제외. 조회수: 페이지 열림 횟수.
직접 집계는 2026/06/09부터.

직접 기간 입력을 더 편하게 했다

통계 페이지에서는 날짜를 자주 바꾼다.

처음에는 range=today, range=month, range=total, range=custom 버튼만 있으면 된다고 봤다. 그런데 직접 기간을 보려면 시작일과 종료일을 계속 고쳐야 한다.

그래서 입력을 조금 더 도구답게 만들었다.

YYYY/MM/DD 표시
숨겨진 date picker 연결
연/월/일 segment 선택
ArrowUp / ArrowDown으로 날짜 조정
마우스 wheel로 날짜 조정
시작일과 종료일 범위 clamp

겉보기에는 작은 입력 두 개지만, 날짜를 바꾸는 동작이 훨씬 덜 답답해졌다.

그리고 직접 기간을 누를 때만 custom 영역을 보이는 방식은 버렸다. 날짜 입력은 항상 보이게 두고, preset 버튼을 누르면 날짜가 그 preset에 맞게 바뀌게 했다.

이 편이 더 예측 가능했다.

상세 차원은 탭으로 나눴다

상세 차원도 한 화면에 전부 펼치면 지저분했다.

페이지, 방문자 환경, 유입, 지역/언어를 모두 보여주면 정보는 많지만 읽기 어렵다. 그래서 탭으로 묶었다.

페이지
방문자 환경
유입
지역/언어

페이지 목록에서는 path가 길어질 수 있다. 그래서 label에 title을 넣고, 화면에서는 줄바꿈과 말줄임이 깨지지 않게 스타일을 조정했다. 페이지 dimension 값이 /로 시작하면 링크로 만들었다.

목표는 장식적인 dashboard가 아니었다.

내가 폰으로 들어가도 지금 어떤 글이 읽혔는지, 오늘 방문이 몇인지, 조회수가 얼마나 되는지 바로 볼 수 있으면 됐다.

다국어 라벨도 같이 맞췄다

통계 페이지는 한국어만 있는 페이지가 아니다.

/en/analytics/, /ja/analytics/, /zh-Hans/analytics/ 같은 active locale 페이지도 같이 있다. 그래서 “방문”, “조회수”, “30분 세션”, “GA 조회수 + D1” 같은 라벨을 각 locale front matter에 맞춰 넣었다.

이 작업을 빼먹으면 구조는 맞아도 다른 언어 페이지에서 예전 문구가 남는다.

다국어 블로그에서는 기능 하나를 고칠 때 페이지 하나만 고치는 게 아니다. 같은 화면이 여러 locale에 걸쳐 있으니, 라벨의 의미도 같이 움직여야 한다.

세션 방문과 페이지 조회수 의미를 다시 확인했다

렌더링과 값의 의미를 기준으로 봤다.

node --check cloudflare/ga-stats-worker.js
node --check assets/js/custom/analytics-dashboard.js
node --check assets/js/custom/visitor-stats.js
bundle exec jekyll build
Cloudflare Worker deploy
GitHub Pages deploy

확인한 기준은 이랬다.

사이드바는 sessions를 방문으로 보여주는가
글별 조회수는 page view를 유지하는가
전체 방문과 전체 조회수가 서로 다른 baseline을 쓰는가
직접 집계 전체와 GA 포함 전체가 구분되는가
직접 기간 입력이 today/month/total preset과 충돌하지 않는가
모바일에서 기간/방문/조회수 표가 가로로 터지지 않는가

이 작업 뒤 통계 페이지는 더 조용해졌다.

숫자는 더 많아졌지만, 오히려 덜 헷갈린다. 방문은 방문이고 조회수는 조회수다. 전체는 전체지만, 직접 집계 전체와 과거 포함 전체는 다르다.

통계 페이지에서 중요한 건 숫자를 크게 보이게 만드는 게 아니었다.

각 숫자가 무슨 뜻인지 숨기지 않는 쪽이었다.