Analysen
Zustellstatistiken wenige Sekunden nach jedem Ereignis, im Dashboard und über GET /emails/metrics.
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.
Zahlen abfragen
GET /emails/metrics benötigt einen API-Schlüssel mit vollem Zugriff. Die SDKs rufen den Endpunkt als emails.metrics() auf.
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:
curl "https://api.billionsend.com/emails/metrics/links?start_date=2026-11-01&end_date=2026-11-14&limit=10" \
-H "Authorization: Bearer bs_..."
{
"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.
clickedzählt Personen;bot_clickedzählt Abrufe durch Maschinen wie Sicherheitsscanner und Link-Vorschauen.- Der Endpunkt akzeptiert
start_date,end_date,domain_id,broadcast_id(durch Kommas getrennt) undlimit(1 bis 100, Standard 20) und deckt wieGET /emails/metricsganze 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:
curl "https://api.billionsend.com/emails/metrics/countries?start_date=2026-11-16&end_date=2026-11-30" \
-H "Authorization: Bearer bs_..."
{
"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 }
]
}
countryist der ISO-3166-1-Alpha-2-Code des Landes, in dem die Adresse des Lesers registriert ist. Er lautetunknown, 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.clientist einer vongmail,apple_mail,outlook,yahoo,thunderbird,other(ein Webbrowser: Webmail und Programme, die sich nicht zu erkennen geben, sehen gleich aus) oderunknown(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_openedundunique_clickedzä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 beiGET /emails/metrics.- Beide Endpunkte akzeptieren
start_date,end_date,domain_idundbroadcast_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, lizenziert unter CC BY 4.0.
Weiterführend
Zustellbarkeits-Einblicke 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.