TG Analytics · Panduan Lengkap

Baca saluran anda seperti seorang profesional

Maksud setiap metrik, cara membaca papan pemuka, dan cara membuat keputusan yang lebih baik daripada data Telegram anda. Ditulis untuk pemula — dengan nombor konkrit dan penanda aras dunia sebenar.

Mula
Memahami papan pemuka
Lanjutan
Lagi

Pengenalan

Apakah TG Analytics, mengapa setempat-diutamakan penting, dan apa yang akan anda pelajari dalam panduan ini.

Setempat-diutamakan, peribadi mengikut reka bentuk

Semua yang anda jejaki disimpan dalam pangkalan data SQLite setempat pada komputer anda. Tiada akaun, tiada pelayan, tiada telemetri. Kod sumber penuh di GitHub di bawah Lesen MIT.

TG Analytics ialah aplikasi desktop percuma yang mengubah saluran Telegram anda menjadi data yang jelas dan boleh diambil tindakan. Ia berfungsi dengan saluran anda sendiri (di mana anda adalah admin) dan mana-mana saluran awam — sesuai untuk kedua-dua menjalankan saluran anda dan mengkaji pesaing.

Mengapa aplikasi desktop dan bukan SaaS?

Kerana platform analitik seperti TGStat dan Telemetr memerlukan anda menyerahkan data anda kepada pelayan mereka — dan biasanya membayar untuk ciri lanjutan. TG Analytics menyimpan semuanya pada mesin anda dan memberikan anda kit alat penuh secara percuma.

Apa yang boleh anda lakukan dengan TG Analytics

  • Jejaki pertumbuhan pelanggan — lihat bagaimana audiens anda berubah hari demi hari, jam demi jam.
  • Ukur penglibatan (ER) — fahami bukan sahaja berapa ramai orang melihat siaran, tetapi seberapa baik ia berhubung.
  • Cari masa penyiaran terbaik anda — peta haba 7×24 purata paparan, berdasarkan data anda sendiri.
  • Kenal pasti siaran teratas — belajar daripada apa yang berkesan dan ulangi.
  • Bandingkan saluran — sehingga 6 sebelah-menyebelah, pada skrin yang sama.
  • Eksport laporan — PDF dengan carta untuk pelanggan, atau CSV / JSON untuk analisis lanjut.
Tiada pengalaman API Telegram diperlukan

Anda tidak perlu tahu bagaimana API Telegram berfungsi. Hanya dapatkan kelayakan anda dari my.telegram.org sekali — dan semua yang lain dikendalikan oleh aplikasi.

Muat turun & pasang

Binari prabina untuk semua platform utama. Tiada pemasangan, tiada kebergantungan.

Keperluan sistem
  • Windows: 10 atau 11 (x64)
  • macOS: 11 (Big Sur) atau lebih baharu
  • Linux: Ubuntu 22.04+ / serupa dengan WebKit2GTK
  • 2 GB RAM minimum, ~150 MB ruang cakera bebas
  • Sambungan internet aktif untuk penyegerakan
1 Buka halaman Pelancaran

Semua binaan rasmi dihoskan di GitHub:

Buka Pelancaran Terkini
2 Muat turun fail untuk OS anda
  • TGAnalytics-Windows.exe — Windows 10/11
  • TGAnalytics-Linux — Linux (jadikan boleh laku: chmod +x TGAnalytics-Linux)
  • TGAnalytics-macOS.zip — macOS (unzip, seret .app ke Applications)
3 Jalankan aplikasi

Simpan di mana-mana sahaja yang sesuai — Desktop, Documents, folder "Tools" khusus. Klik dua kali untuk melancarkan. Pelancaran pertama mungkin mengambil masa 5–10 saat semasa binari menyahmampat.

Amaran Windows SmartScreen

Kerana fail boleh laku tidak ditandatangani dengan sijil penandatanganan kod berbayar, Windows mungkin menunjukkan amaran. Klik More info → Run anyway. Anda juga boleh membina aplikasi dari sumber jika anda mahu.

