TG Analytics · Толық нұсқаулық

Арнаңызды кәсіби түрде оқыңыз

Әр көрсеткіштің мағынасы, бақылау тақтасын қалай оқу керек және Telegram деректеріңізге сүйене отырып, жақсырақ шешімдер қалай қабылдауға болады. Нақты сандармен және нақты әлемдік эталондармен жазылған.

Бастау
Бақылау тақтасын түсіну
Қосымша
Қосымша

Кіріспе

TG Analytics дегеніміз не, неге жергілікті жұмыс маңызды және осы нұсқаулықта нені үйренесіз.

Жергілікті, дизайн бойынша құпия

Сіз бақылайтынның барлығы компьютеріңіздегі жергілікті SQLite дерекқорында сақталады. Аккаунттар жоқ, серверлер жоқ, телеметрия жоқ. MIT лицензиясы бойынша GitHub-та толық бастапқы код.

TG Analytics — бұл Telegram арналарыңызды нақты, әрекет етуге болатын деректерге айналдыратын тегін десктоп қолданбасы. Ол сіздің арналарыңызбен (сіз әкімші болып табылатын) және кез келген жалпыға қолжетімді арнамен жұмыс істейді — арнаңызды басқару және бәсекелестерді зерттеу үшін өте қолайлы.

Неге SaaS емес, десктоп қолданбасы?

Өйткені TGStat және Telemetr сияқты аналитикалық платформалар деректеріңізді олардың серверлеріне тапсыруды талап етеді — және әдетте кеңейтілген мүмкіндіктер үшін ақы алады. TG Analytics барлығын машинаңызда сақтайды және толық құралдар жиынтығын тегін береді.

TG Analytics-пен не істей аласыз

  • Жазылушылардың өсуін бақылау — аудиторияңыздың күн сайын, сағат сайын қалай өзгеретінін көріңіз.
  • Қатысу деңгейін (ER) өлшеу — постты қанша адам көргенін ғана емес, оның қаншалықты жақсы байланысқанын түсініңіз.
  • Ең жақсы жариялау уақытын табу — өз деректеріңізге негізделген орташа қаралымдардың 7×24 жылу картасы.
  • Үздік посттарды анықтау — не жұмыс істегенінен үйреніңіз және оны қайталаңыз.
  • Арналарды салыстыру — бір экранда 6-ға дейін.
  • Есептерді экспорттау — клиенттер үшін графиктері бар PDF немесе одан әрі талдау үшін CSV / JSON.
Telegram API тәжірибесі қажет емес

Telegram API-дің қалай жұмыс істейтінін білудің қажеті жоқ. Бір рет my.telegram.org сайтынан тіркелгі деректерін алыңыз — қалғанының бәрін қолданба орындайды.

Жүктеу және орнату

Барлық негізгі платформалар үшін дайын бинарлар. Орнату жоқ, тәуелділіктер жоқ.

Жүйелік талаптар
  • Windows: 10 немесе 11 (x64)
  • macOS: 11 (Big Sur) немесе жаңарақ
  • Linux: Ubuntu 22.04+ / WebKit2GTK бар ұқсас
  • Кемінде 2 ГБ ЖЖҚ, ~150 МБ бос орын
  • Синхрондау үшін белсенді интернет байланысы
1 Releases бетін ашыңыз

Барлық ресми билдтер GitHub-та орналастырылған:

Соңғы шығарылымды ашу
2 ОС үшін файлды жүктеп алыңыз
  • TGAnalytics-Windows.exe — Windows 10/11
  • TGAnalytics-Linux — Linux (chmod +x TGAnalytics-Linux орындаңыз)
  • TGAnalytics-macOS.zip — macOS (архивтен шығарып, .app файлын Applications қалтасына сүйреңіз)
3 Қолданбаны іске қосыңыз

Оны кез келген ыңғайлы жерге сақтаңыз — Жұмыс үстелі, Құжаттар, арнайы "Tools" қалтасы. Іске қосу үшін екі рет басыңыз. Бірінші іске қосу бинар ашылғанша 5–10 секунд алуы мүмкін.

Windows SmartScreen ескертуі

Орындалатын файл ақылы код қолтаңбасы сертификатымен қол қойылмағандықтан, Windows ескерту көрсетуі мүмкін. More info → Run anyway түймесін басыңыз. Қаласаңыз, қолданбаны бастапқы кодтан да құрастыра аласыз.

