MailLandDocs
Analitik

Gelişmiş Analitikler

Coğrafi, cihaz, e-posta istemcisi ve gün içindeki saat bazlı analitikler ile veri dışarı aktarımı

MailLand, alıcılarınızın e-postalarınızla nerede, ne zaman ve nasıl etkileşim kurduğuna dair daha derin içgörüler sunan gelişmiş analitik endpoint'leri sağlar. Tüm veriler ClickHouse'dan alınır ve 5 dakika boyunca önbelleklenir.

Açılmalar ve tıklamalar, MailLand'in bugün filtrelemediği otomatik etkinliği, Apple Mail Privacy Protection ön yüklemesi ve güvenlik bağlantı tarayıcıları, içerir. Bu sayfadaki açılma veya tıklamalardan türetilen her ölçüm (coğrafi, cihaz, e-posta istemcisi, günün saati) insan etkileşimi için bir üst sınırdır, kesin bir sayım değildir.

eventType=bounced ve eventType=complained için coğrafi ve cihaz uç noktaları, country_code veya device_type değeri olmayan satırları hariç tutar: geri dönüş (bounce) ve şikayet olayları bu verileri taşımadığından, bu iki uç nokta bu olay türleri için normalde boş bir dizi döndürür. Günün saati uç noktasında böyle bir filtre yoktur ve her olay türü için gerçek sayıları döndürür.

Coğrafi Analitikler

Alıcılarınızın ülke ve şehir bazında nerelerden etkileşim kurduğunu görün:

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..."
ParametreTürVarsayılanAçıklama
fromdatetime30 gün önceBaşlangıç tarihi
todatetimeŞimdiBitiş tarihi
eventTypestringopenedAnaliz edilecek olay: 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
  }
]

Cihaz Analitikleri

Alıcılarınızın hangi cihazları ve tarayıcıları kullandığını görün:

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..."
ParametreTürVarsayılanAçıklama
fromdatetime30 gün önceBaşlangıç tarihi
todatetimeŞimdiBitiş tarihi
eventTypestringopenedAnaliz edilecek olay: 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
  }
]

Gün İçindeki Saat

Alıcıların en çok ne zaman etkileşim kurduğunu saat ve haftanın günü bazında keşfedin:

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..."
ParametreTürVarsayılanAçıklama
fromdatetime30 gün önceBaşlangıç tarihi
todatetimeŞimdiBitiş tarihi
eventTypestringopenedAnaliz edilecek olay: 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 }
]
AlanAçıklama
hourGünün saati (0–23, UTC)
dayOfWeekHaftanın günü (0 = Pazar, 6 = Cumartesi)
eventCountBu zaman dilimindeki olay sayısı

E-posta İstemcileri

Alıcılarınızın açılma ve tıklamalar için hangi e-posta istemcilerini kullandığını görün:

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..."
ParametreTürVarsayılanAçıklama
fromdatetime30 gün önceBaşlangıç tarihi
todatetimeŞimdiBitiş tarihi
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
  }
]

Etkileşim Isı Haritası

En uygun gönderim zamanlarını görselleştirmek için ideal olan, saat ve haftanın gününe göre birleşik açılma + tıklama ısı haritasını alın:

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..."
ParametreTürVarsayılanAçıklama
fromdatetime30 gün önceBaşlangıç tarihi
todatetimeŞimdiBitiş tarihi
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 }
]

Tam bir haftalık veri mevcut olduğunda 168 veri noktası (24 saat x 7 gün) sağlar.

Veri Dışarı Aktarımı

Analitik raporlarını Excel veya PDF olarak indirin:

Excel Dışarı Aktarımı

GET https://api.mail.land/v1/transactional/analytics/advanced/export/excel
ParametreTürVarsayılanAçıklama
fromdatetime30 gün önceBaşlangıç tarihi
todatetimeŞimdiBitiş tarihi

application/vnd.openxmlformats-officedocument.spreadsheetml.sheet içerik türüyle bir .xlsx dosyası döndürür. Dosya adı MailLand_Analytics_{from}_{to}.xlsx formatını takip eder.

PDF Dışarı Aktarımı

GET https://api.mail.land/v1/transactional/analytics/advanced/export/pdf
ParametreTürVarsayılanAçıklama
fromdatetime30 gün önceBaşlangıç tarihi
todatetimeŞimdiBitiş tarihi

application/pdf içerik türüyle bir .pdf dosyası döndürür. Dosya adı MailLand_Analytics_{from}_{to}.pdf formatını takip eder.

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..."

Önbellekleme

Tüm gelişmiş analitik endpoint'leri 5 dakika boyunca önbelleklenir. Önbellek anahtarları kiracının kimliğini, tarih aralığını ve olay türü filtresini içerir, böylece farklı sorgular birbirinden bağımsız olarak önbelleklenir.

Sonraki Adımlar

E-posta Kayıtları

Mail.Land üzerinden gönderilen her e-posta için ayrıntılı teslimat kayıtlarını arayın, filtreleyin ve inceleyin

Kimlik Doğrulama

Bearer token veya API anahtarları kullanarak Mail.Land API ile kimlik doğrulama

Bu sayfada

Coğrafi AnalitiklerCihaz AnalitikleriGün İçindeki SaatE-posta İstemcileriEtkileşim Isı HaritasıVeri Dışarı AktarımıExcel Dışarı AktarımıPDF Dışarı AktarımıÖnbelleklemeSonraki Adımlar