TG Analytics · Hướng dẫn đầy đủ

Đọc kênh của bạn như một chuyên gia

Ý nghĩa của từng số liệu, cách đọc bảng điều khiển và cách đưa ra quyết định tốt hơn từ dữ liệu Telegram của bạn. Được viết cho người mới bắt đầu — với các con số cụ thể và tiêu chuẩn thực tế.

Bắt đầu
Hiểu bảng điều khiển
Nâng cao
Thêm

Giới thiệu

TG Analytics là gì, tại sao ưu tiên cục bộ lại quan trọng và bạn sẽ học được gì trong hướng dẫn này.

Ưu tiên cục bộ, thiết kế riêng tư

Mọi thứ bạn theo dõi được lưu trữ trong cơ sở dữ liệu SQLite cục bộ trên máy tính của bạn. Không tài khoản, không máy chủ, không đo từ xa. Toàn bộ mã nguồn trên GitHub theo Giấy phép MIT.

TG Analytics là một ứng dụng máy tính để bàn miễn phí biến các kênh Telegram của bạn thành dữ liệu rõ ràng, có thể hành động. Nó hoạt động với các kênh của riêng bạn (nơi bạn là quản trị viên) và bất kỳ kênh công khai nào — hoàn hảo cho cả việc điều hành kênh của bạn và nghiên cứu đối thủ cạnh tranh.

Tại sao lại là ứng dụng máy tính để bàn mà không phải SaaS?

Bởi vì các nền tảng phân tích như TGStat và Telemetr yêu cầu bạn phải giao dữ liệu của mình cho máy chủ của họ — và thường phải trả tiền cho các tính năng nâng cao. TG Analytics giữ mọi thứ trên máy của bạn và cung cấp toàn bộ bộ công cụ miễn phí.

Những gì bạn có thể làm với TG Analytics

  • Theo dõi tăng trưởng người đăng ký — xem đối tượng của bạn thay đổi như thế nào theo từng ngày, từng giờ.
  • Đo lường tương tác (ER) — hiểu không chỉ có bao nhiêu người đã xem bài viết mà còn mức độ kết nối của nó.
  • Tìm thời gian đăng tốt nhất — bản đồ nhiệt 7×24 về lượt xem trung bình, dựa trên dữ liệu của chính bạn.
  • Xác định bài viết hàng đầu — học hỏi từ những gì hiệu quả và lặp lại nó.
  • So sánh các kênh — tối đa 6 kênh cạnh nhau, trên cùng một màn hình.
  • Xuất báo cáo — PDF với biểu đồ cho khách hàng hoặc CSV / JSON để phân tích thêm.
Không cần kinh nghiệm Telegram API

Bạn không cần biết Telegram API hoạt động như thế nào. Chỉ cần lấy thông tin đăng nhập của bạn từ my.telegram.org một lần — và mọi thứ khác đều được ứng dụng xử lý.

Tải xuống & cài đặt

Tệp nhị phân dựng sẵn cho tất cả các nền tảng chính. Không cần cài đặt, không phụ thuộc.

Yêu cầu hệ thống
  • Windows: 10 hoặc 11 (x64)
  • macOS: 11 (Big Sur) trở lên
  • Linux: Ubuntu 22.04+ / tương tự với WebKit2GTK
  • RAM 2 GB tối thiểu, ~150 MB dung lượng đĩa trống
  • Kết nối internet hoạt động để đồng bộ
1 Mở trang Bản phát hành

Tất cả các bản dựng chính thức được lưu trữ trên GitHub:

Mở Bản phát hành mới nhất
2 Tải xuống tệp cho hệ điều hành của bạn
  • TGAnalytics-Windows.exe — Windows 10/11
  • TGAnalytics-Linux — Linux (làm cho nó có thể thực thi: chmod +x TGAnalytics-Linux)
  • TGAnalytics-macOS.zip — macOS (giải nén, kéo tệp .app vào Applications)
3 Chạy ứng dụng

Lưu nó ở bất kỳ nơi thuận tiện — Desktop, Documents, một thư mục "Công cụ" chuyên dụng. Nhấp đúp để khởi chạy. Lần khởi chạy đầu tiên có thể mất 5–10 giây trong khi tệp nhị phân giải nén.

Cảnh báo Windows SmartScreen

Vì tệp thực thi không được ký bằng chứng chỉ ký mã trả phí, Windows có thể hiển thị cảnh báo. Nhấp vào Thông tin khác → Chạy anyway. Bạn cũng có thể tự xây dựng ứng dụng từ mã nguồn nếu muốn.

macOS Gatekeeper