macOS Gatekeeper

Қолданбаны Applications қалтасына жылжытқаннан кейін Terminal-да xattr -cr "/Applications/TG Analytics.app" орындаңыз. Бұл қол қойылмаған қолданбалар үшін карантин жалаушасын жояды.

Telegram API тіркелгі деректері

Әрбір Telegram клиентіне ресми әзірлеуші порталынан api_id және api_hash қажет. Тегін, 3 минут алады.

API ID және API Hash дегеніміз не?

Олар Telegram үшін "әзірлеуші логині" сияқты жұмыс істейді. Әрбір үшінші тарап клиентінің өз жұбы бар. Сіз өзіңіздікін жасайсыз — бұл тегін, қауіпсіз және тек сіздің аккаунтыңызға тіркеледі.

1 my.telegram.org сайтына өтіңіз

Браузеріңізде https://my.telegram.org ашыңыз.

2 Телефон нөміріңізбен кіріңіз

Нөмірді + таңбасымен халықаралық форматта енгізіңіз — мысалы, +77071234567. Telegram қолданбаңызға растау кодын жібереді.

3 "API development tools" бөлімін ашыңыз

Кіргеннен кейін бақылау тақтасында API development tools түймесін басыңыз.

4 Қолданба жасаңыз

Форманы толтырыңыз — деректер Telegram олардың жазбалары үшін сақталады және функционалдылық үшін маңызды емес. Платформа: Desktop. Create application түймесін басыңыз.

5 Тіркелгі деректеріңізді көшіріңіз

Сіз екі мәнді көресіз — екеуін де көшіріңіз:

  • App api_id — 1234567 сияқты сан
  • App api_hash — abcdef1234567890abcdef1234567890 сияқты 32 таңбалы жол
Оларды құпия сақтаңыз

API ID, API Hash және телефон нөміріңіз бар кез келген адам Telegram аккаунтыңызға кіре алады. Оларды чаттарда, скриншоттарда немесе қоғамдық форумдарда ешқашан бөліспеңіз.

Авторизация

Екі кіру әдісі — өзіңізге ыңғайлысын таңдаңыз.

Телефон арқылы кіру (SMS / қолданбадағы код)

1 Кіру формасын толтырыңыз

Login экранын ашып, енгізіңіз:

  • API ID — my.telegram.org сайтынан
  • API Hash — my.telegram.org сайтынан
  • Телефон — + таңбасымен халықаралық форматта
2 "Sign in" түймесін басып, кодты енгізіңіз

Telegram қолданбаңызға (немесе SMS арқылы) код жібереді. Диалог пайда болады — кодты енгізіңіз. Егер екі факторлы аутентификация қосылған болса, кейін құпия сөз сұранысы пайда болады.

QR код арқылы кіру (ұсынылады)

1 API ID және API Hash толтырыңыз

QR арқылы кіру үшін телефон нөмірі қажет емес.

2 "Sign in via QR" түймесін басыңыз

QR терезесі ашылады. Телефоныңызда:

  1. Telegram-ды ашыңыз
  2. Параметрлер → Құрылғылар бөліміне өтіңіз
  3. QR сканерлеу түймесін басыңыз
  4. Камераны экрандағы QR-ға бағыттаңыз

Сәтті болған жағдайда терезе автоматты түрде жабылады.

Сіз жүйеге кірдіңіз

Сіздің атыңыз бүйір мәзірде пайда болады. Сессия жергілікті сақталады — келесі жолы қолданба ашылғанда, сіз бұрыннан кіргенсіз.

Сессия қайда сақталады?

~/.tg_analytics/sessions/ ішінде. Windows-та бұл C:\Users\YourName\.tg_analytics\sessions\. Толығымен шығу үшін қолданбадағы "Sign out" түймесін пайдаланыңыз.

Бақылау үшін арналарды қосу

Арналардың екі түрі: өзіңіздікі (әкімшілік құқықтар) және @username арқылы кез келген жалпыға қолжетімді арна.

Өз арналарыңыз

Арналар бөлімін ашыңыз. Сіздің әкімші арналарыңыз оң жақта автоматты түрде пайда болады — қолданба оларды Telegram диалогтарыңыздан тартып алады.

