zenn/sori.studio
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

통계 기간 지표 원장 기준 보정

Browse Source
This commit is contained in:
zenn
2026-07-29 14:57:51 +09:00
parent 4e7e12d8fe
commit 378afbe79c
8 changed files with 184 additions and 19 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
docs/history.md
View File

@@ -1,3 +1,7 @@
## 2026-07-29 v1.12.5 — 관리자 기간 지표는 원장 우선으로 보정한다
콘텐츠 세션 원장은 같은 글이나 페이지를 보는 한 번의 진입을 하나의 상세 기록으로 보존하므로, 평균 체류시간과 스크롤 도달률처럼 중복 이벤트에 민감한 지표를 더 안정적으로 계산할 수 있다. 다만 원장 행은 방문자 해시와 함께 32일만 보관하므로, 전체 누적이나 오래된 기간까지 원장만으로 다시 계산하면 과거 데이터가 빠진 것처럼 보일 수 있다. 따라서 관리자 요약과 게시물·페이지 상세의 최근 기간 지표는 원장 데이터가 보관 범위 안에 있을 때만 우선 사용하고, 그 밖의 범위는 기존 일별 누적 집계를 그대로 사용한다.
## 2026-07-29 v1.12.4 — 통계 집계 기준을 콘텐츠 세션 원장으로 분리한다
기존 통계 수집은 탭 단위 실시간 세션을 현재 접속자 표시와 체류·스크롤 증분 계산에 함께 사용했다. 이 구조에서는 같은 탭에서 여러 게시물이나 페이지를 이동할 때 이전 콘텐츠의 체류시간과 스크롤 비율이 다음 콘텐츠 집계에 영향을 줄 수 있다. 따라서 클라이언트는 탭 세션과 별도로 라우트 진입 단위 `contentSessionId`를 보내고, 서버는 원문 ID 대신 해시된 `analytics_content_sessions` 원장을 기준으로 pageview/read 중복과 heartbeat 증분을 판단한다. `analytics_active_sessions`는 현재 접속자 표시용으로 남겨 실시간 UI 책임과 콘텐츠 분석 책임을 분리한다.