TG Analytics · الدليل الكامل

اقرأ قناتك كالمحترفين

ماذا يعني كل مقياس، كيف تقرأ لوحة التحكم، وكيف تتخذ قرارات أفضل من بيانات تيليجرام. مكتوب للمبتدئين — بأرقام ملموسة ومعايير واقعية.

البدء
فهم لوحة التحكم
متقدم
المزيد

مقدمة

ما هو TG Analytics، ولماذا المحلية أولاً مهمة، وماذا ستتعلم في هذا الدليل.

محلي أولاً، خاص بالتصميم

كل ما تتتبّعه مخزّن في قاعدة SQLite محلية على جهازك. لا حسابات، لا خوادم، لا قياسات عن بُعد. الكود المصدري الكامل على GitHub برخصة MIT.

TG Analytics تطبيق سطح مكتب مجاني يحوّل قنوات تيليجرام إلى بيانات واضحة وقابلة للتنفيذ. يعمل مع قنواتك (حيث أنت مشرف) وأي قناة عامة — مثالي لإدارة قناتك ودراسة المنافسين.

لماذا تطبيق سطح مكتب وليس SaaS؟

لأن منصات التحليلات مثل TGStat وTelemetr تتطلب منك تسليم بياناتك إلى خوادمها — والدفع عادةً مقابل الميزات المتقدمة. TG Analytics يبقي كل شيء على جهازك ويمنحك مجموعة الأدوات الكاملة مجاناً.

ما يمكنك فعله بـ TG Analytics

  • تتبّع نمو المشتركين — شاهد كيف يتغير جمهورك يوماً بيوم، ساعة بساعة.
  • قياس التفاعل (ER) — افهم ليس فقط عدد من شاهد المنشور، بل كيف تواصلوا معه.
  • اعرف أفضل وقت للنشر — خريطة حرارية 7×24 لمتوسط المشاهدات بناءً على بياناتك.
  • حدد أفضل المنشورات — تعلّم من الفائزين وكرر ما ينجح.
  • قارن القنوات — حتى 6 جنباً إلى جنب على نفس الشاشة.
  • صدّر التقارير — PDF مع مخططات للعملاء، أو CSV / JSON لمزيد من التحليل.
لا خبرة في Telegram API مطلوبة

لا تحتاج لمعرفة كيف تعمل واجهة تيليجرام. احصل على بيانات الاعتماد من my.telegram.org مرة واحدة — والباقي يتولاه التطبيق.

التحميل والتثبيت

ملفات تنفيذية مُجمّعة لجميع المنصات الرئيسية. لا تثبيت، لا تبعيات.

متطلبات النظام
  • ويندوز: 10 أو 11 (x64)
  • ماك: 11 (Big Sur) أو أحدث
  • لينكس: Ubuntu 22.04+ / مشابه مع WebKit2GTK
  • ذاكرة 2 جيجابايت كحد أدنى، ~150 ميجابايت مساحة حرة
  • اتصال إنترنت نشط للمزامنة
1 افتح صفحة الإصدارات

جميع الملفات التنفيذية الرسمية مُستضافة على GitHub:

افتح أحدث إصدار
2 حمّل الملف لنظامك
  • TGAnalytics-Windows.exe — ويندوز 10/11
  • TGAnalytics-Linux — لينكس (اجعله قابلاً للتنفيذ: chmod +x TGAnalytics-Linux)
  • TGAnalytics-macOS.zip — ماك (فك الضغط، اسحب .app إلى Applications)
3 شغّل التطبيق

احفظه في أي مكان مريح — سطح المكتب، المستندات، مجلد "أدوات" مخصص. انقر نقراً مزدوجاً للتشغيل. قد يستغرق التشغيل الأول 5–10 ثوانٍ أثناء فك ضغط الملف التنفيذي.

تحذير Windows SmartScreen

لأن الملف التنفيذي غير موقّع بشهادة توقيع كود مدفوعة، قد يعرض ويندوز تحذيراً. انقر مزيد من المعلومات ← تشغيل على أي حال. يمكنك أيضاً بناء التطبيق من المصدر إن فضّلت.

Gatekeeper على ماك

افتح Terminal ونفّذ xattr -cr "/Applications/TG Analytics.app" بعد نقل التطبيق إلى Applications. يزيل هذا علامة الحجر الصحي للتطبيقات غير الموقّعة.

بيانات اعتماد Telegram API