1 "Жаңарту" түймесін басыңыз

Қолданба сіз әкімші немесе иесі болып табылатын әр арнаны алады. Бұл бірінші іске қосуда 10–30 секунд алуы мүмкін.

2 Қажетті арнада "Бақылау" түймесін басыңыз

Арна сол жақ бағанға ("Бақыланатын") ауысады және қолданба дереу соңғы 100 пост пен ағымдағы жазылушылар санын импорттай бастайды.

Кез келген жалпыға қолжетімді арна (бәсекелестерді зерттеу)

Керемет мүмкіндік — кез келген ашық арнаны @username, t.me/... сілтемесі немесе сандық ID арқылы бақылаңыз.

1 "Жалпыға қолжетімді арнаны қосу" түймесін басыңыз

Енгізу өрісі бар модальды терезе ашылады.

2 Арна идентификаторын қойыңыз

Жұмыс істейтін мысалдар:

  • durov
  • @durov
  • t.me/durov
  • https://t.me/durov
3 Enter басыңыз немесе "Қосу" түймесін басыңыз

Қолданба арнаны анықтап, алдын ала қарауды көрсетеді — атауы, @username және жазылушылар саны. Содан кейін ол автоматты түрде бақылай бастайды.

Жабық арналарды бақылау мүмкін емес

Сыртқы бақылау үшін тек жалпыға қолжетімді арналар қолжетімді. Егер "channel is private" деп көрсеңіз — сіз әкімші болуыңыз керек немесе арна тек шақыру арқылы қолжетімді.

Арналар мен топтар

TG Analytics хабар тарату арналарына бағытталған, мұнда жариялау бір жақты. Супертоптар мен чаттар бақыланбайды — олардың динамикасы мен көрсеткіштері басқаша.

Әр көрсеткіш түсіндірілген

Әр санның мағынасы, ол қалай есептеледі және "жақсы" мән қандай болады.

Жазылушылар

Арнаға жазылған адамдардың ағымдағы саны — Telegram жалпыға көрсететіндей. TG Analytics бұл санды әр жинау циклінде суретке түсіреді, осылайша оның уақыт өте қалай өзгеретінін көресіз.

Telegram API-ден тікелей
Жазылушылардың өзгеруі (Δ)

Таңдалған кезеңде жазылушылар саны қаншалықты өзгерді. Оң = өсу, теріс = төмендеу. Жаңа жазылулар минус жазылымнан бас тартулардың таза әсерін көрсетеді.

subscribers_now − subscribers_at_period_start
Орташа қаралымдар

Таңдалған кезеңде жарияланған барлық посттар бойынша қаралымдардың орташа мәні. Бұл сіздің негізгі көрсеткішіңіз — әр жаңа пост осыған қатысты бағаланады.

sum(views) / number_of_posts
ER — Қатысу деңгейі

Әртүрлі өлшемдегі арналарды салыстыру үшін ең маңызды көрсеткіш. Бұл орташа постты көрген жазылушылардың пайызы. 100 мың жазылушысы және 15% ER бар арна — белсенді; 500 мың жазылушысы және 2% ER бар арна — бос қабық.

(average_views / subscribers) × 100

Типтік: үлкен үшін 5–15%, орташа үшін 15–40%, шағын үшін 40%+
Реакциялар

Постқа эмодзи реакцияларының жалпы саны. Нақты қатысудың күшті сигналы — реакциялар белсенді түртуді талап етеді, тек пассивті оқуды емес.

Sum of all reaction counts on a post
Қайта жіберулер

Пост басқа чатқа немесе арнаға қанша рет қайта жіберілді. Посттың "вирустық" болғанының ең айқын көрсеткіші — біреу оны өз аудиториясымен бөлісу үшін жеткілікті ұнатты.

Telegram API-ден тікелей
Контент түрі бойынша ER

Пост түрі бойынша бөлінген ER: мәтін, фото, видео, құжат, сауалнама. Бұл сіздің нақты аудиторияңыз үшін қай форматтың жақсы жұмыс істейтінін көрсетеді.

(avg_views_per_type / subscribers) × 100

