نظرة عامة على التحليلات

توفر MailLand تحليلات فورية مدعومة بـ ClickHouse لتجميع عالي الأداء عبر ملايين الأحداث. تتبع عمليات التسليم والفتح والنقر والارتداد والشكاوى مع نطاقات زمنية مرنة وتصفية حسب نوع البريد الإلكتروني.

ملخص الأحداثنسخ رابط القسم

احصل على أعداد مجمّعة للأحداث لفترة زمنية محددة:

GET https://api.mail.land/v1/transactional/analytics/events/summary

curl "https://api.mail.land/v1/transactional/analytics/events/summary?from=2026-01-18&to=2026-02-17" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

معاملات الاستعلامنسخ رابط القسم

{
  "from": "2026-01-18T00:00:00Z",
  "to": "2026-02-17T23:59:59Z",
  "sent": 142500,
  "delivered": 140325,
  "opened": 44878,
  "clicked": 5843,
  "bounced": 1125,
  "complained": 28,
  "source": "clickhouse",
  "data_source": "clickhouse",
  "is_degraded": false,
  "queryTimeMs": 45
}

الإحصائيات اليوميةنسخ رابط القسم

احصل على تفاصيل الأحداث يوميًا للرسم البياني:

GET https://api.mail.land/v1/transactional/analytics/stats/daily

curl "https://api.mail.land/v1/transactional/analytics/stats/daily?from=2026-01-18&to=2026-02-17" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

[
  {
    "date": "2026-02-17T00:00:00Z",
    "sent": 4750,
    "delivered": 4680,
    "opened": 1498,
    "clicked": 195,
    "bounced": 38
  },
  {
    "date": "2026-02-16T00:00:00Z",
    "sent": 4320,
    "delivered": 4260,
    "opened": 1380,
    "clicked": 175,
    "bounced": 32
  }
]

المعدلاتنسخ رابط القسم

احصل على معدلات التسليم والفتح والنقر محسوبةً كنسب مئوية:

GET https://api.mail.land/v1/transactional/analytics/rates

curl "https://api.mail.land/v1/transactional/analytics/rates?from=2026-01-18&to=2026-02-17" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

{
  "from": "2026-01-18T00:00:00Z",
  "to": "2026-02-17T23:59:59Z",
  "deliveryRate": 98.47,
  "openRate": 31.49,
  "clickRate": 13.02
}

حسابات المعدلات:

تُنفَّذ استعلامات المعدلات الثلاثة بالتوازي لتحقيق أفضل أداء.

الروابط الأعلى تفاعلًانسخ رابط القسم

اطّلع على الروابط الأكثر نقرًا عبر رسائلك الإلكترونية:

GET https://api.mail.land/v1/transactional/analytics/links/top

curl "https://api.mail.land/v1/transactional/analytics/links/top?from=2026-01-18&to=2026-02-17&limit=10" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

[
  {
    "url": "https://your-app.com/orders/track",
    "clicks": 2340,
    "uniqueRecipients": 1890
  },
  {
    "url": "https://your-app.com/dashboard",
    "clicks": 1150,
    "uniqueRecipients": 980
  }
]

حجم الإرسال بالساعةنسخ رابط القسم

تتبع حجم الإرسال بالساعة مع تراكب اختياري للخط الأساسي للكشف عن الشذوذ:

GET https://api.mail.land/v1/transactional/analytics/volume/hourly?days=7

curl "https://api.mail.land/v1/transactional/analytics/volume/hourly?days=7" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

[
  {
    "hour": "2026-02-17T14:00:00Z",
    "sent": 520,
    "baseline": 480.5
  },
  {
    "hour": "2026-02-17T13:00:00Z",
    "sent": 495,
    "baseline": 480.5
  }
]

baseline هو متوسط الحجم التاريخي لتلك الساعة من اليوم، تحسبه VolumeAnomalyWorker. تكون قيمته null إذا لم تتوفر بيانات أساسية بعد.

التخزين المؤقتنسخ رابط القسم

يتم تخزين نقاط نهاية التحليلات مؤقتًا من جهة الخادم لتقليل حمل الاستعلامات:

تُدمج نقطة النهاية events/summary الطلبات المتزامنة المتطابقة على مستوى كل خادم: يصل استعلام واحد فقط إلى ClickHouse لكل نسخة من الـ API، ويتلقى جميع المتصلين بتلك النسخة النتيجة ذاتها. أما نقاط النهاية الأخرى في هذه الصفحة فلا تدمج الطلبات؛ كل طلب يقرأ من ذاكرة التخزين المؤقت ثم يستعلم بشكل منفصل.

مصادر البياناتنسخ رابط القسم

تستخدم MailLand ClickHouse كمصدر بيانات تحليلية أساسي للتجميع السريع عبر مليارات الأحداث.

يشير حقل source في الاستجابات إلى مخزن البيانات الذي خدم النتيجة. يساعد حقل queryTimeMs في مراقبة الأداء.

الاحتفاظ بالبياناتنسخ رابط القسم

تتبع بيانات أحداث التحليلات خطة مساحة العمل: تُحفظ السجلات 30 يومًا في خطة Free، و90 يومًا في خطة Pro، و180 يومًا في خطة Max.

الخطوات التاليةنسخ رابط القسم

• سجلات البريد الإلكتروني: البحث وفحص عمليات تسليم البريد الإلكتروني الفردية
• التحليلات المتقدمة: تحليلات جغرافية وخاصة بالأجهزة وأوقات اليوم
• نظرة عامة على قابلية التسليم: سمعة المُرسِل والاتجاهات