كل عميل تيليجرام يحتاج api_id وapi_hash من بوابة المطورين الرسمية. مجاني، يستغرق 3 دقائق.

ما API ID وAPI Hash؟

يعملان كـ "تسجيل مطوّر" لتيليجرام. كل عميل طرف ثالث له زوجه الخاص. ستنشئ زوجك الخاص — مجاني، آمن، ومرتبط فقط بحسابك.

1 اذهب إلى my.telegram.org

افتح https://my.telegram.org في متصفحك.

2 سجّل الدخول برقم هاتفك

أدخل الرقم بالصيغة الدولية مع + — مثلاً +79123456789. يرسل تيليجرام رمز تأكيد إلى تطبيقك.

3 افتح "API development tools"

بعد تسجيل الدخول، انقر API development tools في لوحة التحكم.

4 أنشئ تطبيقاً

املأ النموذج — تُخزَّن البيانات لدى تيليجرام لسجلاتها فقط. المنصة: Desktop. انقر Create application.

5 انسخ بيانات اعتمادك

سترى قيمتين — انسخ كلتيهما:

  • App api_id — رقم، مثلاً 1234567
  • App api_hash — سلسلة من 32 حرفاً، مثلاً abcdef1234567890abcdef1234567890
احتفظ بها خاصة

أي شخص لديه API ID وAPI Hash ورقم هاتفك قد يتمكن من الوصول إلى حسابك على تيليجرام. لا تشاركها أبداً في الدردشات أو لقطات الشاشة أو المنتديات العامة.

التفويض

طريقتان لتسجيل الدخول — اختر الأكثر راحة لك.

تسجيل الدخول بالهاتف (SMS / رمز في التطبيق)

1 املأ نموذج تسجيل الدخول

افتح شاشة Login وأدخل:

  • API ID — من my.telegram.org
  • API Hash — من my.telegram.org
  • الهاتف — بصيغة دولية مع +
2 انقر "Sign in" وأدخل الرمز

يرسل تيليجرام رمزاً إلى تطبيقك (أو SMS). تظهر نافذة — أدخل الرمز. إذا كانت المصادقة الثنائية مفعّلة، ستظهر مطالبة كلمة مرور بعدها.

تسجيل الدخول برمز QR (موصى به)

1 املأ API ID وAPI Hash

رقم الهاتف غير مطلوب لتسجيل الدخول بـ QR.

2 انقر "Sign in via QR"

تفتح نافذة QR. على هاتفك:

  1. افتح تيليجرام
  2. اذهب إلى Settings → Devices
  3. انقر Scan QR
  4. وجّه الكاميرا نحو الرمز على شاشتك

تُغلق النافذة تلقائياً عند النجاح.

تم تسجيل دخولك

يظهر اسمك في الشريط الجانبي. الجلسة مخزّنة محلياً — في المرة القادمة يفتح التطبيق وأنت مسجّل بالفعل.

أين تُخزَّن الجلسة؟

في ~/.tg_analytics/sessions/. على ويندوز هذا C:\Users\YourName\.tg_analytics\sessions\. لتسجيل الخروج كاملاً، استخدم زر "Sign out" في التطبيق.

إضافة قنوات للتتبع

نوعان من القنوات: قنواتك الخاصة (صلاحيات مشرف) وأي قناة عامة بـ @username.

قنواتك الخاصة

افتح قسم Channels. تظهر قنوات المشرف تلقائياً في الجانب الأيسر — يجلبها التطبيق من محادثاتك على تيليجرام.

1 انقر "Refresh"

يجلب التطبيق كل قناة أنت مشرف أو مالك فيها. قد يستغرق هذا 10–30 ثانية في التشغيل الأول.

2 انقر "Track" على القناة التي تريدها

تنتقل القناة إلى العمود الأيمن ("Tracked") ويبدأ التطبيق فوراً في استيراد آخر 100 منشور وعدد المشتركين الحالي.

أي قناة عامة (بحث المنافسين)

الميزة القاتلة — تتبّع أي قناة مفتوحة بـ @username أو رابط t.me/... أو معرّف رقمي.

1 انقر "Add public channel"

يفتح نافذة بحقل إدخال.

2 ألصق معرّف القناة

أمثلة لما يعمل:

  • durov
  • @durov
  • t.me/durov
  • https://t.me/durov
3 اضغط Enter أو "Add"