Mở Terminal và chạy xattr -cr "/Applications/TG Analytics.app" sau khi di chuyển ứng dụng vào Applications. Điều này loại bỏ cờ cách ly đối với các ứng dụng không được ký.

Thông tin đăng nhập Telegram API

Mỗi ứng dụng khách Telegram đều cần api_id và api_hash từ cổng thông tin nhà phát triển chính thức. Miễn phí, mất 3 phút.

API ID và API Hash là gì?

Chúng hoạt động như một "đăng nhập nhà phát triển" cho Telegram. Mỗi ứng dụng khách của bên thứ ba đều có cặp riêng. Bạn sẽ tạo của riêng mình — nó miễn phí, an toàn và chỉ được gắn với tài khoản của bạn.

1 Truy cập my.telegram.org

Mở https://my.telegram.org trong trình duyệt của bạn.

2 Đăng nhập bằng số điện thoại của bạn

Nhập số của bạn ở định dạng quốc tế với + — ví dụ +84912345678. Telegram sẽ gửi mã xác nhận đến ứng dụng của bạn.

3 Mở "API development tools"

Sau khi đăng nhập, nhấp vào Công cụ phát triển API trong bảng điều khiển.

4 Tạo một ứng dụng

Điền vào biểu mẫu — dữ liệu được Telegram lưu trữ cho hồ sơ của họ và không quan trọng đối với chức năng. Nền tảng: Desktop. Nhấp vào Tạo ứng dụng.

5 Sao chép thông tin đăng nhập của bạn

Bạn sẽ thấy hai giá trị — hãy sao chép cả hai:

  • App api_id — một số, ví dụ 1234567
  • App api_hash — một chuỗi 32 ký tự, ví dụ abcdef1234567890abcdef1234567890
Giữ những thông tin này riêng tư

Bất kỳ ai có API ID, API Hash và số điện thoại của bạn đều có thể truy cập tài khoản Telegram của bạn. Không bao giờ chia sẻ chúng trong cuộc trò chuyện, ảnh chụp màn hình hoặc diễn đàn công khai.

Ủy quyền

Hai phương thức đăng nhập — chọn phương thức thoải mái hơn cho bạn.

Đăng nhập bằng điện thoại (SMS / mã trong ứng dụng)

1 Điền vào biểu mẫu đăng nhập

Mở màn hình Đăng nhập và nhập:

  • API ID — từ my.telegram.org
  • API Hash — từ my.telegram.org
  • Số điện thoại — định dạng quốc tế với +
2 Nhấp "Đăng nhập" và nhập mã

Telegram gửi mã đến ứng dụng của bạn (hoặc SMS). Một hộp thoại xuất hiện — nhập mã. Nếu xác thực hai yếu tố được bật, lời nhắc mật khẩu sẽ xuất hiện tiếp theo.

Đăng nhập bằng mã QR (khuyến nghị)

1 Điền API ID và API Hash

Số điện thoại không cần thiết để đăng nhập bằng QR.

2 Nhấp "Đăng nhập qua QR"

Cửa sổ QR mở ra. Trên điện thoại của bạn:

  1. Mở Telegram
  2. Đi tới Cài đặt → Thiết bị
  3. Nhấn Quét QR
  4. Hướng camera vào mã QR trên màn hình của bạn

Cửa sổ tự động đóng khi thành công.

Bạn đã đăng nhập

Tên của bạn xuất hiện trong thanh bên. Phiên được lưu trữ cục bộ — lần tới khi mở ứng dụng, bạn đã đăng nhập sẵn.

Phiên được lưu trữ ở đâu?

Trong ~/.tg_analytics/sessions/. Trên Windows, đây là C:\Users\TenCuaBan\.tg_analytics\sessions\. Để đăng xuất hoàn toàn, hãy sử dụng nút "Đăng xuất" trong ứng dụng.

Thêm kênh để theo dõi

Hai loại kênh: kênh của riêng bạn (quyền quản trị viên) và bất kỳ kênh công khai nào bằng @username.

Kênh của riêng bạn

Mở phần Kênh. Các kênh quản trị của bạn sẽ tự động xuất hiện ở phía bên phải — ứng dụng sẽ kéo chúng từ các cuộc hội thoại Telegram của bạn.

1 Nhấp "Làm mới"

Ứng dụng tìm nạp mọi kênh mà bạn là quản trị viên hoặc chủ sở hữu. Quá trình này có thể mất 10–30 giây trong lần chạy đầu tiên.

2 Nhấp "Theo dõi" trên kênh bạn muốn

Kênh sẽ chuyển sang cột bên trái ("Đang theo dõi") và ứng dụng ngay lập tức bắt đầu nhập 100 bài viết cuối cùng và số lượng người đăng ký hiện tại.

