---
title: Analysen
description: Zustellstatistiken wenige Sekunden nach jedem Ereignis, im Dashboard und über GET /emails/metrics.
seo:
  title: E-Mail-Analytics-API
ai:
  exclude: true
---

Jedes Ergebnis (zugestellt, Bounce, Beschwerde, geöffnet, geklickt, abgemeldet) wird wenige Sekunden nach seinem Eintreten gezählt. Die Seite **Analysen** im Dashboard und `GET /emails/metrics` lesen dieselben Zahlen.

Im Dashboard zeigt Analysen die Zustell-, Öffnungs-, Klick-, Bounce- und Beschwerderate sowie ein Diagramm der Ereignisse pro Stunde. Sie können nach Zeitraum (7, 15 oder 30 Tage), Zeitzone, Marke (Absenderdomain), Newsletter-Versand und Empfängerdomain filtern.

Die Statistiken werden stündlich 13 Monate lang aufbewahrt. Der Verlauf eines einzelnen Newsletter-Versands wird nach 13 Monaten nicht abgeschnitten. Antwortet der Statistikdienst nicht, gibt der Endpunkt `503 service_unavailable` zurück, und der Versand bleibt unberührt. E-Mail-Listen, Exporte und die Ereignisse einer einzelnen E-Mail sind keine Statistiken; siehe [Logs](/docs/de/concepts/logs).

## Zahlen abfragen

`GET /emails/metrics` benötigt einen [API-Schlüssel](/docs/de/api-reference/basics) mit vollem Zugriff. Die SDKs rufen den Endpunkt als `emails.metrics()` auf.

```sh
curl "https://api.billionsend.com/emails/metrics?start_date=2026-11-01&end_date=2026-11-14&granularity=daily&metrics=sent&metrics=delivered&metrics=open_rate&dimensions=period" \
  -H "Authorization: Bearer bs_..."
```

| Parameter | Wirkung |
| --- | --- |
| `start_date`, `end_date` | Der Zeitraum. Die Statistiken werden in ganzen UTC-Stunden gelesen, und die Antwort nennt den tatsächlich verwendeten Start. |
| `timezone` | Ein IANA-Zonenname wie `Europe/Berlin` (ein UTC-Offset wie `+05:00` wird nicht akzeptiert). Die Perioden werden in dieser Zeitzone gebildet. |
| `granularity` | `hourly`, `daily`, `weekly` oder `monthly`: die Länge einer Periode, wenn `dimensions` `period` enthält. Ein Zeitraum darf höchstens 10.000 Perioden umfassen. |
| `metrics` | Wiederholen Sie den Parameter für jede gewünschte Kennzahl (siehe unten). |
| `dimensions` | Wiederholen Sie den Parameter für jede Aufschlüsselung: `period`, `domain`, `email` oder `broadcast`. `email` und `broadcast` lassen sich nicht kombinieren. |
| `domain_id`, `email_id`, `broadcast_id` | Filter. Jeder lässt sich bis zu 100-mal wiederholen. |

Die Antwort enthält `totals` für den gesamten Zeitraum und, wenn Sie Dimensionen anfordern, in `data` eine Zeile pro Kombination.

## Kennzahlen

| Kennzahl | Zählt |
| --- | --- |
| `received` | Zum Versand angenommene Empfänger. Sie gehört zu keiner Domain, keinem Newsletter-Versand und keiner E-Mail, daher lässt eine danach gefilterte oder aufgeschlüsselte Antwort sie weg. |
| `sent`, `delivered`, `delivery_delayed`, `failed`, `suppressed` | Empfänger nach Ergebnis des Versands. |
| `bounced`, `bounced_permanent`, `bounced_transient`, `bounced_undetermined` | Bounces und die drei Bounce-Klassen. |
| `complained`, `unsubscribed` | Spam-Beschwerden und Empfänger, die sich über den Abmeldelink abgemeldet haben. |
| `opened`, `clicked` | Jede Öffnung und jeden Klick. |
| `unique_opened`, `unique_clicked` | E-Mails, die mindestens einmal geöffnet oder angeklickt wurden. |
| `delivery_rate` | `delivered` ÷ `sent` |
| `bounce_rate` | `bounced` ÷ `sent` |
| `open_rate`, `click_rate` | `unique_opened` bzw. `unique_clicked` ÷ `delivered` |
| `complaint_rate`, `unsubscribe_rate` | `complained` bzw. `unsubscribed` ÷ `delivered` |

Raten sind Prozentwerte mit einer Nachkommastelle und `0`, wenn es nichts zu teilen gibt. Öffnungen und Klicks durch Maschinen, etwa Datenschutz-Proxys und Sicherheitsscanner, zählen nicht als Öffnungen oder Klicks.

Mit der Dimension `email` und ohne `email_id` listet die Antwort bis zu 1.000 E-Mails auf, die im Zeitraum erstellt wurden.