macOS Gatekeeper

Buka Terminal dan jalankan xattr -cr "/Applications/TG Analytics.app" selepas memindahkan aplikasi ke Applications. Ini membuang bendera kuarantin untuk aplikasi yang tidak ditandatangani.

Kelayakan API Telegram

Setiap klien Telegram memerlukan api_id dan api_hash dari portal pembangun rasmi. Percuma, mengambil masa 3 minit.

Apakah ID API dan Hash API?

Ia berfungsi sebagai "log masuk pembangun" untuk Telegram. Setiap klien pihak ketiga mempunyai pasangannya sendiri. Anda akan mencipta sendiri — ia percuma, selamat, dan dilampirkan hanya pada akaun anda.

1 Pergi ke my.telegram.org

Buka https://my.telegram.org dalam pelayar anda.

2 Log masuk dengan nombor telefon anda

Masukkan nombor dalam format antarabangsa dengan + — contohnya +60123456789. Telegram menghantar kod pengesahan ke aplikasi anda.

3 Buka "API development tools"

Selepas log masuk, klik API development tools dalam papan pemuka.

4 Cipta aplikasi

Isi borang — data disimpan oleh Telegram untuk rekod mereka dan tidak penting untuk kefungsian. Platform: Desktop. Klik Create application.

5 Salin kelayakan anda

Anda akan melihat dua nilai — salin kedua-duanya:

  • App api_id — nombor, cth. 1234567
  • App api_hash — rentetan 32 aksara, cth. abcdef1234567890abcdef1234567890
Simpan ini secara peribadi

Sesiapa yang mempunyai ID API, Hash API dan nombor telefon anda berpotensi mengakses akaun Telegram anda. Jangan sekali-kali berkongsinya dalam sembang, tangkapan skrin, atau forum awam.

Kebenaran

Dua kaedah log masuk — pilih yang lebih selesa untuk anda.

Log masuk telefon (SMS / kod dalam aplikasi)

1 Isi borang log masuk

Buka skrin Login dan masukkan:

  • ID API — dari my.telegram.org
  • Hash API — dari my.telegram.org
  • Telefon — format antarabangsa dengan +
2 Klik "Sign in" dan masukkan kod

Telegram menghantar kod ke aplikasi anda (atau SMS). Dialog muncul — masukkan kod. Jika pengesahan dua faktor didayakan, prompt kata laluan menyusul.

Log masuk kod QR (disyorkan)

1 Isi ID API dan Hash API

Nombor telefon tidak diperlukan untuk log masuk QR.

2 Klik "Sign in via QR"

Tetingkap QR terbuka. Pada telefon anda:

  1. Buka Telegram
  2. Pergi ke Settings → Devices
  3. Ketik Scan QR
  4. Halakan kamera ke QR pada skrin anda

Tetingkap ditutup secara automatik apabila berjaya.

Anda telah log masuk

Nama anda muncul di bar sisi. Sesi disimpan secara setempat — lain kali aplikasi dibuka, anda sudah log masuk.

Di mana sesi disimpan?

Dalam ~/.tg_analytics/sessions/. Pada Windows ini adalah C:\Users\YourName\.tg_analytics\sessions\. Untuk log keluar sepenuhnya, gunakan butang "Sign out" dalam aplikasi.

Tambah saluran untuk dijejaki

Dua jenis saluran: milik anda sendiri (hak admin) dan mana-mana saluran awam mengikut @username.

Saluran anda sendiri

Buka bahagian Saluran. Saluran admin anda muncul secara automatik di sebelah kanan — aplikasi menariknya dari dialog Telegram anda.

1 Klik "Refresh"

Aplikasi mengambil setiap saluran di mana anda adalah admin atau pemilik. Ini mungkin mengambil masa 10–30 saat pada larian pertama.

2 Klik "Track" pada saluran yang anda mahu