Bất kỳ kênh công khai nào (nghiên cứu đối thủ cạnh tranh)

Tính năng sát thủ — theo dõi bất kỳ kênh mở nào bằng @username, liên kết t.me/... hoặc ID số.

1 Nhấp "Thêm kênh công khai"

Mở một hộp thư với trường nhập liệu.

2 Dán mã định danh kênh

Ví dụ về những gì hoạt động:

  • durov
  • @durov
  • t.me/durov
  • https://t.me/durov
3 Nhấn Enter hoặc nhấp "Thêm"

Ứng dụng phân giải kênh và hiển thị bản xem trước — tiêu đề, @username và số lượng người đăng ký. Sau đó, nó bắt đầu theo dõi tự động.

Không thể theo dõi các kênh riêng tư

Chỉ các kênh công khai mới có sẵn để theo dõi bên ngoài. Nếu bạn thấy "kênh là riêng tư" — bạn cần phải là quản trị viên hoặc kênh chỉ dành cho người được mời.

Kênh vs nhóm

TG Analytics tập trung vào các kênh phát sóng nơi việc đăng bài là một chiều. Các siêu nhóm và trò chuyện không được theo dõi — chúng có động lực và số liệu khác nhau.

Giải thích mọi số liệu

Mỗi con số có nghĩa là gì, nó được tính như thế nào và giá trị "tốt" trông như thế nào.

Người đăng ký

Số lượng người hiện đang đăng ký kênh — giống như những gì Telegram hiển thị công khai. TG Analytics chụp nhanh con số này trên mỗi chu kỳ thu thập, vì vậy bạn có thể thấy nó thay đổi như thế nào theo thời gian.

Trực tiếp từ Telegram API
Thay đổi người đăng ký (Δ)

Số lượng người đăng ký đã thay đổi bao nhiêu trong khoảng thời gian đã chọn. Tích cực = tăng trưởng, tiêu cực = suy giảm. Hiển thị hiệu ứng ròng của đăng ký mới trừ đi hủy đăng ký.

subscribers_now − subscribers_at_period_start
Lượt xem trung bình

Số lượt xem trung bình của tất cả các bài viết được xuất bản trong khoảng thời gian đã chọn. Đây là đường cơ sở của bạn — mỗi bài viết mới sẽ được đánh giá dựa trên nó.

sum(views) / number_of_posts
ER — Tỷ lệ tương tác

Số liệu quan trọng nhất để so sánh các kênh có quy mô khác nhau. Đó là tỷ lệ phần trăm người đăng ký đã xem bài viết trung bình của bạn. Một kênh có 100 nghìn người đăng ký và ER 15% là có tương tác; 500 nghìn người đăng ký với ER 2% là một vỏ rỗng.

(average_views / subscribers) × 100

Thông thường: 5–15% lớn, 15–40% trung bình, 40%+ nhỏ
Cảm xúc

Tổng số cảm xúc biểu tượng cảm xúc trên một bài viết. Một tín hiệu mạnh mẽ của sự tương tác thực sự — cảm xúc yêu cầu một cú nhấp chuột hoạt động, không chỉ đọc thụ động.

Tổng của tất cả các số lượng phản ứng trên một bài viết
Lượt chia sẻ

Một bài viết đã được chuyển tiếp đến một cuộc trò chuyện hoặc kênh khác bao nhiêu lần. Chỉ số rõ ràng nhất về một bài viết "lan truyền" — ai đó đã thích nó đủ để chia sẻ nó với đối tượng của riêng họ.

Trực tiếp từ Telegram API
ER loại nội dung

ER được phân tích theo loại bài viết: văn bản, ảnh, video, tài liệu, bình chọn. Điều này cho bạn thấy chính xác định dạng nào hoạt động tốt nhất cho đối tượng cụ thể của bạn.

(avg_views_per_type / subscribers) × 100

Cách diễn giải những con số này

  • ER tăng + người đăng ký tăng — bạn đang đi đúng hướng. Tiếp tục làm những gì bạn đang làm.
  • ER giảm + người đăng ký tăng — bạn đang thu hút những người ít tương tác hơn (có thể từ quảng cáo). Nội dung có thể cần điều chỉnh.
  • ER tăng + người đăng ký ổn định — nội dung được cộng hưởng nhưng phân phối thì không. Hãy xem xét quảng cáo chéo.
  • ER giảm + người đăng ký giảm — có điều gì đó không ổn. So sánh các bài viết hàng đầu với các bài viết gần đây và tìm những gì đã thay đổi.