يحلّ التطبيق القناة ويعرض معاينة — العنوان، @username وعدد المشتركين. ثم يبدأ التتبع تلقائياً.

القنوات الخاصة لا يمكن تتبّعها

فقط القنوات العامة متاحة للتتبع الخارجي. إذا رأيت "channel is private" — تحتاج لتكون مشرفاً، أو القناة بدعوة فقط.

القنوات مقابل المجموعات

يركز TG Analytics على قنوات البث حيث النشر أحادي الاتجاه. المجموعات الفائقة والدردشات لا تُتبَّع — لها ديناميكيات ومقاييس مختلفة.

كل مقياس مشروح

ماذا يعني كل رقم، وكيف يُحسب، وكيف تبدو القيمة "الجيدة".

المشتركون

العدد الحالي للأشخاص المشتركين في القناة — نفس ما يعرضه تيليجرام علناً. يأخذ 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%+ صغير
التفاعلات

إجمالي عدد تفاعلات الإيموجي على منشور. إشارة قوية على تفاعل حقيقي — تتطلب التفاعلات نقرة نشطة، وليست قراءة سلبية فقط.

مجموع عدد كل التفاعلات على منشور
إعادة التوجيه

كم مرة أُعيد توجيه منشور إلى دردشة أو قناة أخرى. أوضح مؤشر على منشور "منتشر" — أعجب شخصاً بما يكفي لمشاركته مع جمهوره.

مباشرة من Telegram API
ER حسب نوع المحتوى

ER مقسّم حسب نوع المنشور: نص، صورة، فيديو، مستند، استطلاع. يُظهر بالضبط أي تنسيق يؤدي أفضل لجمهورك المحدد.

(avg_views_per_type / subscribers) × 100

كيف تفسر هذه الأرقام

  • ER يزيد + مشتركون ينمون — أنت على المسار الصحيح. استمر بما تفعله.
  • ER ينخفض + مشتركون ينمون — تجذب أشخاصاً أقل تفاعلاً (ربما من الإعلانات). قد يحتاج المحتوى للتعديل.
  • ER يزيد + مشتركون ثابتون — المحتوى يلقى صدى لكن التوزيع لا. فكر في الترويج المتقاطع.
  • ER ينخفض + مشتركون ينخفضون — هناك خطأ ما. قارن أفضل المنشورات بالحديثة وابحث عما تغيّر.
قاعدة عامة

لا تطارد الأرقام المطلقة. قناة بـ 3 آلاف مشترك و25% ER ومشتركون ينمون أصح من قناة بـ 100 ألف و2% ER. TG Analytics مبني ليريك الاتجاهات، لا المقاييس الزائفة.

مخطط نمو المشتركين

كيف تقرأ مخطط النمو، لماذا قد يعرض بيانات حديثة فقط، وما الذي تبحث عنه.

كيف يُبنى المخطط

في كل مرة يجمع TG Analytics البيانات، يحفظ "لقطة" من عدد المشتركين الحالي. المخطط خط زمني لتلك اللقطات. تتكيّف الدقة تلقائياً:

  • البيانات الحديثة (ساعات): كل قياس نقطة — ترى تفاصيل دقيقة.
  • الأيام: مجمّعة كل ساعة — نقطة لكل ساعة.
  • الأسابيع والأشهر: مجمّعة يومياً — نقطة لكل يوم.
لماذا يعرض مخططي اليوم فقط؟

لأن تيليجرام لا يعرض سجل المشتركين عبر API. لا يستطيع TG Analytics تسجيله إلا من لحظة بدء التتبع للقناة. بمرور الأيام والأسابيع، يمتلئ المخطط طبيعياً. المنشورات والمشاهدات والتفاعلات تُسحب من سجل تيليجرام نفسه — وتلك متاحة فوراً.

ما الذي تبحث عنه

  • ميل صاعد ثابت — نمو صحي. تتبّع زاوية الميل لمقارنة الفترات.
  • ارتفاعات مفاجئة — عادة ناتجة عن منشورات منتشرة أو إشارات أو إعلانات. اربطها بتواريخ المنشورات من قائمة أفضل المنشورات.
  • هضاب — لم يُشارَك المحتوى مؤخراً، أو القناة في توازن طبيعي.
  • انخفاضات مفاجئة — تنظيف المشتركين، منشور نفّر الناس، أو قناة كبيرة أسقطت إشارة.

مقارنة الفترات

