문서

시작하기

comcom analytics는 Discord 서버의 메시지·리액션·음성·멤버 활동을 자동으로 집계하여 커뮤니티의 성장과 참여도를 시각화하는 무료 분석 대시보드입니다. 도입은 3단계로 완료됩니다.

analytics.comcom.app에 접속하여 Discord로 로그인합니다.
“서버 관리” 권한이 있는 서버에 봇을 추가합니다.
도입 시점부터 자동으로 집계가 시작되어 대시보드에 반영됩니다.

데이터는 도입 시점 이후의 것만 집계됩니다. 과거로 소급하여 가져올 수는 없으므로 가능한 한 빨리 도입하는 것을 권장합니다.

커스터마이즈

봇 데이터 제외

다른 봇의 발언을 노이즈로 제외할 수 있습니다. 설정 화면에서 봇 메시지를 집계 대상에서 제외하면 사람 멤버의 활동만 볼 수 있습니다.

채널 필터링

분석 대상 텍스트/음성 채널을 선택할 수 있습니다. 운영용 채널이나 로그 채널을 제외하면 커뮤니티의 실제 활동에 가까운 수치를 얻을 수 있습니다.

뷰어(viewer) 관리

대시보드를 공유할 멤버를 지정할 수 있습니다. 관리자가 아닌 운영 멤버에게도 읽기 전용 권한을 부여할 수 있습니다.

대시보드 보는 법

왼쪽 내비게이션에서 커뮤니티의 다양한 측면을 확인할 수 있습니다. 각 페이지의 스크린샷을 곁들인 자세한 설명은 /product를 참고하세요.

페이지	내용
요약	전체 트렌드·주간 AI 요약·멤버 구성을 한눈에 표시.
채널	텍스트/음성 채널별 랭킹과 추이.
역할	역할별 멤버 수·활동량.
멤버	멤버 개별 활동 이력·카드 표시.
비교	같은 카테고리의 서버들 중에서 멤버 수와 활동량이 어느 위치인지 익명 상대 지표로 확인(카테고리 태그 설정 필요).
유입	신규 참여·탈퇴 추이와 초대 링크별 유입 랭킹.
통계	메시지·리액션·음성의 시계열과 채널 산점도.
활동 로그	리액션·음성의 개별 로그를 검색·열람.

여러 서버를 운영하는 경우, 요약·채널·역할·멤버 각 페이지의 오른쪽 위에서 2개 이상의 서버를 한꺼번에 표시할 수 있습니다(관리자이면서 모든 서버가 Pro 플랜인 경우에만).

Discord 명령어

모든 기능은 Discord의 /comcom 명령어(하위 명령어)로 사용할 수 있습니다. 일부 하위 명령어는 제공 환경에 따라 다를 수 있습니다.

명령어	내용
/comcom member <user>	멤버 분석 카드. 애니메이션 LV/EXP HUD ⇄ 상세 대시보드 전환.
/comcom channels	서버 개요 대시보드 ⇄ 채널 랭킹(메시지순/음성순).
/comcom leaderboard	서버 EXP 리더보드 + 내 순위.
/comcom heatmap	활동 히트맵(요일×시간대, 메시지+음성).
/comcom room	도트 그래픽 “방” GIF + 버튼 내비게이션.
/comcom poll	커뮤니티 투표 생성(질문/선택지/기간/복수 선택).
/comcom help	전체 명령어 목록 표시.
/comcom slot	멤버 1명을 무작위로 뽑는 GIF 연출(상품 없음).

EXP / 레벨 / 랭크 구조

EXP는 기록된 활동에서 계산되는 누적값으로, 항상 증가하기만 합니다(줄어들지 않습니다).

dailyEXP = min(messages,100)·1 + max(0,messages-100)·0.25   // soft cap
         + min(voiceMinutes,240)·0.5                     // 4h/day cap
         + reactionsGiven·0.5 + reactionsReceived·1 + mentionsReceived·1

EXP   = Σ dailyEXP  (all recorded days, only grows)
Level = floor( sqrt(EXP / 50) )

