Analytics – Übersicht

MailLand bietet Echtzeit-Analytics auf Basis von ClickHouse für leistungsstarke Aggregationen über Millionen von Ereignissen. Verfolgen Sie Zustellungen, Öffnungen, Klicks, Bounces und Beschwerden mit flexiblen Datumsbereichen und Filterung nach E-Mail-Typ.

EreigniszusammenfassungLink zum Abschnitt kopieren

Aggregierte Ereignisanzahlen für einen Zeitraum abrufen:

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

AbfrageparameterLink zum Abschnitt kopieren

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

Tägliche StatistikenLink zum Abschnitt kopieren

Tägliche Ereignisaufschlüsselungen für Diagramme abrufen:

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

RatenLink zum Abschnitt kopieren

Zustellungs-, Öffnungs- und Klickraten als Prozentsätze abrufen:

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
}

Ratenberechnungen:

Alle drei Ratenabfragen werden parallel ausgeführt, um optimale Leistung zu erzielen.

Top-LinksLink zum Abschnitt kopieren

Die meistgeklickten Links in Ihren E-Mails anzeigen:

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

Stündliches VolumenLink zum Abschnitt kopieren

Sendevolumen pro Stunde verfolgen, optional mit Baseline-Überlagerung zur Anomalieerkennung:

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

Die baseline ist das historische Durchschnittsvolumen für diese Tagesstunde, berechnet vom VolumeAnomalyWorker. Sie ist null, wenn noch keine Baseline-Daten verfügbar sind.

CachingLink zum Abschnitt kopieren

Analytics-Endpunkte werden serverseitig gecacht, um die Abfragelast zu minimieren:

Der Endpunkt events/summary fasst gleichzeitige identische Anfragen pro Server zusammen: nur eine Abfrage erreicht ClickHouse pro API-Instanz, und alle Aufrufer dieser Instanz erhalten dasselbe Ergebnis. Die übrigen Endpunkte auf dieser Seite fassen nicht zusammen; jede Anfrage liest zunächst den Cache und fragt dann ab.

DatenquellenLink zum Abschnitt kopieren

MailLand verwendet ClickHouse als primäre Analytics-Datenquelle für schnelle Aggregationen über Milliarden von Ereignissen.

Das Feld source in den Antworten zeigt an, welcher Datenspeicher das Ergebnis geliefert hat. Das Feld queryTimeMs hilft bei der Leistungsüberwachung.

AufbewahrungLink zum Abschnitt kopieren

Analytics-Ereignisdaten richten sich nach dem Plan des Workspace: Protokolle werden im Free-Plan 30 Tage, im Pro-Plan 90 Tage und im Max-Plan 180 Tage aufbewahrt.

Nächste SchritteLink zum Abschnitt kopieren

• E-Mail-Protokolle: einzelne E-Mail-Zustellungen suchen und prüfen
• Erweiterte Analytics: geografische, Geräte- und Tageszeit-Analysen
• Zustellbarkeit – Übersicht: Absenderreputation und Trends