Осы сандарды қалай түсіндіруге болады

  • ER өсуде + жазылушылар өсуде — сіз дұрыс жолдасыз. Істеп жатқаныңызды жалғастырыңыз.
  • ER төмендеуде + жазылушылар өсуде — сіз азырақ белсенді адамдарды тартып жатырсыз (мүмкін жарнамадан). Контентті түзету қажет болуы мүмкін.
  • ER өсуде + жазылушылар тұрақты — контент жақсы қабылданады, бірақ тарату жоқ. Кросс-промоуды қарастырыңыз.
  • ER төмендеуде + жазылушылар төмендеуде — бірдеңе дұрыс емес. Үздік посттарды соңғылармен салыстырып, ненің өзгергенін қараңыз.
Эмпирикалық ереже

Абсолютті сандарды қумаңыз. 25% ER және өсіп келе жатқан жазылушылары бар 3 мыңдық арна 2% ER бар 100 мыңдық арнадан гөрі сау. TG Analytics сізге трендтерді көрсету үшін жасалған, мақтаныш көрсеткіштерін емес.

Жазылушылардың өсу графигі

Өсу графигін қалай оқу керек, неге ол тек соңғы деректерді көрсетуі мүмкін және неге назар аудару керек.

График қалай құрылады

TG Analytics деректерді жинаған сайын, ол ағымдағы жазылушылар санының "суретін" сақтайды. График — сол суреттердің хронологиясы. Детальдау автоматты түрде бейімделеді:

  • Соңғы деректер (сағаттар): әр өлшеу нүкте — сіз егжей-тегжейін көресіз.
  • Күндер: сағаттық жинақталған — сағатына бір нүкте.
  • Апталар мен айлар: күнделікті жинақталған — күніне бір нүкте.
Неге менің графигім тек бүгінгі күнді көрсетеді?

Өйткені Telegram API арқылы жазылушылар тарихын ашпайды. TG Analytics оны арнаны бақылауды бастаған сәттен бастап қана жаза алады. Күндер мен апталар ішінде график табиғи түрде толады. Посттар, қаралымдар және реакциялар Telegram-ның өз тарихынан алынады — олар дереу қолжетімді.

Неге назар аудару керек

  • Тұрақты жоғары көлбеу — сау өсу. Кезеңдерді салыстыру үшін көлбеу бұрышын бақылаңыз.
  • Кенет секірулер — әдетте вирустық посттар, атап өтулер немесе жарнамалар. Үздік посттар тізіміндегі пост күндерімен байланыстырыңыз.
  • Плато — контент жақында бөлісілмеді немесе арна табиғи тепе-теңдікте.
  • Кенет төмендеулер — жазылушыларды тазалау, адамдарды шеттеткен пост немесе үлкен арна атап өтті.

Кезеңдерді салыстыру

Бір арнаны әртүрлі масштабда көру үшін 7D / 30D / 90D / Барлық уақыт қойындыларын ауыстырыңыз:

  • 7D — апталық шешімдер үшін: "менің соңғы кампаниям шынымен жұмыс істеді ме?"
  • 30D — әдепкі. Шу мен сигнал арасындағы жақсы тепе-теңдік.
  • 90D — тоқсандық трендтер, маусымдылық.
  • Барлық уақыт — бақылауды бастағаннан бергі толық тарих.
Кеңес: KPI ретінде Δ Жазылушыларды пайдаланыңыз

Жалпы санның орнына 7 күн ішіндегі өзгерісті бақылаңыз. Бұл сіздің соңғы контентіңіз бен хабарласуыңыз шынымен өндірген нәрсе — жалпы сан көбінесе тарих.

Ең жақсы жариялау уақыты (жылу картасы)

Өз арнаңызға негізделген апта күні мен сағат бойынша орташа қаралымдарды көрсететін 7×24 тор.

Жылу картасын қалай оқу керек

Әр ұяшық апта күні × тәулік сағатының бір комбинациясын білдіреді. Түс қарқындылығы сол терезеде жарияланған посттардың орташа қаралымы болып табылады. Қою көк = жоғары қаралымдар, ашық көк = төмен қаралымдар, ақ = сол ұяшықта әлі пост жарияланбаған.

Ең жақсы уақыт индикаторы

Қолданба ең жақсы ұяшықты сызылған жиекпен автоматты түрде ерекшелейді және карта тақырыбында "Best: Tue, 17:00" белгісін көрсетеді. Бұл сіздің есептелген ең жоғары қатысу терезесі.