레벨에 따른 칭호: Newcomer(0–4) → Regular(5–11) → Active(12–21) → Veteran(22–34) → Elite(35–49) → Legend(50+). 전체 기간의 EXP·레벨·랭크는 매일 밤 배치로 갱신됩니다.

가이드라인

운영 팁

음성 활동은 도입 후부터 누적됩니다. 전체 기간 랭크는 배치 갱신 후에 표시됩니다.
메시지·음성·리액션을 종합적으로 보면 발언은 적어도 기여하고 있는 멤버가 보입니다.
히트맵으로 활발한 시간대를 파악해 이벤트나 공지 타이밍을 최적화할 수 있습니다.

프라이버시

멤버 카드는 본인이 자신을 볼 때, 또는 “서버 관리” 권한이 있는 관리자만 실행할 수 있습니다. 버튼 조작은 실행한 본인으로 한정됩니다. 이메일 주소 등 개인정보(PII)는 대시보드에도 API/MCP에도 일절 노출되지 않습니다.

데이터 해석

수치는 도입 이후의 실제 데이터를 기반으로 합니다. 전체 기간 EXP·순위·전체 기간 음성은 야간 집계(precompute)로 갱신되므로, 도입 직후에는 일부가 “집계 대기”로 표시될 수 있습니다.

자주 묻는 질문

무료로 사용할 수 있나요?

네. 기본 대시보드와 명령어는 완전 무료입니다. 유료 플랜(Pro)에서는 서버 규모에 따른 요금으로 API/MCP 액세스 등의 추가 기능을 이용할 수 있습니다.

과거 데이터를 가져올 수 있나요?

아니요. 집계는 봇 도입 시점부터 시작됩니다. 과거로 소급하여 가져올 수는 없습니다.

명령어가 표시되지 않습니다.

글로벌 명령어가 반영되기까지 몇 분 걸릴 수 있습니다. Discord를 Ctrl/Cmd+R로 새로고침하면 캐시가 지워집니다.

봇을 제거하면 데이터는 어떻게 되나요?

봇을 제거하면 대시보드 접근이 중지됩니다. 다시 도입하면 제거했던 기간의 데이터는 기록되지 않은 채, 그 시점부터 집계가 재개됩니다.

여러 서버 비교나 다른 서버와의 벤치마크가 가능한가요?

가능합니다. 직접 운영하는 여러 서버는 요약 등 페이지 오른쪽 위에서 함께 표시할 수 있고(관리자·모든 서버 Pro 한정), 다른 서버와의 비교는 카테고리 태그를 설정하면 “비교” 페이지에서 익명 상대 지표로 확인할 수 있습니다. 개별 서버 이름이나 멤버 정보가 다른 운영자에게 공개되는 일은 없습니다.

문제 해결

도입 직후 데이터가 비어 있거나 적다

집계는 봇 도입 시점부터 시작되므로 도입 직후 표시할 데이터가 적은 것은 정상입니다. 며칠에서 1주일 정도 평소 활동이 쌓이면 수치가 안정됩니다.

음성 수치만 다른 지표보다 늦게 보인다

음성 관련 집계 일부는 야간 배치로 처리되므로, 메시지·리액션에 비해 반영까지 최대 며칠의 시차가 생길 수 있습니다. 시간이 지나면 자동으로 따라잡습니다.

멤버 카드가 실행되지 않거나 버튼이 반응하지 않는다

멤버 카드는 본인이 자신의 카드를 볼 때, 또는 “서버 관리” 권한이 있는 관리자만 실행할 수 있습니다. 버튼 조작도 명령어를 실행한 본인으로 한정되므로, 다른 멤버가 눌러도 반응하지 않습니다.

권한 부족 오류가 발생한다

봇 도입·설정 변경에는 Discord 서버 측의 “서버 관리” 권한이 필요합니다. 권한을 확인해도 해결되지 않으면 대시보드를 한 번 새로고침하여 캐시된 권한 정보를 갱신하세요.