Estadísticas del envío masivo
Cómo funcionó el envío masivo: copias enviadas, entregadas, rebotadas, marcadas como spam y fallidas, y cuántas personas abrieron, hicieron clic y se dieron de baja, como totales y como una serie cortada según `grain`.
Ejecuta la llamada real contra tu espacio de trabajo, con tu propia clave.
GET /broadcasts/{id}/stats
Cómo funcionó el envío masivo: copias enviadas, entregadas, rebotadas, marcadas como spam y fallidas, y cuántas personas abrieron, hicieron clic y se dieron de baja, como totales y como una serie cortada según grain.
Parámetros
idstringobligatorio- En la ruta. Un id `brd_` de `POST /broadcasts` o `GET /broadcasts`.
grainstring- Ancho de intervalo de la serie: `minute`, `hour` o `day`. Por defecto, `hour`.
offsetMinutesinteger- Minutos al este de UTC en los que cortar los intervalos, de -840 a 840. Por defecto, 0. Pasa `-new Date().getTimezoneOffset()` para la zona local.
Ejemplo
Necesita 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 y unsubscribed cuentan personas, mientras que opens y clicks cuentan eventos. pending cuenta las copias aún en cola, programadas o enviándose, y failed las copias que fallaron o se cancelaron.
series es dispersa y va de la más antigua a la más reciente: un intervalo por grain en el que pasó algo. Cuenta a cada persona una vez, la primera vez que le pasó, así que suma los totales.
bucket es YYYY-MM-DD, YYYY-MM-DDTHH o YYYY-MM-DDTHH:MM, en el desfase pedido.
Rechazos
| Estado | Código | Cuándo |
|---|---|---|
| 400 | invalid_cursor | En la lista de destinatarios, un cursor que esa lista no entregó. |
| 403 | insufficient_scope | La clave no tiene emails:read. |
| 404 | broadcast_not_found | El id no nombra ningún envío masivo de este espacio de trabajo, o la clave está limitada a direcciones o dominios concretos y el envío masivo salió de uno que no tiene. |
| 404 | recipient_not_found | En GET /broadcasts/{id}/recipients/{emailId}, un emailId que no es una copia de este envío masivo. |