채널을 전문가처럼 분석하세요

다운로드 & 설치

주요 플랫폼용 사전 빌드된 바이너리. 설치나 종속성이 없습니다.

텔레그램 API 자격 증명

모든 텔레그램 클라이언트에는 공식 개발자 포털에서 발급받은 api_id와 api_hash가 필요합니다. 무료이며 3분이면 됩니다.

인증

두 가지 로그인 방법 — 더 편리한 것을 선택하세요.

전화 로그인 (SMS / 앱 내 코드)

QR 코드 로그인 (권장)

추적할 채널 추가

두 가지 유형의 채널: 자체 채널(관리자 권한) 및 @username으로 모든 공개 채널.

자체 채널

채널 섹션을 엽니다. 관리자 채널은 오른쪽에 자동으로 나타납니다 — 앱이 텔레그램 대화에서 가져옵니다.

모든 공개 채널 (경쟁사 조사)

킬러 기능 — @username, t.me/... 링크 또는 숫자 ID로 모든 공개 채널을 추적합니다.

모든 지표 설명

각 숫자의 의미, 계산 방법, "좋은" 값이 어떻게 보이는지.

이 숫자를 해석하는 방법

• ER 상승 + 구독자 증가 — 올바른 길에 있습니다. 하던 일을 계속하세요.
• ER 하락 + 구독자 증가 — 참여도가 낮은 사람들(아마 광고에서)을 유치하고 있습니다. 콘텐츠를 조정해야 할 수 있습니다.
• ER 상승 + 구독자 정체 — 콘텐츠는 공명하지만 배포가 안 됩니다. 교차 프로모션을 고려하세요.
• ER 하락 + 구독자 감소 — 뭔가 잘못되었습니다. 인기 게시물과 최근 게시물을 비교하고 무엇이 바뀌었는지 찾으세요.

구독자 성장 차트

성장 차트를 읽는 방법, 최근 데이터만 표시되는 이유, 무엇을 찾아야 하는지.

차트가 만들어지는 방법

TG Analytics가 데이터를 수집할 때마다 현재 구독자 수의 "스냅샷"을 저장합니다. 차트는 해당 스냅샷의 타임라인입니다. 세분화는 자동으로 조정됩니다:

• 최근 데이터 (시간): 모든 측정이 하나의 포인트입니다 — 세부 사항을 볼 수 있습니다.
• 일: 시간별로 집계 — 시간당 하나의 포인트.
• 주 및 월: 일별로 집계 — 하루에 하나의 포인트.

무엇을 찾아야 하나요

• 꾸준한 상승 기울기 — 건강한 성장. 기울기 각도를 추적하여 기간을 비교하세요.
• 급격한 스파이크 — 보통 바이럴 게시물, 언급 또는 광고로 인해 발생합니다. 인기 게시물 목록의 게시 날짜와 연관시키세요.
• 정체기 — 콘텐츠가 최근에 공유되지 않았거나 채널이 자연적 평형 상태에 있습니다.
• 급격한 하락 — 구독자 정리, 사람들을 소외시킨 게시물 또는 큰 채널이 언급을 삭제했습니다.

기간 비교

7일 / 30일 / 90일 / 전체 기간 탭을 전환하여 동일한 채널을 다양한 확대/축소 수준에서 확인하세요:

• 7일 — 주간 결정용: "내 마지막 캠페인이 실제로 효과가 있었나?"
• 30일 — 기본값. 노이즈와 신호 사이의 좋은 균형.
• 90일 — 분기별 트렌드, 계절성.
• 전체 기간 — 추적을 시작한 이후의 전체 기록.

최적 게시 시간 (히트맵)

자체 채널을 기반으로 요일과 시간별 평균 조회수를 보여주는 7×24 그리드.

히트맵 읽는 방법

각 셀은 요일 × 시간 조합을 나타냅니다. 색상 강도는 해당 창에서 게시된 게시물의 평균 조회수입니다. 진한 파란색 = 높은 조회수, 연한 파란색 = 낮은 조회수, 흰색 = 해당 슬롯에 게시된 게시물이 아직 없음.

