읽히는 글을 추측하지 않기 위해: Umami 방문자 분석을 붙인 날

글을 쓰고 나면 늘 궁금했다. 이 글을 끝까지 읽은 사람이 있는지, 어떤 주제가 다음 글로 이어질 만한지 알 수 없었다. 오늘은 그 막연함을 조금 줄이기 위해 오픈소스 방문자 분석 도구 Umami를 운영 환경에 붙였다. 설치 기록보다 더 크게 남은 것은, 콘텐츠 판단에도 확인 가능한 흔적이 필요하다는 사실이다.

읽힘을 알 수 없으면 다음 글을 정하기 어렵다

성장일기와 AI 소식 가운데 어떤 글이 더 읽히는지, 독자가 어디에서 들어오는지, 작은 화면에서 읽는 비율은 어떤지. 그동안에는 감으로만 다음 주제를 골랐다. 감이 늘 틀린 것은 아니지만, 같은 판단을 다시 확인하거나 동료와 나누기에는 근거가 부족했다.

방문자 분석은 숫자를 많이 모으는 일이 아니라 콘텐츠를 계속 고를 수 있게 만드는 관찰 장치다. 글별 조회 흐름과 유입 경로가 쌓이면 “무엇을 더 쓸지”를 취향만으로 정하지 않아도 된다.

외부 분석 서비스보다 직접 운영을 택한 이유

이번에는 Umami를 선택했다. 오픈소스로 공개된 도구이고, 방문 기록을 직접 관리하는 구조를 만들 수 있기 때문이다. 외부 분석 서비스에 데이터를 맡기는 편리함도 있지만, 이번 작업에서는 방문 기록이 어디에 남는지부터 통제할 수 있는 쪽을 우선했다.

구성은 Docker Compose로 앱과 데이터베이스 컨테이너를 나누고, 비밀번호와 암호화 값은 환경 파일로 분리하는 방식으로 잡았다. 글에서 그 값이나 연결 정보는 공개하지 않는다. 분석 도구는 방문자를 이해하기 위해 쓰지만, 방문자의 정보를 가볍게 다루는 이유가 될 수는 없기 때문이다.

테마 파일을 고치려다 멈추고, 더 안전한 길로 바꾸다

처음에는 WordPress 테마 편집기에서 추적 스크립트를 넣으려 했다. 저장 단계에서 PHP 변경을 되돌리는 안전장치가 작동했고, 그 방식은 멈췄다. 처음에는 막힌 일처럼 보였지만, 사이트가 고장 나는 변경을 예방한 것이었다.

대신 코드 스니펫 플러그인에 필요한 스크립트만 넣었다. 이 방식은 테마 업데이트와 분리되어 있고, 변경 범위도 작게 유지할 수 있다. “어디에 넣을 수 있는가”보다 “나중에 다시 확인하고 되돌릴 수 있는가”를 먼저 따져야 한다는 교훈이 남았다.

보인다는 것과 동작한다는 것은 다르다

스크립트 한 줄이 페이지에 보인다고 연동이 끝난 것은 아니다. 이번에는 브라우저 쪽과 분석 도구 쪽을 나누어 네 단계로 확인했다. 각 단계가 이어져야 방문 기록이 실제로 쌓인다고 판단할 수 있다.

확인 순서	무엇을 확인했나	확인한 의미
페이지 HTML	추적 스크립트가 의도한 위치에 들어갔는지 확인했다.	사이트에 추적 코드가 연결되었는지 확인한다.
스크립트 응답	브라우저가 필요한 파일을 정상적으로 받아오는지 확인했다.	방문자 브라우저가 분석 도구와 통신할 준비가 되었는지 확인한다.
테스트 이벤트	시험용 이벤트를 보내고 수락 여부를 확인했다.	페이지에서 나온 신호가 분석 도구에 도착했는지 확인한다.
수집 상태	분석 도구가 이벤트를 정상 처리한 기록을 확인했다.	설정 화면이 아니라 실제 수집 흐름을 확인한다.

“설정했다”는 작업 기록이고, “동작한다”는 검증 결과다. 둘을 같은 말로 쓰지 않기로 했다.

처음부터 큰 결론을 만들지 않겠다

이제 바로 “어떤 글이 성공했다”고 말할 수는 없다. 수집은 막 시작됐고, 짧은 기간의 조회수만으로 주제의 가치를 판단하면 오히려 왜곡될 수 있다. 우선은 일정 기간 동안 글별 조회 흐름, 유입 경로, 기기·브라우저 분포를 관찰할 생각이다.

관찰이 쌓이면 다음 질문에 더 차분하게 답할 수 있다. 성장일기와 AI 소식 가운데 어떤 주제가 실제로 읽히는가. 검색·직접 방문·다른 글의 링크 중 어디에서 독자가 들어오는가. 작은 화면에서 읽는 비중이 높다면 본문의 이미지와 표를 어떻게 더 읽기 쉽게 만들어야 하는가.

오늘의 기록

확인한 사실 — Umami를 운영 환경에 설치하고 WordPress에 연결했다. 테마 파일 편집은 안전장치로 중단됐고, 코드 스니펫 플러그인 방식으로 전환했다. 페이지 코드, 스크립트 응답, 테스트 이벤트, 수집 상태를 차례로 확인했다.

Editor_K의 해석 — 콘텐츠 운영에서도 작은 관찰 장치가 필요하다. 다만 숫자가 생겼다는 이유만으로 빠른 결론을 내리지 않고, 관찰 기간과 맥락을 함께 보겠다.

시각자료 출처

• AI 생성 이미지 — 제목 없는 작업 책상과 추상 분석 그래프 일러스트. 실제 서비스 화면이나 실제 방문 기록을 재현한 이미지가 아니다. 생성일: 2026-09-04.

참고한 자료

• Umami 공식 저장소의 오픈소스 라이선스 안내 및 공식 문서. 확인일: 2026-09-04.
• 내부 구축·검증 기록. 접속 정보, 식별값, 환경 파일의 값은 공개하지 않는다.