بدّل بين تبويبات 7ي / 30ي / 90ي / كل الوقت لترى القناة نفسها بمستويات تكبير مختلفة:

  • 7ي — لقرارات أسبوعية: "هل نجحت حملتي الأخيرة فعلاً؟"
  • 30ي — الافتراضي. توازن جيد بين الضوضاء والإشارة.
  • 90ي — اتجاهات ربع سنوية، موسمية.
  • كل الوقت — السجل الكامل منذ بدء التتبع.
نصيحة احترافية: استخدم Δ المشتركين كمؤشر أداء رئيسي

بدلاً من الإجمالي، راقب التغيّر خلال 7 أيام. هذا ما أنتجه محتواك وتواصلك مؤخراً — الإجمالي معظمه تاريخ.

أفضل وقت للنشر (الخريطة الحرارية)

شبكة 7×24 تعرض متوسط المشاهدات حسب يوم الأسبوع والساعة، بناءً على قناتك.

كيف تقرأ الخريطة الحرارية

كل خلية تمثل تركيبة يوم أسبوع × ساعة يوم. كثافة اللون هي متوسط مشاهدات المنشورات المنشورة في تلك النافذة. أزرق داكن = مشاهدات عالية، أزرق فاتح = مشاهدات منخفضة، أبيض = لم تُنشر منشورات في تلك الفترة بعد.

مؤشر أفضل وقت

يبرز التطبيق تلقائياً أفضل فترة بحدود محددة ويعرض التسمية "Best: Tue, 17:00" في رأس البطاقة. هذه نافذة ذروة التفاعل المحسوبة.

ما تكتشفه معظم القنوات

  • فتحة الصباح (8:00–10:00) — المسافرون يفحصون تيليجرام في طريقهم للعمل. جيد للمحتوى القصير والقوي.
  • استراحة الغداء (12:00–14:00) — تفاعل متوسط، أوسع جمهور.
  • فتحة المساء (18:00–21:00) — ذروة التفاعل لمعظم القنوات. القراءات الطويلة والفيديوهات تعمل أفضل هنا.
  • عطلة نهاية الأسبوع — أنماط مختلفة تماماً. صباح السبت ومساء الأحد غالباً أعلى أداءً.
الخريطة الحرارية تحتاج بيانات

بأقل من 10 منشورات، ستكون الخريطة الحرارية فارغة تقريباً — لا توجد إشارة كافية. تصبح مفيدة حقاً بعد 30–50 منشوراً موزعة عبر أوقات مختلفة من اليوم.

استخدام الخريطة الحرارية عملياً

  1. افحص تسمية "Best time" — هذه فترتك الأعلى.
  2. انظر إلى الخريطة للخلايا الـ 3–4 الأكثر قتامة. تلك نوافذك الموثوقة.
  3. جدول أهم منشوراتك (إعلانات، إطلاقات، قراءات طويلة) في تلك الفترات.
  4. أعد فحص الخريطة شهرياً — تتغير عادات الجمهور موسمياً.

أفضل المنشورات ومزيج المحتوى

تعلّم من فائزيك — أي المنشورات لاقت أكبر صدى، وأي تنسيق يعمل أفضل.

أفضل المنشورات

أفضل 10 منشورات في الفترة المختارة، مرتبة حسب المشاهدات. كل صف يعرض:

  • الترتيب — 1 هو المنشور الأكثر مشاهدة
  • التاريخ — متى نُشر
  • المشاهدات — إجمالي عدد مرات رؤية المنشور
  • التفاعلات — عدد تفاعلات الإيموجي
  • إعادة التوجيه — عدد مرات مشاركته
  • معاينة النص — أول ~130 حرفاً
ما تفعله بهذه القائمة
  • اقرأ أفضل 3 منشورات جنباً إلى جنب. ما النمط المشترك؟
  • تحقق مما إذا كانت نُشرت في أوقات متشابهة — ارجع للخريطة الحرارية.
  • لاحظ التنسيق (نص طويل / قصير / مع وسائط) وحاول تكرار الصيغة الفائزة.
  • إذا حصل فائز على إعادة توجيه كثيرة — هذا موضوع يريد جمهورك مشاركته. اكتب المزيد عنه.

مزيج المحتوى

مخطط دائري يعرض كم تنشر من كل نوع، مع إحصاءات لكل نوع:

  • العدد — كم منشوراً من هذا النوع
  • متوسط المشاهدات — متوسط المشاهدات لكل منشور من هذا النوع
  • ER — معدل التفاعل لهذا النوع