대부분의 채널이 발견하는 것

• 아침 슬롯 (8:00–10:00) — 출근길에 텔레그램을 확인하는 통근자. 짧고 강렬한 콘텐츠에 적합.
• 점심 시간 (12:00–14:00) — 중간 정도의 참여, 가장 넓은 오디언스.
• 저녁 슬롯 (18:00–21:00) — 대부분의 채널에서 최고 참여. 긴 글과 비디오가 여기서 가장 잘 작동합니다.
• 주말 — 완전히 다른 패턴. 토요일 아침과 일요일 저녁이 종종 높은 성과를 보입니다.

실제로 히트맵 사용하기

1. "최적 시간" 라벨을 확인하세요 — 그것이 최고 슬롯입니다.
2. 상위 3~4개의 가장 어두운 셀을 보세요. 그것이 신뢰할 수 있는 창입니다.
3. 가장 중요한 게시물(공지, 출시, 장문)을 해당 슬롯에 예약하세요.
4. 매달 히트맵을 다시 확인하세요 — 오디언스 습관은 계절에 따라 변합니다.

인기 게시물 & 콘텐츠 구성

성공 요인에서 배우세요 — 어떤 게시물이 가장 공명했고 어떤 형식이 가장 잘 작동하는지.

인기 게시물

선택한 기간의 상위 10개 게시물, 조회수 순위. 각 행은 다음을 보여줍니다:

• 순위 — 1이 가장 많이 본 게시물
• 날짜 — 게시된 시기
• 조회수 — 게시물이 본 총 횟수
• 반응 — 이모지 반응 수
• 공유 — 공유된 횟수
• 텍스트 미리보기 — 처음 ~130자

콘텐츠 구성

각 유형의 게시물 수와 유형별 통계를 보여주는 도넛 차트:

• 수 — 이 유형의 게시물 수
• 평균 조회수 — 이 유형의 게시물당 평균 조회수
• ER — 이 유형의 참여율

색상: 텍스트는 파란색, 사진은 보라색, 비디오는 분홍색, 문서는 주황색, 투표는 녹색.

채널 비교

최대 6개의 채널을 나란히 — 포트폴리오 또는 경쟁사 대비.

유용한 경우

• 여러 채널을 운영 — 어느 채널에 더 많은 노력을 기울여야 하는지 확인하세요.
• 경쟁사 벤치마킹 — 2~3개의 직접 경쟁사를 추적하고 어떻게 비교되는지 확인하세요.
• 카테고리 분석 — 니치에 진입할 생각이라면 3~4개의 확립된 채널을 비교하여 벤치마크를 이해하세요.
• 고객 보고 — 고객을 위해 채널을 관리하는 경우 한 화면에서 모두 보여줍니다.

사용 방법

내보내기 & 보고서

세 가지 형식 — 고객용, 추가 분석용 또는 백업용.

PDF 보고서

고객, 관리자 또는 이해관계자에게 보내도록 설계된 세련된 A4 보고서. 포함:

• 채널 이름, @username, 기간 및 생성 날짜가 포함된 헤더
• 4개의 KPI 카드: 구독자, 평균 조회수, ER, 게시물 수
• 적절한 축 서식이 있는 구독자 성장 차트
• 콘텐츠 구성 막대 차트
• 최적 게시 시간 히트맵
• 조회수, 반응, 공유, 텍스트 미리보기가 포함된 상위 10개 게시물 테이블

차트는 PDF 내부에 기본으로 렌더링됩니다(matplotlib 사용) — 이미지가 아니므로 텍스트와 숫자가 어떤 확대/축소에서도 선명하게 유지됩니다.

JSON 덤프

집계된 대시보드와 원시 데이터를 포함한 완전한 구조화 내보내기:

