Аналитика рассылок
Как прошли рассылки, отправленные за период, который заканчивается сейчас: суммарно и по дням, часам или минутам, с одной строкой на рассылку для сравнения. Это вкладка «Аналитика» на странице рассылок.
Выполняет настоящий запрос в вашем рабочем пространстве.
GET /broadcasts/analytics
Как прошли рассылки, отправленные за период, который заканчивается сейчас: суммарно и по дням, часам или минутам, с одной строкой на рассылку для сравнения. Это вкладка «Аналитика» на странице рассылок.
Пример
Требует emails:read. Не указывайте broadcastIds, чтобы получить все рассылки, или перечислите до 50 через запятую. Период задаётся days (от 1 до 1095) или minutes (от 1 до 1576800, имеет приоритет, если переданы оба), по умолчанию 30 дней. grain может быть day, hour или minute, по умолчанию day, а offsetMinutes (от -840 до 840) задаёт смещение смотрящего относительно UTC.
curl "$OE/broadcasts/analytics?days=30" -H "$AUTH"{ "object": "broadcast_analytics", "since": "2026-08-25T00:00:00.000Z", "until": "2026-09-23T12:00:00.000Z", "grain": "day", "offsetMinutes": 0, "broadcastIds": [], "totals": { "broadcasts": 2, "recipients": 530, "pending": 0, "sent": 527, "delivered": 519, "bounced": 6, "complained": 1, "failed": 3, "opened": 241, "clicked": 66, "unsubscribed": 4, "opens": 377, "clicks": 90 }, "series": [ { "bucket": "2026-09-09", "sent": 117, "delivered": 115, "opened": 54, "clicked": 14, "unsubscribed": 1 }, { "bucket": "2026-09-23", "sent": 410, "delivered": 404, "opened": 187, "clicked": 52, "unsubscribed": 3 } ], "broadcasts": [ { "id": "brd_5a8c1e3f7b2d94a06c8e1f3b", "subject": "The September release is out", "status": "sent", "sentAt": "2026-09-23T12:00:00.000Z", "recipients": 412, "sent": 410, "delivered": 404, "opened": 187, "clicked": 52, "unsubscribed": 3 }, { "id": "brd_2e7d9b4c1a8f60e35d2c7b91", "subject": "What changed in August", "status": "sent", "sentAt": "2026-09-09T09:30:00.000Z", "recipients": 118, "sent": 117, "delivered": 115, "opened": 54, "clicked": 14, "unsubscribed": 1 } ]}Копия учитывается, если она отправлена внутри периода, и всё, что с ней произошло потом, учитывается вместе с ней. Рассылки в тестовом режиме не учитываются.
totals и series суммируют рассылки из broadcastIds или все рассылки, если он пуст. broadcasts всегда перечисляет все рассылки периода, сначала самые новые, с теми же счётчиками, что и totals (здесь сокращено), чтобы их можно было сравнить или выбрать id.
opened, clicked и unsubscribed считают людей, а opens и clicks считают события. series разреженный, от старых к новым, и учитывает каждого человека один раз, в первый раз, когда это с ним произошло.
Больше 50 id дают 422 invalid_parameter, а id без копий в периоде ничего не добавляет. Ключ, ограниченный определёнными адресами или доменами, читает только рассылки, отправленные с адреса или домена, который у него есть.
