Analitiğe Genel Bakış

MailLand, milyonlarca olay üzerinde yüksek performanslı toplama için ClickHouse tarafından desteklenen gerçek zamanlı analizler sunar. Esnek tarih aralıkları ve e-posta türü filtreleme ile teslimatları, açılmaları, tıklamaları, geri dönmeleri ve şikayetleri takip edin.

Olay ÖzetiBölüm bağlantısını kopyala

Bir dönem için toplu olay sayılarını alın:

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

Sorgu ParametreleriBölüm bağlantısını kopyala

{
  "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
}

Günlük İstatistiklerBölüm bağlantısını kopyala

Grafik çizmek için günlük olay dökümlerini alın:

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
  }
]

OranlarBölüm bağlantısını kopyala

Yüzde olarak hesaplanan teslimat, açılma ve tıklama oranlarını alın:

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
}

Oran hesaplamaları:

Üç oran sorgusu da en iyi performans için paralel olarak yürütülür.

En Çok Tıklanan BağlantılarBölüm bağlantısını kopyala

E-postalarınızda en çok tıklanan bağlantıları görün:

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
  }
]

Saatlik HacimBölüm bağlantısını kopyala

Anomali tespiti için isteğe bağlı temel çizgi katmanlı olarak saate göre gönderim hacmini takip edin:

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 tarafından hesaplanan günün o saatine ait tarihsel ortalama hacimdir. Henüz temel veri yoksa null olur.

Önbelleğe AlmaBölüm bağlantısını kopyala

Analitik uç noktaları, sorgu yükünü en aza indirmek için sunucu tarafında önbelleğe alınır:

events/summary uç noktası, eş zamanlı özdeş istekleri sunucu başına birleştirir: API örneği başına ClickHouse'a yalnızca bir sorgu ulaşır ve o örnekteki tüm arayanlar aynı sonucu alır. Bu sayfadaki diğer uç noktalar istekleri birleştirmez; her biri önce önbelleği okur, sonra sorgular.

Veri KaynaklarıBölüm bağlantısını kopyala

MailLand, milyarlarca olay üzerinde hızlı toplama için birincil analitik veri kaynağı olarak ClickHouse kullanır.

Yanıtlardaki source alanı, sonucu hangi veri deposunun sunduğunu gösterir. queryTimeMs alanı performansın izlenmesine yardımcı olur.

SaklamaBölüm bağlantısını kopyala

Analitik olay verileri, çalışma alanının planını izler: günlükler Free planında 30 gün, Pro planında 90 gün ve Max planında 180 gün saklanır.

Sonraki AdımlarBölüm bağlantısını kopyala

• E-posta Kayıtları: bireysel e-posta teslimatlarını arayın ve inceleyin
• Gelişmiş Analitik: coğrafi, cihaz ve günün saatine göre analizler
• Teslim Edilebilirliğe Genel Bakış: gönderen itibarı ve eğilimler