الألوان: أزرق لـ النص، بنفسجي لـ الصورة، وردي لـ الفيديو، برتقالي لـ المستند، أخضر لـ الاستطلاع.

أمثلة على التفسير
  • الفيديو له 3× ER النص ← ضاعف الفيديو.
  • منشورات الصور تحصل على مشاهدات عالية لكن تفاعلات منخفضة ← المحتوى البصري يجذب العين لكنه لا يحرّك الفعل. اقرن الصور بتعليقات أقوى.
  • الاستطلاعات لها أعلى ER بكثير ← جمهورك يحب المشاركة. استخدم الاستطلاعات أكثر.
  • كل الأنواع تُظهر ER متشابهاً ← جمهورك يهتم بالموضوع لا بالتنسيق. ركّز على جودة المحتوى.

مقارنة القنوات

حتى 6 قنوات جنباً إلى جنب — لمحفظتك أو ضد المنافسين.

متى يكون مفيداً

  • تدير قنوات متعددة — اعرف أيها يستحق مزيداً من الجهد.
  • المعايرة التنافسية — تتبّع 2–3 منافسين مباشرين واعرف كيف تقارن.
  • تحليل الفئة — إذا كنت تفكر في دخول مجال، قارن 3–4 قنوات راسخة لفهم المعايير.
  • تقارير العملاء — إذا كنت تدير قنوات لعملاء، شاشة واحدة تعرضها كلها.

كيفية الاستخدام

1 افتح قسم Compare

اختر 2–6 قنوات من صف التبديل. تُختار أول قناتين تلقائياً.

2 اختر فترة

نفس تبويبات 7ي / 30ي / 90ي / الكل كما في لوحة التحكم.

3 اقرأ جدول المقارنة

الصفوف: مشتركون، Δ على الفترة، متوسط المشاهدات، ER، عدد المنشورات. الأعمدة: واحدة لكل قناة. كل عمود له شريط ملون يطابق مخطط الخطوط المتعددة بالأسفل.

4 انظر إلى مخطط الخطوط المتعددة

خط واحد لكل قناة على خط زمني مشترك — اكتشف فوراً أيها ينمو أسرع، أو أيها ثابت.

5 قارن متوسط المشاهدات وER

مخططان شريطيان بالأسفل: واحد لمتوسط المشاهدات، وآخر لـ ER. ER هو المقارنة الأعدل عندما تختلف أحجام القنوات جداً.

مقارنة عبر الأحجام — استخدم ER دائماً

قناة بـ 1 ألف وقناة بمليون لا يمكن مقارنتهما بالأرقام المطلقة. لكن إذا كانت قناة 1 ألف لديها 40% ER وقناة المليون لديها 8% ER، فالصغيرة أكثر تفاعلاً بكثير لكل مشترك. هذا النوع من الرؤى هو ما يتقاضى TGStat مقابله.

التصدير والتقارير

ثلاث صيغ — للعملاء، لمزيد من التحليل، أو للنسخ الاحتياطي.

تقرير PDF

تقرير A4 أنيق مصمم لإرساله للعملاء أو المديرين أو أصحاب المصلحة. يشمل:

  • رأس باسم القناة و@username والفترة وتاريخ الإنشاء
  • أربع بطاقات مؤشرات أداء رئيسية: المشتركون، متوسط المشاهدات، ER، عدد المنشورات
  • مخطط نمو المشتركين بتنسيق محاور مناسب
  • مخطط شريطي لمزيج المحتوى
  • خريطة حرارية لأفضل وقت للنشر
  • جدول أفضل 10 منشورات مع مشاهدات وتفاعلات وإعادة توجيه ومعاينة نص

تُصيَّر المخططات أصلاً داخل PDF (عبر matplotlib) — لا كصور — لذا تبقى النصوص والأرقام حادة عند أي مستوى تكبير.

إزالة الإيموجي

بسبب قيود الخطوط في PDF، تُزال الإيموجي من نصوص المنشورات في تقرير PDF. النص الأصلي الكامل محفوظ في تصديرات JSON وCSV.

تفريغ JSON

تصدير منظم كامل يشمل لوحة التحكم المجمّعة مع البيانات الأولية:

  • بيانات القناة (id، tg_id، username، العنوان)
  • كائن 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 في معظم اللغات)
