MailLandDocs
Teslim Edilebilirlik

Teslim Edilebilirlik Genel Bakış

Tüm alan adlarınızda gönderici itibarını, teslim oranlarını ve DNS durumunu izleyin

MailLand, gönderici itibarınızı bileşik bir puan, teslim eğilimleri, sağlayıcı düzeyinde analizler ve DNS durum izleme aracılığıyla takip eder. Bu metrikleri kendi kontrol panellerinizde görüntülemek veya itibar düştüğünde uyarı tetiklemek için teslim edilebilirlik API'sini kullanabilirsiniz.

Gönderici Puanı

Dört ağırlıklı bileşene ayrılmış 0–100 arasında bir itibar puanı alın:

GET https://api.mail.land/v1/deliverability/score

Authorization: Bearer <token> veya X-API-Key: <api key> ile kimlik doğrulayın.

Get sender score
curl https://api.mail.land/v1/deliverability/score \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."
Sender score response
{
  "totalScore": 87,
  "label": "Good",
  "hasSufficientData": true,
  "totalSentLast30Days": 142500,
  "dnsScore": {
    "name": "DNS Authentication",
    "score": 25,
    "maxScore": 25,
    "detail": "2/2 domains fully authenticated"
  },
  "bounceScore": {
    "name": "Bounce Rate",
    "score": 20,
    "maxScore": 25,
    "detail": "Bounce rate: 1.80%"
  },
  "complaintScore": {
    "name": "Complaint Rate",
    "score": 25,
    "maxScore": 25,
    "detail": "Complaint rate: 0.020%"
  },
  "engagementScore": {
    "name": "Engagement",
    "score": 25,
    "maxScore": 25,
    "detail": "Open rate: 32.0%"
  },
  "calculatedAt": "2026-02-17T12:00:00Z"
}

Her bileşen 25 puana kadar katkıda bulunur. Son 30 günde 100'den az gönderim varsa hasSufficientData değeri false olur. totalScore yine de hesaplanır, ancak bu hacimde anlamlı değildir: hiç gönderim yokken sıçrama ve şikayet bileşenlerinin her biri tam puan (25) alır, bu yüzden hiçbir şey göndermemiş yepyeni bir hesap bile 75 puana kadar görünebilir.

Puan Geçmişi

Puanınızın zaman içindeki değişimini takip edin:

GET https://api.mail.land/v1/deliverability/score/history?days=30
Get score history
curl "https://api.mail.land/v1/deliverability/score/history?days=30" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."
ParametreTürVarsayılanAçıklama
daysint30Geçmiş penceresi (7–90)
Score history response
[
  {
    "date": "2026-02-17",
    "totalScore": 87,
    "label": "Good",
    "dnsScore": 25,
    "bounceScore": 22,
    "complaintScore": 25,
    "engagementScore": 15,
    "bounceRate": 0.8,
    "complaintRate": 0.02,
    "openRate": 32.0,
    "deliveryRate": 98.5,
    "totalSent": 4750,
    "hasSufficientData": true
  }
]

Teslim Edilebilirlik Genel Bakış İstatistikleri

Bir dönem için toplu teslim metriklerini alın:

GET https://api.mail.land/v1/deliverability/overview?days=30
Get deliverability overview
curl "https://api.mail.land/v1/deliverability/overview?days=30" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."
ParametreTürVarsayılanAçıklama
daysint30Dönem penceresi (7, 30 veya 90'a normalleştirilir)
Overview response
{
  "totalSent": 142500,
  "totalDelivered": 140325,
  "totalBounced": 1125,
  "totalComplained": 28,
  "totalOpened": 44878,
  "totalClicked": 5843,
  "totalUnsubscribed": 312,
  "deliveryRate": 98.47,
  "bounceRate": 0.79,
  "complaintRate": 0.02,
  "openRate": 31.49,
  "clickRate": 4.1,
  "unsubscribeRate": 0.22
}

Günlük Eğilimler

Eğilimleri görselleştirmek için günlük teslim metriklerini alın:

GET https://api.mail.land/v1/deliverability/trends?days=30
Get daily trends
curl "https://api.mail.land/v1/deliverability/trends?days=30" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."
Trends response (abbreviated)
[
  {
    "date": "2026-02-17T00:00:00Z",
    "sent": 4750,
    "delivered": 4680,
    "bounced": 38,
    "complained": 1,
    "opened": 1498,
    "deliveryRate": 98.53,
    "bounceRate": 0.8,
    "complaintRate": 0.02,
    "openRate": 31.53
  }
]

Sağlayıcı Dağılımı

Alıcı posta kutusu sağlayıcısına (Gmail, Yahoo, Outlook vb.) göre gruplandırılmış teslim edilebilirlik metriklerini görün:

GET https://api.mail.land/v1/deliverability/providers?days=30&limit=10
Get provider breakdown
curl "https://api.mail.land/v1/deliverability/providers?days=30&limit=10" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."
ParametreTürVarsayılanAçıklama
daysint30Dönem penceresi (7, 30 veya 90'a normalleştirilir)
limitint10Döndürülecek maksimum sağlayıcı sayısı (1–50)
Provider breakdown response
[
  {
    "domain": "gmail.com",
    "sent": 58200,
    "delivered": 57800,
    "bounced": 210,
    "opened": 19500,
    "clicked": 2540,
    "complained": 8,
    "deliveryRate": 99.31,
    "openRate": 33.51,
    "bounceRate": 0.36
  },
  {
    "domain": "outlook.com",
    "sent": 31400,
    "delivered": 30800,
    "bounced": 350,
    "opened": 8650,
    "clicked": 1120,
    "complained": 12,
    "deliveryRate": 98.09,
    "openRate": 27.55,
    "bounceRate": 1.11
  }
]

Geri Dönüş Dağılımı

Geri dönüşleri tür ve nedene göre sınıflandırılmış olarak görün:

GET https://api.mail.land/v1/deliverability/bounce-breakdown?days=30
Get bounce breakdown
curl "https://api.mail.land/v1/deliverability/bounce-breakdown?days=30" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."
Bounce breakdown response
{
  "hardBounces": 450,
  "softBounces": 625,
  "blockedBounces": 40,
  "unknownBounces": 10,
  "totalBounces": 1125,
  "topReasons": [
    { "reason": "InvalidRecipient", "count": 380 },
    { "reason": "QuotaIssues", "count": 290 },
    { "reason": "SpamBlock", "count": 40 },
    { "reason": "BadDomain", "count": 70 },
    { "reason": "PolicyRelated", "count": 95 },
    { "reason": "TransientFailure", "count": 55 }
  ]
}

topReasons, MTA'nın kendi sınıflandırma adlarını kullanır (tam kelime dağarcığı için bkz. Geri Dönüşler); işlemsel geri dönüş uç noktalarının kullandığı anahtar kelime türetilmiş snake_case kategorilerini değil.

Tam geri dönüş kategori ayrıntıları ve işleme davranışı için Geri Dönüşler sayfasına bakın.

DNS Durumu

Tüm alan adlarınızdaki DNS kimlik doğrulama durumunu kontrol edin:

GET https://api.mail.land/v1/deliverability/dns-status
Get DNS status
curl https://api.mail.land/v1/deliverability/dns-status \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."
DNS status response
[
  {
    "domainId": "k3v9x2m8q1w7z4",
    "domainName": "yourdomain.com",
    "spfStatus": "Valid",
    "dkimStatus": "Valid",
    "dmarcStatus": "Valid",
    "lastCheckedAt": "2026-02-17T10:00:00Z",
    "isFullyAuthenticated": true
  },
  {
    "domainId": "n7p2q9x4m8w1z3",
    "domainName": "notifications.yourdomain.com",
    "spfStatus": "Valid",
    "dkimStatus": "Valid",
    "dmarcStatus": "Invalid",
    "lastCheckedAt": "2026-02-17T10:00:00Z",
    "isFullyAuthenticated": false
  }
]

Bir alan adı yalnızca SPF, DKIM ve DMARC değerlerinin tamamı Valid olduğunda isFullyAuthenticated değerine sahip olur.

DurumAçıklama
PendingKayıt henüz kontrol edilmedi
ValidKayıt doğru yapılandırılmış
InvalidKayıt eksik veya yanlış yapılandırılmış

Öneriler

Gönderici itibarınızı geliştirmek için uygulanabilir öneriler alın:

GET https://api.mail.land/v1/deliverability/recommendations
Get recommendations
curl https://api.mail.land/v1/deliverability/recommendations \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."
Recommendations response
[
  {
    "id": "dns_dmarc_missing_notifications.yourdomain.com",
    "category": "dns",
    "severity": "critical",
    "titleKey": "deliverability.recommendations.dns.dmarcMissing.title",
    "descriptionKey": "deliverability.recommendations.dns.dmarcMissing.description",
    "actionUrl": "/domains",
    "impact": 8,
    "parameters": {
      "domain": "notifications.yourdomain.com"
    }
  },
  {
    "id": "bounce_high",
    "category": "bounce",
    "severity": "warning",
    "titleKey": "deliverability.recommendations.bounce.high.title",
    "descriptionKey": "deliverability.recommendations.bounce.high.description",
    "actionUrl": "/deliverability",
    "impact": 15
  }
]
AlanTürAçıklama
idstringÖneri tanımlayıcısı. Sabit bir enum değildir: DNS kimlikleri alan adını içerir (örneğin dns_dmarc_missing_{domain}), bu yüzden iki alan adındaki aynı sorun iki farklı kimlik üretir.
categorystringdns, bounce, complaint, engagement, warmup veya volume
severitystringcritical, warning veya info
impactintDüzeltildiğinde potansiyel puan iyileştirmesi (0–100)
actionUrlstringSorunu gidermek için ön uç rotası: /domains, /deliverability, /suppression-lists, /analytics veya /dashboard'dan biri
parametersobjecti18n enterpolasyonu için değerler. Yalnızca DNS önerilerinde bulunur ({"domain": "..."}); sıçrama, şikayet, etkileşim, ısıtma ve hacim önerilerinde parameters yoktur.

En fazla 10 öneri döndürülür; önce önem derecesine (önce kritik), ardından etkiye göre azalan sırayla sıralanır.

Önbelleğe Alma

Tüm teslim edilebilirlik uç noktaları, ClickHouse üzerindeki sorgu yükünü azaltmak için sunucu tarafında önbelleğe alınır:

Uç NoktaÖnbellek TTL
/score15 dakika
/overview5 dakika
/trends3 dakika
/providers5 dakika
/bounce-breakdown5 dakika
/score/historyÖnbelleğe alınmaz
/dns-statusÖnbelleğe alınmaz (gerçek zamanlı)
/recommendations10 dakika

days parametresi 7, 30 veya 90'a normalleştirilir: ≤ 7 olan değerler 7'ye, 8–30 arası değerler 30'a, 30'un üzerindeki her değer ise 90'a yuvarlanır. 14 gibi bir değer 7'ye değil, 30'a yuvarlanır.

Sonraki Adımlar

DKIM Anahtar Rotasyonu

Gönderim alan adınız için DKIM imzalama anahtarları

Geri Dönmeler

Geri dönme türlerini, kategorilerini, otomatik baskılama ve yeniden deneme davranışını anlayın

Bu sayfada

Gönderici PuanıPuan GeçmişiTeslim Edilebilirlik Genel Bakış İstatistikleriGünlük EğilimlerSağlayıcı DağılımıGeri Dönüş DağılımıDNS DurumuÖnerilerÖnbelleğe AlmaSonraki Adımlar