Көптеген арналар нені анықтайды

  • Таңертеңгі слот (8:00–10:00) — жұмысқа бара жатқанда Telegram-ды тексеретін адамдар. Қысқа, мазмұнды контент үшін жақсы.
  • Түскі үзіліс (12:00–14:00) — орташа қатысу, ең кең аудитория.
  • Кешкі слот (18:00–21:00) — көптеген арналар үшін ең жоғары қатысу. Ұзағырақ оқулар мен бейнелер осында жақсы жұмыс істейді.
  • Демалыс күндері — мүлдем басқа үлгілер. Сенбі таңы мен жексенбі кеші жиі жоғары нәтиже береді.
Жылу картасына деректер қажет

10 посттан азырақ болса, жылу картасы негізінен бос болады — жеткілікті сигнал жоқ. Ол тәулік уақытына шашылған 30–50 посттан кейін шынымен пайдалы болады.

Жылу картасын тәжірибеде пайдалану

  1. "Ең жақсы уақыт" белгісін тексеріңіз — бұл сіздің үздік слотыңыз.
  2. Ең қараңғы 3–4 ұяшық үшін жылу картасын қараңыз. Бұлар сіздің сенімді терезелеріңіз.
  3. Ең маңызды посттарыңызды (хабарландырулар, шығарылымдар, ұзақ оқулар) сол слоттарға жоспарлаңыз.
  4. Жылу картасын ай сайын қайта тексеріңіз — аудитория әдеттері маусымдық өзгереді.

Үздік посттар және контент қоспасы

Жеңімпаздарыңыздан үйреніңіз — қай посттар көбірек әсер етті және қай формат жақсы жұмыс істейді.

Үздік посттар

Таңдалған кезеңнің үздік 10 посты, қаралымдар бойынша реттелген. Әр жол көрсетеді:

  • Дәреже — 1 ең көп қаралған пост
  • Күні — қашан жарияланды
  • Қаралымдар — пост қанша рет көрілді
  • Реакциялар — эмодзи реакцияларының саны
  • Қайта жіберулер — қанша рет бөлісілді
  • Мәтіннің алдын ала қарауы — алғашқы ~130 таңба
Бұл тізіммен не істеу керек
  • Үздік 3 постты қатар оқыңыз. Ортақ үлгі қандай?
  • Олардың ұқсас уақытта жарияланғанын тексеріңіз — жылу картасымен байланыстырыңыз.
  • Форматты (ұзын мәтін / қысқа / медиамен) белгілеп, жеңімпаз формуланы қайталауға тырысыңыз.
  • Егер жеңімпаз көп қайта жіберілсе — бұл аудиторияңыз бөліскісі келетін тақырып. Ол туралы көбірек жазыңыз.

Контент қоспасы

Әр түрде қанша пост жариялағаныңызды көрсететін сақина диаграмма, әр түр бойынша статистикамен:

  • Саны — осы түрдегі посттар саны
  • Орташа қаралымдар — осы түрдегі постқа орташа қаралым
  • ER — осы түр үшін қатысу деңгейі

Түстер: көк — мәтін, күлгін — фото, қызғылт — видео, қызғылт сары — құжат, жасыл — сауалнама.

Түсіндіру мысалдары
  • Видео мәтінге қарағанда 3 есе көп ER береді → видеоны екі есе арттырыңыз.
  • Фото посттар жоғары қаралым алады, бірақ реакция аз → визуалды контент көзді тартады, бірақ әрекетті тудырмайды. Фотоларды күштірек тақырыптармен біріктіріңіз.
  • Сауалнамалар ER бойынша әлдеқайда жоғары → аудиторияңыз қатысқанды ұнатады. Сауалнамаларды жиірек пайдаланыңыз.
  • Барлық түрлер ұқсас ER көрсетеді → аудиторияңыз форматқа емес, тақырыпқа мән береді. Контент сапасына назар аударыңыз.

Арналарды салыстыру

Бір экранда 6 арнаға дейін — өз портфолиоңыз үшін немесе бәсекелестерге қарсы.