Saluran berpindah ke lajur kiri ("Tracked") dan aplikasi serta-merta mula mengimport 100 siaran terakhir dan kiraan pelanggan semasa.

Mana-mana saluran awam (penyelidikan pesaing)

Ciri pembunuh — jejaki mana-mana saluran terbuka mengikut @username, pautan t.me/..., atau ID berangka.

1 Klik "Add public channel"

Membuka modal dengan medan input.

2 Tampal pengecam saluran

Contoh apa yang berfungsi:

  • durov
  • @durov
  • t.me/durov
  • https://t.me/durov
3 Tekan Enter atau klik "Add"

Aplikasi menyelesaikan saluran dan menunjukkan pratonton — tajuk, @username dan kiraan pelanggan. Kemudian ia mula menjejaki secara automatik.

Saluran peribadi tidak boleh dijejaki

Hanya saluran awam tersedia untuk penjejakan luaran. Jika anda melihat "channel is private" — anda perlu menjadi admin, atau saluran itu jemputan sahaja.

Saluran vs kumpulan

TG Analytics memberi tumpuan kepada saluran penyiaran di mana penyiaran adalah sehala. Supergroup dan sembang tidak dijejaki — ia mempunyai dinamik dan metrik yang berbeza.

Setiap metrik diterangkan

Maksud setiap nombor, cara ia dikira, dan bagaimana nilai "baik" kelihatan.

Pelanggan

Bilangan orang semasa yang melanggan saluran — sama seperti yang ditunjukkan oleh Telegram secara awam. TG Analytics mengambil syot kilat nombor ini pada setiap kitaran pengumpulan, jadi anda boleh melihat bagaimana ia berubah dari semasa ke semasa.

Terus dari API Telegram
Perubahan pelanggan (Δ)

Berapa banyak kiraan pelanggan berubah sepanjang tempoh yang dipilih. Positif = pertumbuhan, negatif = penurunan. Menunjukkan kesan bersih langganan baharu tolak berhenti melanggan.

subscribers_now − subscribers_at_period_start
Purata paparan

Purata bilangan paparan merentas semua siaran yang diterbitkan dalam tempoh yang dipilih. Ini adalah garis dasar anda — setiap siaran baharu akan dinilai berbandingnya.

sum(views) / number_of_posts
ER — Kadar Penglibatan

Metrik paling penting untuk membandingkan saluran dengan saiz yang berbeza. Ia adalah peratusan pelanggan yang melihat purata siaran anda. Saluran dengan 100k pelanggan dan 15% ER terlibat; 500k pelanggan dengan 2% ER adalah cangkerang kosong.

(average_views / subscribers) × 100

Biasa: 5–15% besar, 15–40% sederhana, 40%+ kecil
Reaksi

Jumlah bilangan reaksi emoji pada siaran. Isyarat kuat penglibatan sebenar — reaksi memerlukan ketikan aktif, bukan hanya bacaan pasif.

Jumlah semua kiraan reaksi pada siaran
Pemajuan

Berapa kali siaran dimajukan ke sembang atau saluran lain. Penunjuk paling jelas siaran "menjadi tular" — seseorang menyukainya cukup untuk berkongsi dengan audiens mereka sendiri.

Terus dari API Telegram
ER jenis kandungan

ER dipecahkan mengikut jenis siaran: teks, foto, video, dokumen, tinjauan. Ini menunjukkan dengan tepat format mana yang berprestasi terbaik untuk audiens khusus anda.

(avg_views_per_type / subscribers) × 100

Cara mentafsir nombor ini

  • ER meningkat + pelanggan bertambah — anda berada di landasan yang betul. Teruskan apa yang anda lakukan.
  • ER menurun + pelanggan bertambah — anda menarik orang yang kurang terlibat (mungkin dari iklan). Kandungan mungkin perlu diselaraskan.
  • ER meningkat + pelanggan mendatar — kandungan bergema tetapi pengedaran tidak. Pertimbangkan promosi silang.
  • ER menurun + pelanggan menurun — sesuatu tidak kena. Bandingkan siaran teratas dengan yang terkini dan cari apa yang berubah.