Quy tắc ngón tay cái

Đừng chạy theo số liệu tuyệt đối. Một kênh 3k với ER 25% và người đăng ký đang tăng trưởng lành mạnh hơn một kênh 100k với ER 2%. TG Analytics được xây dựng để cho bạn thấy xu hướng, không phải số liệu ảo.

Biểu đồ tăng trưởng người đăng ký

Cách đọc biểu đồ tăng trưởng, tại sao nó có thể chỉ hiển thị dữ liệu gần đây và những gì cần tìm.

Biểu đồ được xây dựng như thế nào

Mỗi khi TG Analytics thu thập dữ liệu, nó lưu một "ảnh chụp nhanh" về số lượng người đăng ký hiện tại. Biểu đồ là một dòng thời gian của những ảnh chụp nhanh đó. Độ chi tiết tự động thích ứng:

  • Dữ liệu gần đây (giờ): mỗi phép đo là một điểm — bạn thấy chi tiết rõ ràng.
  • Ngày: tổng hợp hàng giờ — một điểm mỗi giờ.
  • Tuần và tháng: tổng hợp hàng ngày — một điểm mỗi ngày.
Tại sao biểu đồ của tôi chỉ hiển thị hôm nay?

Bởi vì Telegram không cung cấp lịch sử người đăng ký thông qua API. TG Analytics chỉ có thể ghi lại nó kể từ thời điểm bạn bắt đầu theo dõi kênh. Qua nhiều ngày và nhiều tuần, biểu đồ sẽ điền dần một cách tự nhiên. Bài viết, lượt xem và cảm xúc được lấy từ lịch sử của chính Telegram — những thứ đó có sẵn ngay lập tức.

Những gì cần tìm

  • Độ dốc tăng ổn định — tăng trưởng lành mạnh. Theo dõi góc dốc để so sánh các khoảng thời gian.
  • Đột biến — thường do bài viết lan truyền, đề cập hoặc quảng cáo. Tương quan với ngày đăng từ danh sách bài viết hàng đầu.
  • Cao nguyên — nội dung chưa được chia sẻ gần đây hoặc kênh đang ở trạng thái cân bằng tự nhiên.
  • Giảm đột ngột — dọn dẹp người đăng ký, một bài viết khiến mọi người xa lánh hoặc một kênh lớn đã bỏ đề cập.

So sánh khoảng thời gian

Chuyển đổi giữa các tab 7D / 30D / 90D / Mọi lúc để xem cùng một kênh ở các mức thu phóng khác nhau:

  • 7D — cho các quyết định hàng tuần: "chiến dịch cuối cùng của tôi có thực sự hiệu quả không?"
  • 30D — mặc định. Cân bằng tốt giữa nhiễu và tín hiệu.
  • 90D — xu hướng hàng quý, tính thời vụ.
  • Mọi lúc — toàn bộ lịch sử kể từ khi bạn bắt đầu theo dõi.
Mẹo chuyên nghiệp: sử dụng Δ Người đăng ký làm KPI của bạn

Thay vì tổng số, hãy theo dõi sự thay đổi trong 7 ngày. Đó là những gì nội dung và hoạt động tiếp cận gần đây của bạn thực sự tạo ra — tổng số chủ yếu là lịch sử.

Thời gian đăng tốt nhất (bản đồ nhiệt)

Lưới 7×24 hiển thị lượt xem trung bình theo ngày trong tuần và giờ, dựa trên kênh của chính bạn.

Cách đọc bản đồ nhiệt

Mỗi ô đại diện cho một tổ hợp ngày-trong-tuần × giờ-trong-ngày. Cường độ màu là số lượt xem trung bình của các bài viết được xuất bản trong khung thời gian đó. Xanh đậm = lượt xem cao, xanh nhạt = lượt xem thấp, trắng = chưa có bài viết nào được xuất bản trong ô đó.

Chỉ báo thời gian tốt nhất

Ứng dụng tự động làm nổi bật ô tốt nhất với đường viền và hiển thị nhãn "Tốt nhất: Thứ Ba, 17:00" trong tiêu đề thẻ. Đây là cửa sổ tương tác cao điểm được tính toán của bạn.

Những gì hầu hết các kênh khám phá

  • Khung buổi sáng (8:00–10:00) — người đi làm kiểm tra Telegram trên đường đi làm. Tốt cho nội dung ngắn gọn, súc tích.
  • Giờ nghỉ trưa (12:00–14:00) — tương tác trung bình, đối tượng rộng nhất.
  • Khung buổi tối (18:00–21:00) — tương tác cao điểm đối với hầu hết các kênh. Các bài đọc dài và video hoạt động tốt nhất ở đây.
  • Cuối tuần — các mẫu hoàn toàn khác. Sáng thứ Bảy và tối Chủ Nhật thường có hiệu suất cao.
