آمار و تحلیل پیشرفته

تحلیل جغرافیایی، دستگاه، سرویس‌گیرنده ایمیل و ساعت روز با امکان خروجی‌گرفتن از داده‌ها

MailLand نقاط پایانی آمار و تحلیل پیشرفته برای بینش عمیق‌تر درباره مکان، زمان و نحوه تعامل گیرندگان با ایمیل‌های شما ارائه می‌دهد. تمام داده‌ها از ClickHouse تامین شده و به مدت 5 دقیقه کش می‌شوند.

بازشدن‌ها و کلیک‌ها شامل فعالیت ماشینی هم می‌شوند؛ یعنی پیش‌بارگذاری Apple Mail Privacy Protection و اسکنرهای امنیتی لینک که MailLand فعلاً آن‌ها را فیلتر نمی‌کند. هر معیار این صفحه که از بازشدن‌ها یا کلیک‌ها گرفته شده (جغرافیایی، دستگاه، سرویس‌گیرندهٔ ایمیل، ساعت روز) یک سقف بالا برای تعامل انسانی است، نه شمارشی دقیق.

برای eventType=bounced و eventType=complained، نقاط پایانی جغرافیایی و دستگاه، ردیف‌های بدون country_code یا device_type را کنار می‌گذارند: از آنجا که رویدادهای برگشتی و شکایت این داده‌ها را ندارند، این دو نقطهٔ پایانی معمولاً برای این نوع رویدادها یک آرایهٔ خالی برمی‌گردانند. نقطهٔ پایانی ساعتِ روز چنین فیلتری ندارد و برای هر نوع رویداد، شمارش‌های واقعی برمی‌گرداند.

تحلیل جغرافیایی

مشاهده کنید که گیرندگان شما از کجا تعامل دارند، با تفکیک بر اساس کشور و شهر:

GET https://api.mail.land/v1/transactional/analytics/advanced/geographic

Get geographic analytics

curl "https://api.mail.land/v1/transactional/analytics/advanced/geographic" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

پارامتر	نوع	پیش‌فرض	توضیحات
`from`	datetime	30 روز قبل	تاریخ شروع
`to`	datetime	اکنون	تاریخ پایان
`eventType`	string	`opened`	رویداد مورد تحلیل: `opened`، `clicked`، `bounced`، `complained`

Geographic analytics response

[
  {
    "countryCode": "US",
    "city": "San Francisco",
    "eventCount": 3420,
    "uniqueUsers": 2850
  },
  {
    "countryCode": "DE",
    "city": "Berlin",
    "eventCount": 1280,
    "uniqueUsers": 1100
  },
  {
    "countryCode": "GB",
    "city": "London",
    "eventCount": 950,
    "uniqueUsers": 820
  }
]

تحلیل دستگاه

مشاهده کنید که گیرندگان شما از چه دستگاه‌ها و مرورگرهایی استفاده می‌کنند:

GET https://api.mail.land/v1/transactional/analytics/advanced/devices

Get device analytics

curl "https://api.mail.land/v1/transactional/analytics/advanced/devices" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

پارامتر	نوع	پیش‌فرض	توضیحات
`from`	datetime	30 روز قبل	تاریخ شروع
`to`	datetime	اکنون	تاریخ پایان
`eventType`	string	`opened`	رویداد مورد تحلیل: `opened`، `clicked`، `bounced`، `complained`

Device analytics response

[
  {
    "deviceType": "desktop",
    "browser": "Chrome",
    "emailClient": "Gmail",
    "eventCount": 5200,
    "uniqueUsers": 4100
  },
  {
    "deviceType": "mobile",
    "browser": "Safari",
    "emailClient": "Apple Mail",
    "eventCount": 3800,
    "uniqueUsers": 3200
  },
  {
    "deviceType": "desktop",
    "browser": "Firefox",
    "emailClient": "Thunderbird",
    "eventCount": 420,
    "uniqueUsers": 380
  }
]

ساعت روز

کشف کنید که گیرندگان بیشتر در چه زمانی تعامل دارند، با تفکیک بر اساس ساعت و روز هفته:

GET https://api.mail.land/v1/transactional/analytics/advanced/time-of-day

Get time of day analytics

curl "https://api.mail.land/v1/transactional/analytics/advanced/time-of-day" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

پارامتر	نوع	پیش‌فرض	توضیحات
`from`	datetime	30 روز قبل	تاریخ شروع
`to`	datetime	اکنون	تاریخ پایان
`eventType`	string	`opened`	رویداد مورد تحلیل: `opened`، `clicked`، `bounced`، `complained`

Time of day response

[
  { "hour": 9, "dayOfWeek": 1, "eventCount": 1240 },
  { "hour": 10, "dayOfWeek": 1, "eventCount": 1580 },
  { "hour": 14, "dayOfWeek": 2, "eventCount": 1120 },
  { "hour": 9, "dayOfWeek": 3, "eventCount": 1350 }
]