Peraturan praktikal

Jangan kejar nombor mutlak. Saluran 3k dengan 25% ER dan pelanggan yang berkembang lebih sihat daripada saluran 100k dengan 2% ER. TG Analytics dibina untuk menunjukkan trend, bukan metrik kesombongan.

Carta pertumbuhan pelanggan

Cara membaca carta pertumbuhan, mengapa ia mungkin hanya menunjukkan data terkini, dan apa yang perlu dicari.

Bagaimana carta dibina

Setiap kali TG Analytics mengumpul data, ia menyimpan "syot kilat" kiraan pelanggan semasa. Carta adalah garis masa syot kilat tersebut. Granulariti menyesuaikan secara automatik:

  • Data terkini (jam): setiap ukuran adalah satu titik — anda melihat butiran halus.
  • Hari: digabungkan setiap jam — satu titik setiap jam.
  • Minggu dan bulan: digabungkan setiap hari — satu titik setiap hari.
Mengapa carta saya hanya menunjukkan hari ini?

Kerana Telegram tidak mendedahkan sejarah pelanggan melalui API. TG Analytics hanya boleh merekodkannya dari saat anda mula menjejaki saluran. Dari semasa ke semasa, carta terisi secara semula jadi. Siaran, paparan, dan reaksi ditarik dari sejarah Telegram sendiri — ia tersedia serta-merta.

Apa yang perlu dicari

  • Cerun menaik yang stabil — pertumbuhan sihat. Jejaki sudut cerun untuk membandingkan tempoh.
  • Lonjakan mendadak — biasanya disebabkan oleh siaran tular, sebutan, atau iklan. Kaitkan dengan tarikh siaran dari senarai siaran teratas.
  • Mendatar — kandungan tidak dikongsi baru-baru ini, atau saluran berada pada keseimbangan semula jadi.
  • Penurunan mendadak — pembersihan pelanggan, siaran yang mengasingkan orang, atau saluran besar menjatuhkan sebutan.

Perbandingan tempoh

Tukar antara tab 7H / 30H / 90H / Sepanjang masa untuk melihat saluran yang sama pada tahap zum yang berbeza:

  • 7H — untuk keputusan mingguan: "adakah kempen terakhir saya benar-benar berkesan?"
  • 30H — lalai. Keseimbangan baik antara bunyi dan isyarat.
  • 90H — trend suku tahunan, bermusim.
  • Sepanjang masa — sejarah penuh sejak anda mula menjejaki.
Petua pro: gunakan Δ Pelanggan sebagai KPI anda

Daripada jumlah, tonton perubahan sepanjang 7 hari. Itulah yang sebenarnya dihasilkan oleh kandungan dan jangkauan terkini anda — jumlah sebahagian besarnya adalah sejarah.

Masa penyiaran terbaik (peta haba)

Grid 7×24 yang menunjukkan purata paparan mengikut hari dalam seminggu dan jam, berdasarkan saluran anda sendiri.

Cara membaca peta haba

Setiap sel mewakili satu kombinasi hari-dalam-minggu × jam-dalam-hari. Keamatan warna ialah purata paparan siaran yang diterbitkan dalam tetingkap itu. Biru gelap = paparan tinggi, biru muda = paparan rendah, putih = tiada siaran diterbitkan dalam slot itu lagi.

Penunjuk masa terbaik

Aplikasi secara automatik menyerlahkan slot terbaik dengan sempadan bergaris dan menunjukkan label "Best: Tue, 17:00" dalam pengepala kad. Ini adalah tetingkap penglibatan puncak yang dikira.