Қашан пайдалы

  • Сіз бірнеше арна басқарасыз — қайсысына көбірек күш салу керектігін көріңіз.
  • Бәсекелестерді эталондау — 2–3 тікелей бәсекелесті бақылап, өзіңізді салыстырыңыз.
  • Санатты талдау — егер нишаға кірмек болсаңыз, эталондарды түсіну үшін 3–4 танымал арнаны салыстырыңыз.
  • Клиенттерге есеп беру — клиенттер үшін арналарды басқарсаңыз, бір экран олардың барлығын көрсетеді.

Қалай пайдалану керек

1 Салыстыру бөлімін ашыңыз

Ауыстырып-қосқыш қатарынан 2–6 арнаны таңдаңыз. Алғашқы екеуі автоматты түрде таңдалады.

2 Кезеңді таңдаңыз

Бақылау тақтасындағыдай 7D / 30D / 90D / Барлық қойындылары.

3 Салыстыру кестесін оқыңыз

Жолдар: жазылушылар, кезең ішіндегі Δ, орташа қаралымдар, ER, пост саны. Бағандар: әр арна үшін бір. Әр бағанның төмендегі көп сызықты графикке сәйкес келетін түсті жолағы бар.

4 Көп сызықты графикті қараңыз

Ортақ таймлайнда әр арна үшін бір сызық — қайсысы тезірек өсіп жатқанын немесе қайсысы тегіс екенін бірден байқаңыз.

5 Орташа қаралымдар мен ER-ді салыстырыңыз

Төменде екі баған диаграмма: біреуі орташа қаралымдар үшін, біреуі ER үшін. Арналардың өлшемдері өте әртүрлі болған кезде ER ең әділ салыстыру болып табылады.

Өлшемдер бойынша салыстыру — әрқашан ER пайдаланыңыз

1 мыңдық арна мен 1 миллиондық арнаны абсолютті сандармен салыстыру мүмкін емес. Бірақ 1 мыңдық арнада 40% ER, ал 1 миллиондықта 8% ER болса, кішісі әр жазылушыға әлдеқайда белсенді. Бұл TGStat ақы алатын инсайт.

Экспорт және есептер

Үш формат — клиенттер үшін, одан әрі талдау үшін немесе бэкап үшін.

PDF есеп

Клиенттерге, менеджерлерге немесе мүдделі тараптарға жіберуге арналған таза A4 есеп. Мыналарды қамтиды:

  • Арна атауы, @username, кезең және жасалған күні бар тақырып
  • Төрт KPI картасы: жазылушылар, орташа қаралымдар, ER, пост саны
  • Дұрыс ось пішімдеуімен жазылушылардың өсу графигі
  • Контент қоспасының баған диаграммасы
  • Ең жақсы жариялау уақытының жылу картасы
  • Қаралымдар, реакциялар, қайта жіберулер, мәтіннің алдын ала қарауы бар үздік-10 пост кестесі

Диаграммалар PDF ішінде (matplotlib арқылы) жергілікті түрде көрсетіледі — суреттер ретінде емес — сондықтан мәтін мен сандар кез келген масштабта анық болып қалады.

Эмодзилерді жою

PDF-тегі қаріп шектеулеріне байланысты пост мәтіндеріндегі эмодзилер PDF есептен жойылады. Толық түпнұсқа мәтін JSON және CSV экспорттарында сақталады.

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-үйлесімді)
Қалай экспорттау керек

Бақылау тақтасын ашып, құралдар тақтасындағы Экспорт түймесін басыңыз. Форматты таңдап, сақтау орнын таңдаңыз — дайын. Әдепкі қалта ~/.tg_analytics/exports/, бірақ оны Параметрлерде өзгертуге болады.

Авто-жинау

Деректер қаншалықты жиі алынады және оны қажеттіліктеріңізге қалай конфигурациялау керек.

Қалай жұмыс істейді

Фондық ағын кесте бойынша оянып, әр бақыланатын арнаны жаңартады — бір-бірлеп, Telegram-ның флудтан қорғауын тудырмау үшін арналар арасында 3 секунд үзіліспен.

  • Ағымдағы жазылушылар санын алады → жаңа сурет
  • Соңғы 50 посттағы қаралымдарды / реакцияларды / қайта жіберулерді жаңартады
  • Егер соңғы жүгіруден бері жаңа посттар пайда болса, оларды импорттайды
  • Күніне бір рет ескі деректерді тазалайды (сіздің сақтау параметріңізге сәйкес)