كيف تصدّر

افتح لوحة التحكم، انقر Export في شريط الأدوات. اختر صيغة، اختر موقع حفظ — تم. المجلد الافتراضي هو ~/.tg_analytics/exports/ لكن يمكنك تغييره في الإعدادات.

الجمع التلقائي

كم مرة تُجلب البيانات، وكيف تُضبط لاحتياجاتك.

كيف يعمل

يستيقظ خيط خلفي وفق الجدول ويحدّث كل قناة متتبَّعة — واحدة في كل مرة، بتوقف 3 ثوانٍ بين القنوات لتجنب تفعيل حماية Flood في تيليجرام.

  • يجلب عدد المشتركين الحالي ← لقطة جديدة
  • يحدّث المشاهدات / التفاعلات / إعادة التوجيه على آخر 50 منشوراً
  • يستورد منشورات جديدة إن ظهرت أي منذ التشغيل الأخير
  • يحذف البيانات القديمة مرة يومياً (بناءً على إعداد الاحتفاظ)

اختيار فاصل زمني

  • 15 دقيقة — للقنوات التي تنمّيها بنشاط. سجل مفصل، استدعاءات API أكثر.
  • 30 دقيقة — الافتراضي الموصى به. توازن جيد.
  • ساعة — خفيف لمراقبة قنوات كثيرة.
  • 2–6 ساعات — للمراقبة طويلة الأمد لقنوات المنافسين.
  • يدوي فقط — لا شيء يحدث تلقائياً؛ تنقر "Collect now" عند الحاجة لبيانات حديثة.

أين تُضبط

1 افتح الإعدادات

الشريط الجانبي ← Settings ← قسم Collection.

2 اضبط الفاصل

اختر من القائمة المنسدلة. يُطبَّق التغيير فوراً — بلا إعادة تشغيل.

3 راقب الحالة

بالأسفل مباشرة، "Auto-collection status" يعرض: وقت التشغيل الأخير، الوقت المتوقع للتشغيل التالي، والفاصل الحالي.

الجمع اليدوي

انقر Collect now في الإعدادات لتحديث فوري لجميع القنوات. يعرض الشريط العلوي دوّاراً مع تقدم أثناء التشغيل. مفيد قبل إنشاء تقرير.

حدود معدل تيليجرام

الفترات القصيرة جداً (أقل من 15 دقيقة) على قنوات كثيرة قد تُفعّل FloodWait. إذا رأيت أخطاء flood متكررة في السجلات، زد الفاصل.

الإعدادات والمظاهر

اللغة، المظهر، الاحتفاظ، مجلد التصدير، السجلات — كل شيء قابل للضبط.

اللغة

5 لغات مدعومة في الواجهة: الإنجليزية والروسية والإسبانية والبرتغالية (BR) والألمانية. تُغيَّر في Settings → Language — تتحدّث الواجهة فوراً دون إعادة تشغيل.

المظهر

ثلاثة أوضاع:

  • System (افتراضي) — يتبع تفضيل نظامك. غيّر مظهر النظام ويتحدّث التطبيق في الوقت الحقيقي.
  • Dark — مظهر داكن مفروض.
  • Light — مظهر فاتح مفروض.

يمكنك أيضاً التبديل بين المظاهر بسرعة بالنقر على زر تبديل المظهر في الزاوية العلوية اليسرى من التطبيق.

الاحتفاظ

كم من الوقت تحتفظ باللقطات والمنشورات القديمة في قاعدة البيانات المحلية:

  • 30 / 90 / 180 يوماً — لإعدادات خفيفة
  • سنة — الافتراضي الموصى به
  • للأبد — عدم حذف أي شيء (ستنمو قاعدة البيانات)

يعمل تنظيف يومي في الخلفية ويحذف السجلات الأقدم من نافذة الاحتفاظ.

مجلد التصدير

أين تُحفظ ملفات PDF / JSON / CSV. الافتراضي ~/.tg_analytics/exports/. غيّره إلى أي مجلد عبر Settings → Choose folder.

السجلات

تُخزَّن سجلات التطبيق في ~/.tg_analytics/logs/:

  • app.log — سجل نشاط عام مع تدوير (5 ميجابايت × 5 ملفات)
  • crash.log — فقط الاستثناءات غير المعالجة مع تتبع كامل

انقر "Open folder" في الإعدادات لفتح مجلد السجلات في مدير الملفات. مفيد للإبلاغ عن المشاكل.