فیلد	توضیحات
`hour`	ساعت روز (0 تا 23، UTC)
`dayOfWeek`	روز هفته (0 = یکشنبه، 6 = شنبه)
`eventCount`	تعداد رویدادها در این بازه زمانی

سرویس‌گیرنده‌های ایمیل

مشاهده کنید که گیرندگان شما برای بازکردن و کلیک از چه سرویس‌گیرنده‌های ایمیلی استفاده می‌کنند:

GET https://api.mail.land/v1/transactional/analytics/advanced/email-clients

Get email clients

curl "https://api.mail.land/v1/transactional/analytics/advanced/email-clients" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

پارامتر	نوع	پیش‌فرض	توضیحات
`from`	datetime	30 روز قبل	تاریخ شروع
`to`	datetime	اکنون	تاریخ پایان

Email clients response

[
  {
    "emailClient": "Gmail",
    "opens": 15200,
    "clicks": 1980,
    "uniqueUsers": 12500
  },
  {
    "emailClient": "Apple Mail",
    "opens": 8400,
    "clicks": 1100,
    "uniqueUsers": 7200
  },
  {
    "emailClient": "Outlook",
    "opens": 6800,
    "clicks": 850,
    "uniqueUsers": 5900
  }
]

نقشه حرارتی تعامل

یک نقشه حرارتی ترکیبی از بازشدن و کلیک بر اساس ساعت و روز هفته دریافت کنید، ایده‌آل برای تجسم بهترین زمان ارسال:

GET https://api.mail.land/v1/transactional/analytics/advanced/engagement-heatmap

Get engagement heatmap

curl "https://api.mail.land/v1/transactional/analytics/advanced/engagement-heatmap" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

پارامتر	نوع	پیش‌فرض	توضیحات
`from`	datetime	30 روز قبل	تاریخ شروع
`to`	datetime	اکنون	تاریخ پایان

Engagement heatmap response

[
  { "hour": 9, "dayOfWeek": 1, "opens": 1240, "clicks": 160 },
  { "hour": 10, "dayOfWeek": 1, "opens": 1580, "clicks": 205 },
  { "hour": 14, "dayOfWeek": 2, "opens": 1120, "clicks": 145 },
  { "hour": 9, "dayOfWeek": 3, "opens": 1350, "clicks": 175 }
]

این خروجی 168 نقطه داده (24 ساعت در 7 روز) ارائه می‌دهد، در صورتی که داده‌ها برای یک هفته کامل در دسترس باشند.

خروجی‌گرفتن از داده‌ها

گزارش‌های آماری را به صورت Excel یا PDF دانلود کنید:

خروجی Excel

GET https://api.mail.land/v1/transactional/analytics/advanced/export/excel

پارامتر	نوع	پیش‌فرض	توضیحات
`from`	datetime	30 روز قبل	تاریخ شروع
`to`	datetime	اکنون	تاریخ پایان

فایل .xlsx با نوع محتوای application/vnd.openxmlformats-officedocument.spreadsheetml.sheet بازگردانده می‌شود. نام فایل از الگوی MailLand_Analytics_{from}_{to}.xlsx پیروی می‌کند.

خروجی PDF

GET https://api.mail.land/v1/transactional/analytics/advanced/export/pdf

پارامتر	نوع	پیش‌فرض	توضیحات
`from`	datetime	30 روز قبل	تاریخ شروع
`to`	datetime	اکنون	تاریخ پایان

فایل .pdf با نوع محتوای application/pdf بازگردانده می‌شود. نام فایل از الگوی MailLand_Analytics_{from}_{to}.pdf پیروی می‌کند.

Download Excel report

curl -o analytics.xlsx \
  "https://api.mail.land/v1/transactional/analytics/advanced/export/excel?from=2026-01-01&to=2026-02-01" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

کش‌گذاری

تمام نقاط پایانی آمار و تحلیل پیشرفته به مدت 5 دقیقه کش می‌شوند. کلیدهای کش شامل شناسه tenant، بازه زمانی و فیلتر نوع رویداد هستند، بنابراین درخواست‌های مختلف به صورت مستقل کش می‌شوند.

مراحل بعدی

نمای کلی آمار و تحلیل: خلاصه رویدادها، نرخ‌ها و آمار روزانه
گزارش ایمیل‌ها: جستجو و بررسی ایمیل‌های جداگانه
نمای کلی تحویل‌پذیری: اعتبار فرستنده و معیارهای سطح ارائه‌دهنده

آمار و تحلیل پیشرفته

تحلیل جغرافیاییکپی پیوند بخش

تحلیل دستگاهکپی پیوند بخش

ساعت روزکپی پیوند بخش

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

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

خروجی‌گرفتن از داده‌هاکپی پیوند بخش

خروجی Excelکپی پیوند بخش

خروجی PDFکپی پیوند بخش

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

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

در این صفحه