Bản đồ nhiệt cần dữ liệu

Với ít hơn 10 bài viết, bản đồ nhiệt sẽ chủ yếu trống — không có đủ tín hiệu. Nó trở nên thực sự hữu ích sau 30–50 bài viết được phân bổ vào các thời điểm khác nhau trong ngày.

Sử dụng bản đồ nhiệt trong thực tế

  1. Kiểm tra nhãn "Thời gian tốt nhất" — đó là khung giờ hàng đầu của bạn.
  2. Nhìn vào bản đồ nhiệt cho 3–4 ô tối nhất. Đó là những cửa sổ đáng tin cậy của bạn.
  3. Lên lịch các bài viết quan trọng nhất của bạn (thông báo, ra mắt, bài đọc dài) vào những khung giờ đó.
  4. Kiểm tra lại bản đồ nhiệt hàng tháng — thói quen của đối tượng thay đổi theo mùa.

Bài viết hàng đầu & sự kết hợp nội dung

Học hỏi từ những người chiến thắng của bạn — bài viết nào được cộng hưởng nhiều nhất và định dạng nào hoạt động tốt nhất.

Bài viết hàng đầu

10 bài viết hàng đầu của khoảng thời gian đã chọn, được xếp hạng theo lượt xem. Mỗi hàng hiển thị:

  • Thứ hạng — 1 là bài viết được xem nhiều nhất
  • Ngày — khi nó được xuất bản
  • Lượt xem — tổng số lần bài viết được nhìn thấy
  • Cảm xúc — số lượng cảm xúc biểu tượng cảm xúc
  • Lượt chia sẻ — số lần nó được chia sẻ
  • Xem trước văn bản — ~130 ký tự đầu tiên
Những gì cần làm với danh sách này
  • Đọc 3 bài viết hàng đầu của bạn cạnh nhau. Mẫu chung là gì?
  • Kiểm tra xem chúng có được xuất bản vào thời điểm tương tự không — tham chiếu chéo với bản đồ nhiệt.
  • Ghi lại định dạng (văn bản dài / ngắn / có phương tiện) và cố gắng lặp lại công thức chiến thắng.
  • Nếu một người chiến thắng có nhiều lượt chia sẻ — đó là một chủ đề mà đối tượng của bạn muốn chia sẻ. Viết nhiều hơn về nó.

Sự kết hợp nội dung

Một biểu đồ hình bánh rán hiển thị bạn đã xuất bản bao nhiêu bài viết mỗi loại, với số liệu thống kê cho từng loại:

  • Số lượng — có bao nhiêu bài viết thuộc loại này
  • Lượt xem TB — lượt xem trung bình cho mỗi bài viết thuộc loại này
  • ER — tỷ lệ tương tác cho loại này

Màu sắc: xanh dương cho văn bản, tím cho ảnh, hồng cho video, cam cho tài liệu, xanh lá cho bình chọn.

Ví dụ diễn giải
  • Video có ER gấp 3 lần văn bản → tăng cường video.
  • Bài viết ảnh có lượt xem cao nhưng cảm xúc thấp → nội dung trực quan thu hút ánh nhìn nhưng không kích hoạt hành động. Kết hợp ảnh với chú thích mạnh mẽ hơn.
  • Bình chọn có ER cao nhất từ trước đến nay → đối tượng của bạn thích tham gia. Sử dụng bình chọn thường xuyên hơn.
  • Tất cả các loại đều có ER tương tự → đối tượng của bạn quan tâm đến chủ đề, không phải định dạng. Tập trung vào chất lượng nội dung.

So sánh các kênh

Tối đa 6 kênh cạnh nhau — cho danh mục đầu tư của bạn hoặc so với đối thủ cạnh tranh.

Khi nào nó hữu ích

  • Bạn điều hành nhiều kênh — xem kênh nào xứng đáng được nỗ lực nhiều hơn.
  • Đo lường đối thủ cạnh tranh — theo dõi 2–3 đối thủ cạnh tranh trực tiếp và xem bạn so sánh như thế nào.
  • Phân tích danh mục — nếu bạn đang cân nhắc tham gia một thích hợp, hãy so sánh 3–4 kênh đã thành lập để hiểu các tiêu chuẩn.
  • Báo cáo khách hàng — nếu bạn quản lý kênh cho khách hàng, một màn hình sẽ hiển thị tất cả chúng.

Cách sử dụng

1 Mở phần So sánh

