MailLandDocs
Analytik

Erweiterte Analytics

Geografische, Geräte-, E-Mail-Client- und Tageszeit-Analytics mit Datenexport

MailLand bietet erweiterte Analytics-Endpoints für tiefere Einblicke, wo, wann und wie Empfänger mit Ihren E-Mails interagieren. Alle Daten stammen aus ClickHouse und werden 5 Minuten lang zwischengespeichert.

Öffnungen und Klicks enthalten automatisierte Aktivität, das Apple-Mail-Privacy-Protection-Prefetching und Sicherheits-Link-Scanner, die MailLand derzeit nicht herausfiltert. Jede Kennzahl auf dieser Seite, die aus Öffnungen oder Klicks abgeleitet ist (geografisch, Gerät, E-Mail-Client, Tageszeit), ist eine Obergrenze für menschliches Engagement, keine exakte Zählung.

Bei eventType=bounced und eventType=complained schließen die geografischen und Geräte-Endpunkte Zeilen ohne country_code bzw. device_type aus: da Bounce- und Beschwerde-Ereignisse diese Daten nicht enthalten, liefern beide Endpunkte für diese Ereignistypen normalerweise ein leeres Array. Der Tageszeit-Endpunkt hat keinen solchen Filter und liefert für jeden Ereignistyp echte Zählwerte.

Geografische Analytics

Sehen Sie, wo Ihre Empfänger interagieren, aufgeschlüsselt nach Land und Stadt:

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..."
ParameterTypStandardBeschreibung
fromdatetimevor 30 TagenStartdatum
todatetimeJetztEnddatum
eventTypestringopenedZu analysierendes Ereignis: 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
  }
]

Geräte-Analytics

Sehen Sie, welche Geräte und Browser Ihre Empfänger verwenden:

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..."
ParameterTypStandardBeschreibung
fromdatetimevor 30 TagenStartdatum
todatetimeJetztEnddatum
eventTypestringopenedZu analysierendes Ereignis: 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
  }
]

Tageszeit

Entdecken Sie, wann Empfänger am meisten interagieren, aufgeschlüsselt nach Stunde und Wochentag:

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..."
ParameterTypStandardBeschreibung
fromdatetimevor 30 TagenStartdatum
todatetimeJetztEnddatum
eventTypestringopenedZu analysierendes Ereignis: 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 }
]
FeldBeschreibung
hourStunde des Tages (0–23, UTC)
dayOfWeekWochentag (0 = Sonntag, 6 = Samstag)
eventCountAnzahl der Ereignisse in diesem Zeitfenster

E-Mail-Clients

Sehen Sie, welche E-Mail-Clients Ihre Empfänger für Öffnungen und Klicks verwenden:

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..."
ParameterTypStandardBeschreibung
fromdatetimevor 30 TagenStartdatum
todatetimeJetztEnddatum
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
  }
]

Interaktions-Heatmap

Eine kombinierte Öffnungen + Klicks-Heatmap nach Stunde und Wochentag abrufen, ideal zur Visualisierung optimaler Versandzeiten:

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..."
ParameterTypStandardBeschreibung
fromdatetimevor 30 TagenStartdatum
todatetimeJetztEnddatum
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 }
]

Dies liefert 168 Datenpunkte (24 Stunden x 7 Tage), wenn Daten für eine vollständige Woche verfügbar sind.

Datenexport

Analytics-Berichte als Excel oder PDF herunterladen:

Excel-Export

GET https://api.mail.land/v1/transactional/analytics/advanced/export/excel
ParameterTypStandardBeschreibung
fromdatetimevor 30 TagenStartdatum
todatetimeJetztEnddatum

Gibt eine .xlsx-Datei mit dem Content-Type application/vnd.openxmlformats-officedocument.spreadsheetml.sheet zurück. Der Dateiname folgt dem Format MailLand_Analytics_{from}_{to}.xlsx.

PDF-Export

GET https://api.mail.land/v1/transactional/analytics/advanced/export/pdf
ParameterTypStandardBeschreibung
fromdatetimevor 30 TagenStartdatum
todatetimeJetztEnddatum

Gibt eine .pdf-Datei mit dem Content-Type application/pdf zurück. Der Dateiname folgt dem Format 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..."

Zwischenspeicherung

Alle erweiterten Analytics-Endpoints werden 5 Minuten lang zwischengespeichert. Cache-Schlüssel beinhalten die Mandanten-ID, den Datumsbereich und den Ereignistyp-Filter, sodass verschiedene Abfragen unabhängig zwischengespeichert werden.

Nächste Schritte

E-Mail-Protokolle

Suchen, filtern und inspizieren Sie detaillierte Zustellprotokolle für jede über Mail.Land gesendete E-Mail

Authentifizierung

Authentifizieren Sie sich bei der Mail.Land API mit Bearer-Tokens oder API-Schlüsseln

Auf dieser Seite

Geografische AnalyticsGeräte-AnalyticsTageszeitE-Mail-ClientsInteraktions-HeatmapDatenexportExcel-ExportPDF-ExportZwischenspeicherungNächste Schritte