التحليلات
ما تقيسه تحليلات TelegramOS فعليًا: أحداث الرسائل المرسلة والمستلمة لكل حساب، وكيف يتصرف مفتاح الخصوصية لكل مستخدم، ورؤى الذكاء الاصطناعي، والتصدير، ومدة الاحتفاظ.
تُبنى التحليلات من تدفق أحداث واحد: كل رسالة ترسلها حساباتك، وكل رسالة محادثة تستلمها، تُكتب في ClickHouse كصف في account_events. تقرأ صفحة التحليلات وبطاقات لوحة التحكم وعدّادات كل حساب من ذلك الجدول نفسه. تتطلب التحليلات خطة تتضمن قدرة analytics (جميع الخطط المدفوعة والفترة التجريبية).
ما يُتابَع
| الحدث | المصدر | البيانات الوصفية المستخدمة |
|---|---|---|
message_sent | العامل (worker)، عند كل إرسال صادر | نوع الطرف الآخر (مستخدم، بوت، مجموعة، قناة)؛ kind = رد أو إعادة توجيه |
message_received | مستمع الرسائل، للمحادثات الخاصة ورسائل المجموعات التي ترد على الحساب أو تشير إليه | نوع الطرف الآخر، is_reply، is_mention، media_type |
group_join | العامل، عند نجاح مهمة انضمام | يُحتسب ضمن "المجموعات المنضمّ إليها" |
error | العامل، عند الأعطال | الصفوف التي تحتوي على flood تُحتسب كحالات انتظار flood |
تُستثنى ردود مسبار الصحة SpamBot الخاص بتيليجرام من كل العدّادات. لا يُسجَّل أي شيء عن أوقات الاستجابة أو طول المحادثة أو استخدام أوامر البوت أو التفاعلات؛ والحقل reactions_given في API يساوي 0 دائمًا.
لوحة التحكم
اختر نافذة زمنية من 7 أو 14 أو 30 أو 90 يومًا. تقارن كل كتلة النافذة بالنافذة التي تسبقها مباشرةً.
- البطاقات الرئيسية: الرسائل المرسلة، الرسائل المستلمة، الحسابات النشطة (الحسابات التي لديها حدث واحد على الأقل) ونسبة الاستجابة (المستلمة مقسومة على المرسلة)، مع نسبة تغيير مئوية لكل منها.
- حجم الرسائل: المرسلة والمستلمة يوميًا.
- إلى أين تتدفق الرسائل: المرسلة والمستلمة بحسب نوع الطرف الآخر.
- تركيبة الصادر: الإرسال العادي والرد وإعادة التوجيه.
- الوسائط الواردة: الرسائل الواردة بحسب نوع الوسائط.
- النشاط بحسب الساعة: 24 فترة بتوقيت UTC.
- الخط الزمني للسبام وصحة الحساب: لكل حساب أو على مستوى الأسطول كله، حتى 180 يومًا. تأتي الرسائل وحالات انتظار flood من ClickHouse؛ ودرجة الصحة هي اللقطة الساعية في
account_health_log(تُحذف بعد 90 يومًا) وحالة السبام هي حكم SpamBot اليومي. تبدأ خطوط الصحة والسبام من وقت بدء التسجيل لذلك الحساب. - أعلى الحسابات: الحسابات العشرة الأكثر انشغالًا في النافذة.
- رؤى الذكاء الاصطناعي: زر يطلب ملخصًا مكتوبًا (انظر أدناه).
يكتب تصدير CSV التقرير المعروض على الشاشة (المجاميع، الفروقات، التركيبة، توزيع الأطراف، الوسائط، النشاط الساعي، أعلى الحسابات) إلى ملف في المتصفح. لا يوجد تصدير مجدول ولا تصدير للأحداث الخام.
تعرض صفحة الحسابات عدد الرسائل المرسلة والمستلمة اليوم والمجموعات المنضمّ إليها لكل حساب، مقروءةً من الجدول نفسه ومخزّنةً مؤقتًا لمدة 60 ثانية.
مفتاح الخصوصية
الإعدادات > الخصوصية > تحليلات الرسائل هو علم لكل مستخدم (analytics_enabled، مفعّل افتراضيًا).
| الحالة | الأثر |
|---|---|
| مفعّل | تُرجع جميع نقاط النهاية أعلاه البيانات |
| معطّل | يُرجع /analytics/summary أصفارًا مع analytics_enabled: false، ويُرجع /analytics/report فقط analytics_enabled: false، وتُرجع /analytics/daily و/analytics/velocity و/analytics/anomalies والخطوط الزمنية نتائج فارغة، ويُرجع /analytics/ai/summary ملخصًا فارغًا مع ملاحظة. تعرض الصفحة "Analytics is disabled for your account." |
إيقاف المفتاح يوقف القراءة لا الكتابة: تستمر الأحداث في الدخول، ولا يُجهَّل شيء ولا يُحذف، وإعادة تشغيله تُظهر التاريخ الكامل. وإذا تعذّرت قراءة العلم بسبب خطأ في قاعدة البيانات، تتصرف التحليلات كأنه معطّل.
بالنسبة للفرق، يحكم مفتاح المالك بيانات المالك: يرى العضو الذي يملك analytics:read تحليلات الفريق فقط ما دام مالك ذلك الفريق مفعّلًا للمفتاح.
رؤى الذكاء الاصطناعي
تُضبط ميزات الذكاء الاصطناعي بعلم على مستوى النشر كله هو AI_ENABLED.
- معطّل: يُرجع توليد الرؤى ملخصًا إحصائيًا محسوبًا من إشارات المقارنة الأسبوعية نفسها (الاتجاه، القيم الشاذة لكل حساب، فحص شذوذ الحجم). لا يُستدعى أي نموذج.
- مفعّل: تُرسل الإشارات إلى النموذج المهيّأ ويُعرض الرد. وإذا فشل الاستدعاء، يُرجع الملخص الإحصائي بدلًا منه.
عندما يكون النموذج مفعّلًا، تُحتسب إجراءات الذكاء الاصطناعي ضمن مخصص شهري لكل خطة (Free 10، Starter 500، Growth 5,000، Agency غير محدود؛ قابل للضبط على مستوى النشر). نقاط النهاية الأخرى للذكاء الاصطناعي (ملخص المحادثة، اقتراحات الرد، تحليل المشاعر، مخاطر الإرسال، تنويعات القوالب، الملخص اليومي) تعمل عند الطلب وتُحتسب ضمن المخصص نفسه. لا تُحلَّل أي رسالة واردة بواسطة نموذج إلا إذا شغّلت ذلك بنفسك.
مدة الاحتفاظ
| البيانات | مدة الاحتفاظ |
|---|---|
account_events (جميع أحداث الرسائل والأخطاء) | سنتان، ثم تُحذف عبر ClickHouse TTL |
| أحداث الشذوذ | 90 يومًا |
| لقطات صحة الحساب (Postgres) | 90 يومًا |
| أحداث موقع التسويق (مجهولة الهوية) | 12 شهرًا |
حدود API
- لا يجوز أن يمتد نطاق التاريخ المطلوب لأكثر من 366 يومًا.
- الدقة الساعية على
/analytics/dailyمحدودة بنافذة 7 أيام. - تقبل الخطوط الزمنية من 1 إلى 180 يومًا؛ والشذوذات من 1 إلى 30 يومًا؛ والسرعة من 1 إلى 168 ساعة.