Chọn 2–6 kênh từ hàng chuyển đổi. Hai kênh đầu tiên được chọn trước tự động.

2 Chọn khoảng thời gian

Các tab 7D / 30D / 90D / Mọi lúc giống như trên bảng điều khiển.

3 Đọc bảng so sánh

Các hàng: người đăng ký, Δ trong khoảng thời gian, lượt xem trung bình, ER, số lượng bài viết. Cột: một cột cho mỗi kênh. Mỗi cột có một dải màu khớp với biểu đồ đa dòng bên dưới.

4 Nhìn vào biểu đồ đa dòng

Một dòng cho mỗi kênh trên một dòng thời gian chung — ngay lập tức phát hiện kênh nào đang phát triển nhanh hơn hoặc kênh nào đang ổn định.

5 So sánh lượt xem trung bình và ER

Hai biểu đồ thanh bên dưới: một cho lượt xem trung bình, một cho ER. ER là so sánh công bằng nhất khi các kênh có quy mô rất khác nhau.

So sánh giữa các quy mô — luôn sử dụng ER

Không thể so sánh một kênh 1k và một kênh 1M bằng số liệu tuyệt đối. Nhưng nếu kênh 1k có ER 40% và kênh 1M có ER 8%, thì kênh nhỏ hơn có tương tác cao hơn nhiều trên mỗi người đăng ký. Đây là loại thông tin chi tiết mà TGStat tính phí.

Xuất & báo cáo

Ba định dạng — cho khách hàng, phân tích thêm hoặc sao lưu.

Báo cáo PDF

Một báo cáo A4 bóng bẩy được thiết kế để gửi cho khách hàng, người quản lý hoặc các bên liên quan. Bao gồm:

  • Tiêu đề với tên kênh, @username, khoảng thời gian và ngày tạo
  • Bốn thẻ KPI: người đăng ký, lượt xem trung bình, ER, số lượng bài viết
  • Biểu đồ tăng trưởng người đăng ký với định dạng trục thích hợp
  • Biểu đồ thanh sự kết hợp nội dung
  • Bản đồ nhiệt thời gian đăng tốt nhất
  • Bảng 10 bài viết hàng đầu với lượt xem, cảm xúc, lượt chia sẻ, xem trước văn bản

Biểu đồ được hiển thị nguyên bản bên trong PDF (thông qua matplotlib) — không phải dưới dạng hình ảnh — vì vậy văn bản và số liệu vẫn sắc nét ở mọi mức thu phóng.

Loại bỏ biểu tượng cảm xúc

Do hạn chế về phông chữ trong PDF, biểu tượng cảm xúc từ văn bản bài viết sẽ bị xóa trong báo cáo PDF. Văn bản gốc đầy đủ được giữ nguyên trong xuất JSON và CSV.

Kết xuất JSON

Một bản xuất có cấu trúc hoàn chỉnh bao gồm bảng điều khiển tổng hợp cộng với dữ liệu thô:

  • Siêu dữ liệu kênh (id, tg_id, username, title)
  • Đối tượng thống kê với tất cả các số liệu được tính toán
  • growth_series — mọi ảnh chụp nhanh người đăng ký
  • snapshots — cặp dấu thời gian + người đăng ký thô
  • posts — mọi bài viết với văn bản đầy đủ, lượt xem, cảm xúc, lượt chia sẻ, media_type
  • heatmap — ma trận 7×24
  • top_posts, content_mix

Hoàn hảo cho phân tích thêm trong Python, Excel hoặc bất kỳ công cụ BI nào.

Xuất CSV

Bảng phẳng của các bài viết để phân tích bảng tính:

  • Cột: channel, date, msg_id, views, reactions, forwards, media_type, text
  • Mã hóa UTF-8 BOM (mở đúng cách trong Excel)
  • Dấu phân cách chấm phẩy ; (thân thiện với Excel ở hầu hết các ngôn ngữ)
Cách xuất

Mở bảng điều khiển, nhấp vào Xuất trên thanh công cụ. Chọn định dạng, chọn vị trí lưu — xong. Thư mục mặc định là ~/.tg_analytics/exports/ nhưng bạn có thể thay đổi nó trong Cài đặt.

Tự động thu thập

Dữ liệu được tìm nạp thường xuyên như thế nào và cách định cấu hình nó cho nhu cầu của bạn.

Cách hoạt động