منطقة الخطر

زر "Delete everything" يحذف نهائياً كل القنوات المتتبَّعة وتاريخها. استخدمه إذا أردت بداية جديدة. لا يؤثر على بياناتك في تيليجرام — فقط قاعدة بيانات التحليلات المحلية.

استكشاف الأخطاء

إجابات سريعة للمشاكل الشائعة.

Windows SmartScreen يحجب ملف .exe — ماذا أفعل؟

انقر More info في الحوار، ثم Run anyway. يحدث هذا لأن الملف التنفيذي غير موقّع بشهادة. إذا كنت لا تثق، ابنِ من المصدر: استنسخ المستودع وشغّل python build.py.

ماك يقول "App is damaged and can't be opened"

افتح Terminal ونفّذ: xattr -cr "/Applications/TG Analytics.app". يزيل هذا خاصية الحجر الصحي التي يضيفها ماك للتطبيقات غير الموقّعة. بعد ذلك، انقر يميناً ← فتح عند التشغيل الأول.

مخطط نمو المشتركين يعرض اليوم فقط — هل هذا خطأ؟

لا. لا يوفر تيليجرام سجل المشتركين عبر API. يسجل التطبيق اللقطات من لحظة بدء التتبع — لذا يبدأ المخطط بنقطة واحدة وينمو عند حدوث عمليات جمع جديدة. بفاصل 30 دقيقة، ستحصل على منحنى 24 ساعة كامل خلال يوم.

أخطاء "FloodWait" أثناء الجمع

يقوم تيليجرام بتحديد معدل حسابك. زد فاصل الجمع التلقائي (Settings ← كل 30 دقيقة أو أكثر)، وقلل عدد القنوات المتتبَّعة. يتعامل التطبيق مع FloodWait تلقائياً بالتوقف المؤقت — لكن إذا رأيته كثيراً، غيّر الفاصل.

القناة تقول "channel is private" عند الإضافة بـ @username

فقط القنوات العامة يمكن تتبّعها خارجياً. القنوات الخاصة (بدعوة فقط) لا يمكن الوصول إليها بدون عضوية. إذا كنت عضواً، تظهر القناة في قائمة المشرف تلقائياً — افحص تبويب Channels.

الجلسة انتهت — أحتاج لتسجيل الدخول مجدداً

قد يُلغي تيليجرام جلسة إذا سجّلت الدخول من أجهزة كثيرة أو أعدت تعيين الجلسات يدوياً في تيليجرام. فقط انقر Sign out وسجّل الدخول مجدداً بـ QR أو الهاتف. قنواتك المتتبَّعة وبيانات التحليلات محفوظة — تعيش في قاعدة البيانات المحلية، لا في الجلسة.

تصدير PDF يفشل بخطأ

الأرجح مشكلة خط مفقود. افحص ~/.tg_analytics/logs/app.log للخطأ الدقيق، وافتح مشكلة على GitHub مع مقتطف السجل. كحل بديل، استخدم تصدير JSON / CSV اللذين لا يحتاجان خطوطاً.

أين يمكنني الحصول على مساعدة؟

افتح مشكلة على GitHub Issues أو راسلني مباشرة على تيليجرام: @igor_shelloff. اذكر: ماذا فعلت، ماذا حدث، و(إن أمكن) مقتطف سجل.

ادعم المشروع

TG Analytics مجاني وسيبقى كذلك دائماً. إذا وفّر عليك وقتاً، إليك كيف يمكنك المساعدة.

ضع نجمة على GitHub

النجوم تساعد الآخرين على اكتشاف المشروع.

افتح المستودع
أبلغ عن أخطاء

وجدت خطأً أو لديك فكرة ميزة؟

افتح مشكلة
تبرّع عبر Boosty

ادعم تطويراً إضافياً للأداة.

تبرّع
قل مرحباً

أسئلة أو ملاحظات؟ راسل مباشرة.

@igor_shelloff
تحتاج أكثر من التحليلات؟

إذا كان TG Analytics يخبرك بما ينجح، لكنك تحتاج أيضاً للنشر والتواصل على نطاق واسع — جرّب Telegram AutoPoster Pro من نفس المطوّر. نشر مجدول، حملات رسائل مباشرة، حسابات متعددة، ستوري، حماية إيقاف تلقائي، تقارير في تيليجرام.

استكشف Telegram AutoPoster Pro