Apa yang kebanyakan saluran temui

  • Slot pagi (8:00–10:00) — pengembara menyemak Telegram dalam perjalanan ke tempat kerja. Baik untuk kandungan pendek dan padat.
  • Waktu makan tengah hari (12:00–14:00) — penglibatan sederhana, audiens paling luas.
  • Slot petang (18:00–21:00) — penglibatan puncak untuk kebanyakan saluran. Bacaan panjang dan video berfungsi paling baik di sini.
  • Hujung minggu — corak yang sama sekali berbeza. Sabtu pagi dan Ahad petang selalunya berprestasi tinggi.
Peta haba memerlukan data

Dengan kurang daripada 10 siaran, peta haba kebanyakannya akan kosong — tidak ada isyarat yang cukup. Ia menjadi benar-benar berguna selepas 30–50 siaran tersebar merentas masa yang berbeza dalam sehari.

Menggunakan peta haba dalam praktik

  1. Semak label "Masa terbaik" — itu slot teratas anda.
  2. Lihat peta haba untuk 3–4 sel paling gelap teratas. Itulah tetingkap yang boleh dipercayai anda.
  3. Jadualkan siaran paling penting anda (pengumuman, pelancaran, bacaan panjang) ke dalam slot tersebut.
  4. Semak semula peta haba setiap bulan — tabiat audiens berubah mengikut musim.

Siaran teratas & campuran kandungan

Belajar daripada pemenang anda — siaran mana yang paling bergema, dan format mana yang berfungsi paling baik.

Siaran teratas

10 siaran teratas dalam tempoh yang dipilih, disusun mengikut paparan. Setiap baris menunjukkan:

  • Kedudukan — 1 ialah siaran paling banyak dilihat
  • Tarikh — bila ia diterbitkan
  • Paparan — jumlah bilangan kali siaran dilihat
  • Reaksi — kiraan reaksi emoji
  • Pemajuan — bilangan kali ia dikongsi
  • Pratonton teks — ~130 aksara pertama
Apa yang perlu dilakukan dengan senarai ini
  • Baca 3 siaran teratas anda sebelah-menyebelah. Apakah corak yang sama?
  • Semak sama ada ia diterbitkan pada masa yang sama — rujuk silang dengan peta haba.
  • Perhatikan format (teks panjang / pendek / dengan media) dan cuba tiru formula yang menang.
  • Jika pemenang mendapat banyak pemajuan — itu topik yang audiens anda mahu kongsi. Tulis lebih banyak mengenainya.

Campuran kandungan

Carta donat yang menunjukkan berapa banyak siaran setiap jenis yang anda terbitkan, dengan statistik setiap jenis:

  • Kiraan — berapa banyak siaran jenis ini
  • Purata paparan — purata paparan setiap siaran jenis ini
  • ER — kadar penglibatan untuk jenis ini

Warna: biru untuk teks, ungu untuk foto, merah jambu untuk video, oren untuk dokumen, hijau untuk tinjauan.

Contoh tafsiran
  • Video mempunyai 3x ER teks → gandakan video.
  • Siaran foto mendapat paparan tinggi tetapi reaksi rendah → kandungan visual menarik perhatian tetapi tidak mencetuskan tindakan. Pasangkan foto dengan kapsyen yang lebih kuat.
  • Tinjauan mempunyai ER tertinggi setakat ini → audiens anda suka mengambil bahagian. Gunakan tinjauan lebih kerap.
  • Semua jenis menunjukkan ER yang serupa → audiens anda mengambil berat tentang topik, bukan format. Fokus pada kualiti kandungan.

Membandingkan saluran

Sehingga 6 saluran sebelah-menyebelah — untuk portfolio anda atau berbanding pesaing.

Bilakah ia berguna

  • Anda menjalankan berbilang saluran — lihat mana yang lebih memerlukan usaha.
  • Penanda aras pesaing — jejaki 2–3 pesaing langsung dan lihat bagaimana anda dibandingkan.
  • Analisis kategori — jika anda mempertimbangkan memasuki niche, bandingkan 3–4 saluran yang mantap untuk memahami penanda aras.
  • Pelaporan pelanggan — jika anda mengurus saluran untuk pelanggan, satu skrin menunjukkan semuanya.