Một luồng nền thức dậy theo lịch trình và cập nhật mọi kênh được theo dõi — từng kênh một, với khoảng thời gian tạm dừng 3 giây giữa các kênh để tránh kích hoạt bảo vệ flood của Telegram.

  • Tìm nạp số lượng người đăng ký hiện tại → ảnh chụp nhanh mới
  • Cập nhật lượt xem / cảm xúc / lượt chia sẻ trên 50 bài viết cuối cùng
  • Nhập các bài viết mới nếu có bất kỳ bài nào xuất hiện kể từ lần chạy cuối
  • Thanh lọc dữ liệu cũ mỗi ngày một lần (dựa trên cài đặt lưu giữ của bạn)

Chọn khoảng thời gian

  • 15 phút — cho các kênh bạn đang tích cực phát triển. Lịch sử chi tiết, nhiều cuộc gọi API hơn.
  • 30 phút — mặc định được khuyến nghị. Cân bằng tốt.
  • 1 giờ — nhẹ nhàng để giám sát nhiều kênh.
  • 2–6 giờ — để quan sát lâu dài các kênh cạnh tranh.
  • Chỉ thủ công — không có gì xảy ra tự động; bạn nhấp vào "Thu thập ngay" khi cần dữ liệu mới.

Nơi định cấu hình

1 Mở Cài đặt

Thanh bên → Cài đặt → phần Thu thập.

2 Đặt khoảng thời gian

Chọn từ menu thả xuống. Thay đổi được áp dụng ngay lập tức — không cần khởi động lại.

3 Giám sát trạng thái

Ngay bên dưới menu thả xuống, "Trạng thái tự động thu thập" hiển thị: thời gian chạy cuối, ETA chạy tiếp theo và khoảng thời gian hiện tại.

Thu thập thủ công

Nhấp vào Thu thập ngay trong Cài đặt để làm mới ngay lập tức tất cả các kênh. Thanh trên cùng hiển thị vòng quay với tiến trình trong quá trình chạy. Hữu ích trước khi tạo báo cáo.

Giới hạn tốc độ Telegram

Khoảng thời gian rất ngắn (dưới 15 phút) trên nhiều kênh có thể kích hoạt FloodWait. Nếu bạn thấy lỗi flood thường xuyên trong nhật ký, hãy tăng khoảng thời gian.

Cài đặt & giao diện

Ngôn ngữ, giao diện, lưu giữ, thư mục xuất, nhật ký — mọi thứ đều có thể cấu hình.

Ngôn ngữ

5 ngôn ngữ được hỗ trợ trong giao diện: Tiếng Anh, Tiếng Nga, Tiếng Tây Ban Nha, Tiếng Bồ Đào Nha (BR), Tiếng Đức. Thay đổi trong Cài đặt → Ngôn ngữ — giao diện người dùng cập nhật ngay lập tức mà không cần khởi động lại.

Giao diện

Ba chế độ:

  • Hệ thống (mặc định) — theo tùy chọn hệ điều hành của bạn. Thay đổi hệ điều hành và ứng dụng sẽ cập nhật trong thời gian thực.
  • Tối — buộc giao diện tối.
  • Sáng — buộc giao diện sáng.

Bạn cũng có thể chuyển đổi nhanh qua các giao diện bằng cách nhấp vào nút chuyển đổi giao diện ở góc trên bên phải của ứng dụng.

Lưu giữ

Thời gian lưu giữ ảnh chụp nhanh và bài viết cũ trong cơ sở dữ liệu cục bộ:

  • 30 / 90 / 180 ngày — cho các thiết lập nhẹ nhàng
  • 1 năm — mặc định được khuyến nghị
  • Mãi mãi — không bao giờ xóa bất cứ thứ gì (cơ sở dữ liệu sẽ phát triển)

Quá trình dọn dẹp hàng ngày chạy trong nền và xóa các bản ghi cũ hơn cửa sổ lưu giữ.

Thư mục xuất

Nơi lưu các tệp PDF / JSON / CSV. Mặc định là ~/.tg_analytics/exports/. Thay đổi nó thành bất kỳ thư mục nào qua Cài đặt → Chọn thư mục.

Nhật ký

Nhật ký ứng dụng được lưu trữ trong ~/.tg_analytics/logs/:

  • app.log — nhật ký hoạt động chung với tính năng luân chuyển (5 MB × 5 tệp)
  • crash.log — chỉ các ngoại lệ chưa được xử lý với dấu vết đầy đủ

Nhấp vào "Mở thư mục" trong Cài đặt để mở thư mục nhật ký trong trình quản lý tệp của bạn. Hữu ích để báo cáo sự cố.

Vùng nguy hiểm

Nút "Xóa mọi thứ" sẽ xóa vĩnh viễn tất cả các kênh được theo dõi và lịch sử của chúng. Sử dụng nó nếu bạn muốn bắt đầu lại. Nó không ảnh hưởng đến dữ liệu Telegram của bạn — chỉ cơ sở dữ liệu phân tích cục bộ.

