Zum Inhalt springen
Esc
↑↓navigieren↵öffnen⌘Jvorschau
Auf dieser Seite

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.

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.
  • 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:

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 }
  ]
}
  • 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, 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.

War diese Seite hilfreich?