Cara menggunakan

1 Buka bahagian Bandingkan

Pilih 2–6 saluran dari baris togol. Dua yang pertama dipilih secara automatik.

2 Pilih tempoh

Tab 7H / 30H / 90H / Semua yang sama seperti pada papan pemuka.

3 Baca jadual perbandingan

Baris: pelanggan, Δ sepanjang tempoh, purata paparan, ER, kiraan siaran. Lajur: satu setiap saluran. Setiap lajur mempunyai jalur berwarna sepadan dengan carta berbilang garis di bawah.

4 Lihat carta berbilang garis

Satu garis setiap saluran pada garis masa yang dikongsi — kenal pasti serta-merta mana yang berkembang lebih pantas, atau mana yang mendatar.

5 Bandingkan purata paparan dan ER

Dua carta bar di bawah: satu untuk purata paparan, satu untuk ER. ER adalah perbandingan paling adil apabila saluran mempunyai saiz yang sangat berbeza.

Membandingkan merentas saiz — sentiasa gunakan ER

Saluran 1k dan saluran 1J tidak boleh dibandingkan dengan nombor mutlak. Tetapi jika saluran 1k mempunyai 40% ER dan 1J mempunyai 8% ER, yang lebih kecil jauh lebih terlibat setiap pelanggan. Ini adalah jenis pandangan yang TGStat mengenakan bayaran.

Eksport & laporan

Tiga format — untuk pelanggan, analisis lanjut, atau sandaran.

Laporan PDF

Laporan A4 yang digilap direka untuk dihantar kepada pelanggan, pengurus, atau pihak berkepentingan. Termasuk:

  • Pengepala dengan nama saluran, @username, tempoh dan tarikh penjanaan
  • Empat kad KPI: pelanggan, purata paparan, ER, kiraan siaran
  • Carta pertumbuhan pelanggan dengan pemformatan paksi yang betul
  • Carta bar campuran kandungan
  • Peta haba masa penyiaran terbaik
  • Jadual 10 siaran teratas dengan paparan, reaksi, pemajuan, pratonton teks

Carta dipaparkan secara asli di dalam PDF (melalui matplotlib) — bukan sebagai imej — jadi teks dan nombor kekal tajam pada mana-mana zum.

Penanggalan emoji

Disebabkan had fon dalam PDF, emoji dari teks siaran dialih keluar dalam laporan PDF. Teks asal penuh dikekalkan dalam eksport JSON dan CSV.

Dump JSON

Eksport berstruktur lengkap termasuk papan pemuka agregat serta data mentah:

  • Metadata saluran (id, tg_id, username, tajuk)
  • Objek statistik dengan semua metrik yang dikira
  • growth_series — setiap syot kilat pelanggan
  • snapshots — pasangan cap masa + pelanggan mentah
  • posts — setiap siaran dengan teks penuh, paparan, reaksi, pemajuan, media_type
  • heatmap — matriks 7×24
  • top_posts, content_mix

Sesuai untuk analisis lanjut dalam Python, Excel, atau mana-mana alat BI.

Eksport CSV

Jadual rata siaran untuk analisis hamparan:

  • Lajur: channel, date, msg_id, views, reactions, forwards, media_type, text
  • Pengekodan UTF-8 BOM (dibuka dengan betul dalam Excel)
  • Pembatas titik bertindih ; (mesra Excel dalam kebanyakan lokasi)
Cara mengeksport

Buka papan pemuka, klik Eksport dalam bar alat. Pilih format, pilih lokasi simpanan — selesai. Folder lalai ialah ~/.tg_analytics/exports/ tetapi anda boleh menukarnya dalam Tetapan.

Pengumpulan auto

Berapa kerap data diambil, dan cara mengkonfigurasikannya untuk keperluan anda.

Bagaimana ia berfungsi