Khắc phục sự cố

Câu trả lời nhanh cho các vấn đề phổ biến.

Windows SmartScreen chặn tệp .exe — phải làm gì?

Nhấp vào Thông tin khác trong hộp thoại, sau đó nhấp vào Chạy anyway. Điều này xảy ra vì tệp thực thi không được ký mã. Nếu bạn không tin tưởng nó, hãy xây dựng từ mã nguồn: sao chép kho lưu trữ và chạy python build.py.

macOS báo "Ứng dụng bị hỏng và không thể mở"

Mở Terminal và chạy: xattr -cr "/Applications/TG Analytics.app". Điều này loại bỏ thuộc tính cách ly mà macOS thêm vào các ứng dụng không được ký. Sau đó, nhấp chuột phải → Mở trong lần khởi chạy đầu tiên.

Biểu đồ tăng trưởng người đăng ký chỉ hiển thị hôm nay — đó có phải là lỗi không?

Không. Telegram không cung cấp lịch sử người đăng ký thông qua API. Ứng dụng ghi lại ảnh chụp nhanh kể từ thời điểm bạn bắt đầu theo dõi — vì vậy biểu đồ bắt đầu với một điểm và phát triển khi các lần thu thập mới diễn ra. Với khoảng thời gian 30 phút, bạn sẽ có một đường cong 24 giờ đầy đủ trong vòng một ngày.

Lỗi "FloodWait" trong quá trình thu thập

Telegram đang giới hạn tốc độ tài khoản của bạn. Tăng khoảng thời gian tự động thu thập (Cài đặt → mỗi 30 phút trở lên) và giảm số lượng kênh được theo dõi. Ứng dụng xử lý FloodWait tự động bằng cách tạm dừng — nhưng nếu bạn thấy nó thường xuyên, hãy thay đổi khoảng thời gian.

Kênh báo "kênh là riêng tư" khi thêm bằng @username

Chỉ có thể theo dõi công khai các kênh bên ngoài. Các kênh riêng tư (chỉ dành cho người được mời) không thể truy cập nếu không phải là thành viên. Nếu bạn là thành viên, kênh sẽ tự động xuất hiện trong danh sách quản trị của bạn — hãy kiểm tra tab Kênh.

Phiên đã hết hạn — tôi cần đăng nhập lại

Telegram có thể thu hồi một phiên nếu bạn đăng nhập từ quá nhiều thiết bị hoặc đặt lại phiên thủ công trong Telegram. Chỉ cần nhấp vào Đăng xuất và đăng nhập lại bằng QR hoặc điện thoại. Các kênh được theo dõi và dữ liệu phân tích của bạn được giữ nguyên — chúng nằm trong cơ sở dữ liệu cục bộ, không phải trong phiên.

Xuất PDF không thành công với lỗi

Rất có thể là sự cố thiếu phông chữ. Kiểm tra ~/.tg_analytics/logs/app.log để biết lỗi chính xác và mở một vấn đề trên GitHub với đoạn trích nhật ký. Như một giải pháp thay thế, hãy sử dụng xuất JSON / CSV không yêu cầu phông chữ.

Tôi có thể nhận trợ giúp ở đâu?

Mở một vấn đề trên GitHub Issues hoặc nhắn tin trực tiếp trên Telegram: @igor_shelloff. Bao gồm: những gì bạn đã làm, những gì đã xảy ra và (nếu có thể) một đoạn trích nhật ký.

Hỗ trợ dự án

TG Analytics là và sẽ luôn miễn phí. Nếu nó giúp bạn tiết kiệm thời gian, đây là cách bạn có thể giúp đỡ.

Gắn sao trên GitHub

Sao giúp người khác khám phá dự án.

Mở kho lưu trữ
Báo cáo lỗi

Tìm thấy lỗi hoặc có ý tưởng tính năng?

Mở một vấn đề
Quyên góp qua Boosty

Hỗ trợ phát triển thêm công cụ.

Quyên góp
Chào hỏi

Câu hỏi hoặc phản hồi? Nhắn tin trực tiếp.

@igor_shelloff
Cần nhiều hơn phân tích?

Nếu TG Analytics cho bạn biết điều gì hiệu quả, nhưng bạn cũng cần xuất bản và tiếp cận ở quy mô lớn — hãy thử Telegram AutoPoster Pro của cùng nhà phát triển. Đăng bài theo lịch, chiến dịch DM, đa tài khoản, story, bảo vệ tự động dừng, báo cáo trong Telegram.

Khám phá Telegram AutoPoster Pro