• 채널 메타데이터 (id, tg_id, username, title)
• 모든 계산된 지표가 포함된 Stats 객체
• growth_series — 모든 구독자 스냅샷
• snapshots — 원시 타임스탬프 + 구독자 쌍
• posts — 전체 텍스트, 조회수, 반응, 공유, media_type이 포함된 모든 게시물
• heatmap — 7×24 매트릭스
• top_posts, content_mix

Python, Excel 또는 모든 BI 도구에서 추가 분석에 완벽합니다.

CSV 내보내기

스프레드시트 분석용 게시물의 플랫 테이블:

• 열: channel, date, msg_id, views, reactions, forwards, media_type, text
• UTF-8 BOM 인코딩 (Excel에서 올바르게 열림)
• 세미콜론 ; 구분 기호 (대부분의 로케일에서 Excel 친화적)

자동 수집

데이터를 얼마나 자주 가져오는지, 필요에 맞게 구성하는 방법.

작동 방식

백그라운드 스레드가 일정에 따라 깨어나 모든 추적 채널을 업데이트합니다 — 한 번에 하나씩, 텔레그램의 플러드 보호를 트리거하지 않도록 채널 간 3초 일시 중지.

• 현재 구독자 수 가져오기 → 새 스냅샷
• 마지막 50개 게시물의 조회수 / 반응 / 공유 업데이트
• 마지막 실행 이후 새 게시물이 있으면 가져오기
• 보존 설정에 따라 하루에 한 번 오래된 데이터 제거

간격 선택

• 15분 — 적극적으로 성장시키는 채널용. 상세한 기록, 더 많은 API 호출.
• 30분 — 권장 기본값. 좋은 균형.
• 1시간 — 많은 채널을 모니터링하기 위한 경량.
• 2~6시간 — 경쟁 채널의 장기 관찰용.
• 수동만 — 자동으로 아무 일도 일어나지 않습니다. 신선한 데이터가 필요할 때 "지금 수집"을 클릭하세요.

구성 위치

설정 & 테마

언어, 모양, 보존, 내보내기 폴더, 로그 — 모두 구성 가능합니다.

언어

인터페이스는 영어, 러시아어, 스페인어, 포르투갈어(BR), 독일어의 5개 언어를 지원합니다. 설정 → 언어에서 변경하세요 — UI가 재시작 없이 즉시 업데이트됩니다.

모양

세 가지 모드:

• 시스템 (기본값) — OS 기본 설정을 따릅니다. OS 테마를 변경하면 앱이 실시간으로 업데이트됩니다.
• 다크 — 강제 다크 테마.
• 라이트 — 강제 라이트 테마.

앱 오른쪽 상단의 테마 토글 버튼을 클릭하여 테마를 빠르게 순환할 수도 있습니다.

보존

로컬 데이터베이스에 오래된 스냅샷 및 게시물을 보관하는 기간:

• 30 / 90 / 180일 — 경량 설정용
• 1년 — 권장 기본값
• 영원히 — 아무것도 제거하지 않음 (데이터베이스가 커짐)

백그라운드에서 매일 정리가 실행되고 보존 기간보다 오래된 기록이 삭제됩니다.

내보내기 폴더

PDF / JSON / CSV 파일이 저장되는 위치. 기본값은 ~/.tg_analytics/exports/입니다. 설정 → 폴더 선택을 통해 모든 폴더로 변경하세요.

로그

애플리케이션 로그는 ~/.tg_analytics/logs/에 저장됩니다:

• app.log — 로테이션이 있는 일반 활동 로그 (5MB × 5 파일)
• crash.log — 전체 트레이스백이 포함된 처리되지 않은 예외만

설정에서 "폴더 열기"를 클릭하면 파일 관리자에서 로그 디렉토리가 열립니다. 문제 보고에 유용합니다.

문제 해결

일반적인 문제에 대한 빠른 답변.

프로젝트 지원

TG Analytics는 무료이며 항상 그럴 것입니다. 시간을 절약해 주었다면 도울 수 있는 방법은 다음과 같습니다.