Utas latar belakang bangun mengikut jadual dan mengemas kini setiap saluran yang dijejaki — satu demi satu, dengan jeda 3 saat antara saluran untuk mengelakkan pencetus perlindungan banjir Telegram.

  • Mengambil kiraan pelanggan semasa → syot kilat baharu
  • Mengemas kini paparan / reaksi / pemajuan pada 50 siaran terakhir
  • Mengimport siaran baharu jika ada yang muncul sejak larian terakhir
  • Membersihkan data lama sekali sehari (berdasarkan tetapan pengekalan anda)

Memilih selang

  • 15 minit — untuk saluran yang anda aktif kembangkan. Sejarah terperinci, lebih banyak panggilan API.
  • 30 minit — lalai yang disyorkan. Keseimbangan yang baik.
  • 1 jam — ringan untuk memantau banyak saluran.
  • 2–6 jam — untuk pemerhatian jangka panjang saluran pesaing.
  • Manual sahaja — tiada apa berlaku secara automatik; anda klik "Collect now" apabila anda memerlukan data baharu.

Di mana untuk mengkonfigurasi

1 Buka Tetapan

Bar sisi → Tetapan → bahagian Pengumpulan.

2 Tetapkan selang

Pilih dari dropdown. Perubahan terpakai serta-merta — tiada mulakan semula.

3 Pantau status

Tepat di bawah dropdown, "Status pengumpulan auto" menunjukkan: masa larian terakhir, ETA larian seterusnya, dan selang semasa.

Pengumpulan manual

Klik Collect now dalam Tetapan untuk muat semula semua saluran serta-merta. Bar atas menunjukkan pemutar dengan kemajuan semasa larian. Berguna sebelum menjana laporan.

Had kadar Telegram

Selang yang sangat pendek (bawah 15 minit) pada banyak saluran boleh mencetuskan FloodWait. Jika anda melihat ralat banjir yang kerap dalam log, tingkatkan selang.

Tetapan & tema

Bahasa, penampilan, pengekalan, folder eksport, log — semuanya boleh dikonfigurasikan.

Bahasa

5 bahasa disokong dalam antara muka: Inggeris, Rusia, Sepanyol, Portugis (BR), Jerman. Tukar dalam Tetapan → Bahasa — UI dikemas kini serta-merta tanpa mulakan semula.

Penampilan

Tiga mod:

  • Sistem (lalai) — mengikut keutamaan OS anda. Tukar tema OS dan aplikasi dikemas kini dalam masa nyata.
  • Gelap — tema gelap paksa.
  • Cerah — tema cerah paksa.

Anda juga boleh menogol tema dengan cepat dengan mengklik butang togol tema di penjuru kanan atas aplikasi.

Pengekalan

Berapa lama untuk menyimpan syot kilat dan siaran lama dalam pangkalan data setempat:

  • 30 / 90 / 180 hari — untuk persediaan ringan
  • 1 tahun — lalai yang disyorkan
  • Selamanya — jangan sekali-kali membersihkan apa-apa (pangkalan data akan berkembang)

Pembersihan harian berjalan di latar belakang dan memadam rekod lebih lama daripada tetingkap pengekalan.

Folder eksport

Tempat fail PDF / JSON / CSV disimpan. Lalai ialah ~/.tg_analytics/exports/. Tukar ke mana-mana folder melalui Tetapan → Pilih folder.

Log

Log aplikasi disimpan dalam ~/.tg_analytics/logs/:

  • app.log — log aktiviti umum dengan putaran (5 MB × 5 fail)
  • crash.log — hanya pengecualian tidak terkendali dengan jejak penuh

Klik "Buka folder" dalam Tetapan untuk membuka direktori log dalam pengurus fail anda. Berguna untuk melaporkan isu.

Zon bahaya

Butang "Padam semuanya" secara kekal mengalih keluar semua saluran yang dijejaki dan sejarahnya. Gunakannya jika anda mahu permulaan yang segar. Ia tidak menjejaskan data Telegram anda — hanya pangkalan data analitik setempat.