Аралықты таңдау

  • 15 минут — белсенді өсіп келе жатқан арналар үшін. Егжей-тегжейлі тарих, көбірек API шақырулары.
  • 30 минут — ұсынылатын әдепкі. Жақсы тепе-теңдік.
  • 1 сағат — көптеген арналарды бақылау үшін жеңіл.
  • 2–6 сағат — бәсекелес арналарды ұзақ мерзімді байқау үшін.
  • Тек қолмен — автоматты түрде ештеңе болмайды; жаңа деректер қажет болғанда "Қазір жинау" түймесін басасыз.

Қайда конфигурациялау керек

1 Параметрлерді ашыңыз

Бүйір мәзір → Параметрлер → Жинау бөлімі.

2 Аралықты орнатыңыз

Ашылмалы мәзірден таңдаңыз. Өзгеріс дереу қолданылады — қайта іске қосу қажет емес.

3 Мәртебені бақылаңыз

Ашылмалы мәзірдің дәл астында "Авто-жинау мәртебесі" көрсетеді: соңғы жүгіру уақыты, келесі жүгіру ETA және ағымдағы аралық.

Қолмен жинау

Барлық арналарды дереу жаңарту үшін Параметрлердегі Қазір жинау түймесін басыңыз. Жоғарғы тақта жүгіру барысында айналма индикаторды көрсетеді. Есеп жасамас бұрын пайдалы.

Telegram жылдамдық шектеулері

Көптеген арналарда өте қысқа аралықтар (15 минуттан төмен) FloodWait тудыруы мүмкін. Егер журналдарда жиі флуд қателерін көрсеңіз, аралықты ұлғайтыңыз.

Параметрлер және тақырыптар

Тіл, сыртқы түрі, сақтау, экспорт қалтасы, журналдар — барлығы конфигурацияланады.

Тіл

Интерфейсте 5 тіл қолдау көрсетіледі: ағылшын, орыс, испан, португал (BR), неміс. Параметрлер → Тіл бөлімінде өзгертіңіз — интерфейс қайта іске қосусыз дереу жаңарады.

Сыртқы түрі

Үш режим:

  • Жүйелік (әдепкі) — ОС қалауыңызды ұстанады. ОС тақырыбын өзгертіңіз, қолданба нақты уақытта жаңарады.
  • Қараңғы — мәжбүрлі қараңғы тақырып.
  • Жарық — мәжбүрлі жарық тақырып.

Сондай-ақ қолданбаның жоғарғы оң жақ бұрышындағы тақырыпты ауыстыру түймесін басу арқылы тақырыптарды жылдам ауыстыра аласыз.

Сақтау

Жергілікті дерекқорда ескі суреттер мен посттарды қанша уақыт сақтау керек:

  • 30 / 90 / 180 күн — жеңіл конфигурациялар үшін
  • 1 жыл — ұсынылатын әдепкі
  • Мәңгілік — ештеңені тазаламау (дерекқор өседі)

Күнделікті тазалау фондық режимде жүреді және сақтау терезесінен ескі жазбаларды жояды.

Экспорт қалтасы

PDF / JSON / CSV файлдары қайда сақталады. Әдепкі ~/.tg_analytics/exports/. Оны Параметрлер → Қалтаны таңдау арқылы кез келген қалтаға өзгертіңіз.

Журналдар

Қолданба журналдары ~/.tg_analytics/logs/ ішінде сақталады:

  • app.log — айналдырумен жалпы белсенділік журналы (5 MB × 5 файл)
  • crash.log — тек өңделмеген ерекшеліктер толық трассировкамен

Журналдар каталогын файл менеджеріңізде ашу үшін Параметрлердегі "Қалтаны ашу" түймесін басыңыз. Мәселелер туралы хабарлау үшін пайдалы.

Қауіпті аймақ

"Барлығын жою" түймесі барлық бақыланатын арналарды және олардың тарихын біржола жояды. Жаңа бастау үшін пайдаланыңыз. Ол Telegram деректеріңізге әсер етпейді — тек жергілікті аналитикалық дерекқор.

Ақаулықтарды жою

Жиі кездесетін мәселелерге жылдам жауаптар.

Windows SmartScreen .exe файлын бөгеп отыр — не істеу керек?