## Klicks nach Link

`GET /emails/metrics/links` (eine BillionSend-Erweiterung, Schlüssel mit vollem Zugriff) listet die Links auf, die in einem Zeitraum angeklickt wurden, die meistgeklickten zuerst:

```sh
curl "https://api.billionsend.com/emails/metrics/links?start_date=2026-11-01&end_date=2026-11-14&limit=10" \
  -H "Authorization: Bearer bs_..."
```

```json
{
  "object": "list",
  "start_date": "2026-11-01T00:00:00.000Z",
  "end_date": "2026-11-14T23:59:59.999Z",
  "has_more": false,
  "data": [
    { "link": "https://shop.example.com/sale", "clicked": 412, "bot_clicked": 37 }
  ]
}
```

- Ein Link wird als Schema, Host und Pfad gezählt. Query-String und Fragment bleiben außen vor. Ein für jeden Empfänger personalisierter Link ergibt also eine Zeile, und es werden keine Angaben zu Empfängern gespeichert.
- `clicked` zählt Personen; `bot_clicked` zählt Abrufe durch Maschinen wie Sicherheitsscanner und Link-Vorschauen.
- Der Endpunkt akzeptiert `start_date`, `end_date`, `domain_id`, `broadcast_id` (durch Kommas getrennt) und `limit` (1 bis 100, Standard 20) und deckt wie `GET /emails/metrics` ganze UTC-Stunden ab. Klicks werden seit dem 16. November 2026 nach Link gezählt.

## Öffnungen und Klicks nach Land und E-Mail-Programm

`GET /emails/metrics/countries` listet die Öffnungen und Klicks von Personen nach dem Land auf, aus dem sie kamen, und `GET /emails/metrics/clients` listet Öffnungen nach dem E-Mail-Programm auf, das die Bilder geladen hat (beide sind BillionSend-Erweiterungen, Schlüssel mit vollem Zugriff), die aktivsten zuerst:

```sh
curl "https://api.billionsend.com/emails/metrics/countries?start_date=2026-11-16&end_date=2026-11-30" \
  -H "Authorization: Bearer bs_..."
```

```json
{
  "object": "list",
  "start_date": "2026-11-16T00:00:00.000Z",
  "end_date": "2026-11-30T23:59:59.999Z",
  "has_more": false,
  "data": [
    { "country": "BR", "opened": 1840, "unique_opened": 1203, "bot_opened": 95, "clicked": 311, "unique_clicked": 240, "bot_clicked": 22 },
    { "country": "unknown", "opened": 960, "unique_opened": 702, "bot_opened": 410, "clicked": 12, "unique_clicked": 9, "bot_clicked": 3 }
  ]
}
```

- `country` ist der ISO-3166-1-Alpha-2-Code des Landes, in dem die Adresse des Lesers registriert ist. Er lautet `unknown`, wenn sich die Adresse nicht zuordnen lässt, sowie bei Öffnungen über die Bild-Proxys von Gmail und Yahoo oder den Mail-Datenschutz von Apple Mail: Diese kommen von der Adresse des Anbieters, nicht des Lesers.
- `client` ist einer von `gmail`, `apple_mail`, `outlook`, `yahoo`, `thunderbird`, `other` (ein Webbrowser: Webmail und Programme, die sich nicht zu erkennen geben, sehen gleich aus) oder `unknown` (kein User-Agent). Klicks werden nicht nach E-Mail-Programm gezählt, weil ein Klick aus dem Browser kommt, an den das E-Mail-Programm den Link übergibt.
- Für die Statistik werden nur das Land und das E-Mail-Programm gespeichert, nie die Adresse oder der User-Agent.
- `unique_opened` und `unique_clicked` zählen E-Mails, deren erste Öffnung oder erster Klick aus diesem Land bzw. von diesem E-Mail-Programm kam. Personen und Maschinen werden getrennt gezählt, wie bei `GET /emails/metrics`.
- Beide Endpunkte akzeptieren `start_date`, `end_date`, `domain_id` und `broadcast_id` (durch Kommas getrennt), decken ganze UTC-Stunden ab und liefern jede Zeile (es gibt nur eine begrenzte Zahl von Ländern und E-Mail-Programmen). Öffnungen und Klicks werden seit dem 16. November 2026 nach Land und E-Mail-Programm gezählt.
- IP-Geolokalisierung von [DB-IP](https://db-ip.com), lizenziert unter CC BY 4.0.

## Weiterführend

[Zustellbarkeits-Einblicke](/docs/de/concepts/deliverability-insights) bewerten jede E-Mail und Ihr Konto. Wenn Sie auf ein Ergebnis reagieren möchten, sobald es eintritt, statt es später zu zählen, nutzen Sie [Webhooks](/docs/de/concepts/webhooks).