Penyelesaian masalah

Jawapan pantas kepada isu biasa.

Windows SmartScreen menyekat .exe — apa yang perlu dilakukan?

Klik More info dalam dialog, kemudian Run anyway. Ini berlaku kerana fail boleh laku tidak ditandatangani kod. Jika anda tidak mempercayainya, bina dari sumber: klon repo dan jalankan python build.py.

macOS berkata "App is damaged and can't be opened"

Buka Terminal dan jalankan: xattr -cr "/Applications/TG Analytics.app". Ini membuang atribut kuarantin yang ditambah macOS kepada aplikasi yang tidak ditandatangani. Selepas itu, klik kanan → Buka pada pelancaran pertama.

Carta pertumbuhan pelanggan hanya menunjukkan hari ini — adakah itu pepijat?

Tidak. Telegram tidak menyediakan sejarah pelanggan melalui APInya. Aplikasi merekodkan syot kilat dari saat anda mula menjejaki — jadi carta bermula dengan satu titik dan berkembang apabila pengumpulan baharu berlaku. Dengan selang 30 minit, anda akan mempunyai lengkung 24j penuh dalam masa sehari.

Ralat "FloodWait" semasa pengumpulan

Telegram mengehadkan kadar akaun anda. Tingkatkan selang pengumpulan auto (Tetapan → setiap 30 min atau lebih), dan kurangkan bilangan saluran yang dijejaki. Aplikasi mengendalikan FloodWait secara automatik dengan berhenti seketika — tetapi jika anda melihatnya kerap, tukar selang.

Saluran berkata "channel is private" apabila menambah mengikut @username

Hanya saluran awam boleh dijejaki secara luaran. Saluran peribadi (jemputan sahaja) tidak boleh diakses tanpa keahlian. Jika anda seorang ahli, saluran muncul dalam senarai admin anda secara automatik — semak tab Saluran.

Sesi tamat tempoh — saya perlu log masuk semula

Telegram mungkin membatalkan sesi jika anda log masuk dari terlalu banyak peranti atau menetapkan semula sesi secara manual dalam Telegram. Hanya klik Sign out dan log masuk semula dengan QR atau telefon. Saluran yang dijejaki dan data analitik anda dipelihara — ia hidup dalam pangkalan data setempat, bukan sesi.

Eksport PDF gagal dengan ralat

Kemungkinan besar isu fon yang hilang. Semak ~/.tg_analytics/logs/app.log untuk ralat tepat, dan buka isu di GitHub dengan petikan log. Sebagai penyelesaian, gunakan eksport JSON / CSV yang tidak memerlukan fon.

Di mana saya boleh mendapatkan bantuan?

Buka isu di GitHub Issues atau hantar mesej terus di Telegram: @igor_shelloff. Sertakan: apa yang anda lakukan, apa yang berlaku, dan (jika boleh) petikan log.

Sokong projek

TG Analytics adalah dan akan sentiasa percuma. Jika ia menjimatkan masa anda, inilah cara anda boleh membantu.

Bintang di GitHub

Bintang membantu orang lain menemui projek ini.

Buka repo
Laporkan pepijat

Menemui pepijat atau mempunyai idea ciri?

Buka isu
Derma melalui Boosty

Sokong pembangunan alat ini selanjutnya.

Derma
Sapa hello

Soalan atau maklum balas? Hantar mesej terus.

@igor_shelloff
Perlukan lebih daripada analitik?

Jika TG Analytics memberitahu anda apa yang berkesan, tetapi anda juga perlu menerbitkan dan menjangkau secara besar-besaran — cuba Telegram AutoPoster Pro oleh pembangun yang sama. Penyiaran berjadual, kempen DM, berbilang akaun, cerita, perlindungan henti auto, laporan dalam Telegram.

Terokai Telegram AutoPoster Pro