Диалогтағы More info түймесін басып, содан кейін Run anyway түймесін басыңыз. Бұл орындалатын файлға код қолтаңбасы қойылмағандықтан болады. Егер сенбесеңіз — бастапқы кодтан құрастырыңыз: репозиторийді клондап, python build.py орындаңыз.

macOS "App is damaged and can't be opened" дейді

Terminal ашып, мынаны орындаңыз: xattr -cr "/Applications/TG Analytics.app". Бұл macOS қол қойылмаған қолданбаларға қосатын карантин атрибутын жояды. Осыдан кейін бірінші іске қосуда оң жақ түймемен басып → Ашу таңдаңыз.

Жазылушылардың өсу графигі тек бүгінгі күнді көрсетеді — бұл қате ме?

Жоқ. Telegram өз API арқылы жазылушылар тарихын бермейді. Қолданба арнаны бақылауды бастаған сәттен бастап суреттерді жазады — сондықтан график бір нүктеден басталып, жаңа жинаулармен өседі. 30 минуттық аралықтармен сіз бір тәулік ішінде толық 24 сағаттық қисық аласыз.

Жинау кезінде "FloodWait" қателері

Telegram аккаунтыңыздың жылдамдығын шектеп отыр. Авто-жинау аралығын ұлғайтыңыз (Параметрлер → 30 мин немесе одан да көп) және бақыланатын арналар санын азайтыңыз. Қолданба FloodWait-ты үзіліспен автоматты өңдейді — бірақ оны жиі көрсеңіз, аралықты өзгертіңіз.

@username арқылы қосқанда арна "channel is private" дейді

Сыртқы бақылау үшін тек жалпыға қолжетімді арналар қолжетімді. Жабық арналар (тек шақыру арқылы) мүшеліксіз қолжетімсіз. Егер сіз мүше болсаңыз, арна әкімші тізіміңізде автоматты түрде пайда болады — Арналар қойындысын тексеріңіз.

Сессияның мерзімі бітті — қайта кіруім керек

Telegram тым көп құрылғыдан кірсеңіз немесе Telegram-да сессияларды қолмен қалпына келтірсеңіз, сессияны қайтарып алуы мүмкін. Жай ғана Sign out түймесін басып, QR немесе телефон арқылы қайта кіріңіз. Бақыланатын арналарыңыз бен аналитикалық деректеріңіз сақталады — олар жергілікті дерекқорда, сессияда емес.

PDF экспорты қатемен сәтсіз аяқталады

Сірә, қаріптің жоқтығы. Нақты қатені ~/.tg_analytics/logs/app.log ішінен тексеріңіз және журнал үзіндісімен GitHub-та мәселе ашыңыз. Уақытша шешім ретінде қаріптерді қажет етпейтін JSON / CSV экспортын пайдаланыңыз.

Қайдан көмек ала аламын?

GitHub Issues сайтында мәселе ашыңыз немесе Telegram-да тікелей хабарласыңыз: @igor_shelloff. Қосыңыз: не істедіңіз, не болды және (мүмкін болса) журнал үзіндісін.

Жобаны қолдау

TG Analytics әрқашан тегін болды және болады. Егер ол сізге уақыт үнемдесе, көмектесудің жолдары.

GitHub-та жұлдызша қою

Жұлдызшалар басқаларға жобаны табуға көмектеседі.

Репозиторийді ашу
Қателер туралы хабарлау

Қате таптыңыз ба немесе мүмкіндік идеясы бар ма?

Мәселе ашу
Boosty арқылы қайырымдылық

Құралды одан әрі дамытуды қолдаңыз.

Қайырымдылық
Сәлем айтыңыз

Сұрақтар немесе пікірлер? Тікелей хабарласыңыз.

@igor_shelloff
Аналитикадан көбірек керек пе?

Егер TG Analytics ненің жұмыс істейтінін айтса, бірақ сізге де ауқымды түрде жариялау және хабарласу қажет болса — сол әзірлеушінің Telegram AutoPoster Pro құралын қолданып көріңіз. Жоспарланған постинг, жеке хабарламалар кампаниялары, көп аккаунт, хикаялар, автостоп қорғанысы, Telegram-дағы есептер.

Telegram AutoPoster Pro-ны зерттеңіз