Broadcast-Statistiken
Wie der Broadcast abgeschnitten hat: gesendete, zugestellte, gebouncte, als Spam gemeldete und fehlgeschlagene Kopien, und wie viele Personen geöffnet, geklickt und sich abgemeldet haben, als Summen und als Reihe, aufgeteilt nach `grain`.
Führt den echten Aufruf gegen Ihren Workspace aus, mit Ihrem eigenen Schlüssel.
GET /broadcasts/{id}/stats
Wie der Broadcast abgeschnitten hat: gesendete, zugestellte, gebouncte, als Spam gemeldete und fehlgeschlagene Kopien, und wie viele Personen geöffnet, geklickt und sich abgemeldet haben, als Summen und als Reihe, aufgeteilt nach grain.
Parameter
idstringerforderlich- Im Pfad. Eine `brd_`-ID aus `POST /broadcasts` oder `GET /broadcasts`.
grainstring- Intervallbreite der Reihe: `minute`, `hour` oder `day`. Standardwert ist `hour`.
offsetMinutesinteger- Minuten östlich von UTC, nach denen die Intervalle aufgeteilt werden, von -840 bis 840. Standardwert ist 0. Übergeben Sie `-new Date().getTimezoneOffset()` für die lokale Zeitzone.
Beispiel
Benötigt emails:read.
curl "$OE/broadcasts/brd_5a8c1e3f7b2d94a06c8e1f3b/stats?grain=day" -H "$AUTH"{ "object": "broadcast_stats", "broadcastId": "brd_5a8c1e3f7b2d94a06c8e1f3b", "grain": "day", "totals": { "recipients": 412, "pending": 0, "sent": 410, "delivered": 404, "bounced": 4, "complained": 1, "failed": 2, "opened": 187, "clicked": 52, "unsubscribed": 3, "opens": 296, "clicks": 71 }, "series": [ { "bucket": "2026-09-23", "delivered": 404, "opened": 161, "clicked": 45, "unsubscribed": 3 }, { "bucket": "2026-09-24", "delivered": 0, "opened": 26, "clicked": 7, "unsubscribed": 0 } ]}opened, clicked und unsubscribed zählen Personen, während opens und clicks Ereignisse zählen. pending zählt die Kopien, die noch in der Warteschlange, geplant oder im Versand sind, und failed die Kopien, die fehlgeschlagen sind oder abgebrochen wurden.
series ist dünn besetzt und beginnt mit dem ältesten Eintrag: ein Intervall pro grain, in dem etwas geschah. Sie zählt jede Person einmal, beim ersten Mal, als es ihr passierte, und ergibt deshalb in der Summe die Gesamtwerte.
bucket ist YYYY-MM-DD, YYYY-MM-DDTHH oder YYYY-MM-DDTHH:MM, im angeforderten Versatz.
Ablehnungen
| Status | Code | Wann |
|---|---|---|
| 400 | invalid_cursor | Bei der Empfängerliste ein cursor, den diese Liste nicht ausgegeben hat. |
| 403 | insufficient_scope | Der Schlüssel hat kein emails:read. |
| 404 | broadcast_not_found | Die ID nennt keinen Broadcast in diesem Workspace, oder der Schlüssel ist auf bestimmte Adressen oder Domains beschränkt und der Broadcast wurde von einer gesendet, die er nicht hält. |
| 404 | recipient_not_found | Bei GET /broadcasts/{id}/recipients/{emailId} eine emailId, die keine Kopie dieses Broadcasts ist. |