التحليلات المتقدمة

تحليلات جغرافية وحسب الجهاز وعميل البريد الإلكتروني ووقت اليوم مع إمكانية تصدير البيانات

يوفّر 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 دقائق. تتضمن مفاتيح التخزين المؤقت معرّف المستأجر والنطاق الزمني ومرشح نوع الحدث، لذلك يتم تخزين الاستعلامات المختلفة بشكل مستقل.

الخطوات التالية

نظرة عامة على التحليلات: ملخصات الأحداث والنسب والإحصائيات اليومية
سجلات البريد الإلكتروني: البحث وفحص الرسائل الفردية
نظرة عامة على قابلية التسليم: سمعة المرسل ومقاييس مستوى مزوّد الخدمة

التحليلات المتقدمة

التحليلات الجغرافيةنسخ رابط القسم

تحليلات الأجهزةنسخ رابط القسم

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

عملاء البريد الإلكترونينسخ رابط القسم

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

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

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

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

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

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

في هذه الصفحة