نمای کلی تحلیل‌ها

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 درخواست‌های هم‌زمان یکسان را به ازای هر سرور ادغام می‌کند: تنها یک پرس‌وجو به ازای هر نمونهٔ API به ClickHouse می‌رسد و همهٔ فراخوانی‌های همان نمونه نتیجهٔ یکسانی دریافت می‌کنند. سایر نقاط پایانی این صفحه درخواست‌ها را ادغام نمی‌کنند؛ هر کدام نخست حافظهٔ نهان را می‌خواند و سپس پرس‌وجو می‌زند.

منابع دادهکپی پیوند بخش

MailLand از ClickHouse به عنوان منبع اصلی داده تحلیلی برای تجمیع سریع در میلیاردها رویداد استفاده می‌کند.

فیلد source در پاسخ‌ها نشان می‌دهد کدام منبع داده نتیجه را ارائه کرده است. فیلد queryTimeMs به نظارت بر عملکرد کمک می‌کند.

نگه‌داری دادهکپی پیوند بخش

داده‌های رویداد تحلیلی از پلن فضای کاری پیروی می‌کنند: لاگ‌ها در پلن Free تا ۳۰ روز، در پلن Pro تا ۹۰ روز و در پلن Max تا ۱۸۰ روز نگه‌داشته می‌شوند.

مراحل بعدیکپی پیوند بخش

• گزارش ایمیل‌ها: جستجو و بررسی تحویل‌های ایمیل منفرد
• تحلیل‌های پیشرفته: تحلیل‌های جغرافیایی، دستگاه و زمان روز
• نمای کلی قابلیت تحویل: شهرت فرستنده و روندها