Haskimail показывает, на каких устройствах получатели открывают ваши письма, в каких почтовых клиентах их читают и из каких браузеров переходят по ссылкам. Эти данные доступны через API статистики — по дням и итогом за выбранный период.
Разделы статистики
| Метод | Что показывает |
|---|---|
GET /stats/opens/platforms |
открытия по платформам |
GET /stats/opens/emailclients |
открытия по почтовым клиентам и веб-почтам |
GET /stats/clicks/platforms |
клики по платформам |
GET /stats/clicks/browserfamilies |
клики по браузерам |
Платформы в ответе обозначаются так:
-
Desktop — компьютер;
-
Mobile — телефон или планшет;
-
WebMail — веб-почта: Gmail, Почта Mail.ru, Яндекс Почта, Рамблер Почта. В статистике кликов WebMail — это клик из веб-интерфейса почты;
-
Unknown — платформу не удалось определить, в том числе при открытиях и кликах ботов.
Почтовые клиенты и браузеры называются по базе User-Agent Udger, веб-почты — по названию сервиса. Например: Apple Mail, Outlook, Mail.ru, Yandex Mail, Chrome, Chrome Mobile, Safari, Yandex.Browser. Если письмо открыли в браузере, клиентом считается браузер. Если определить клиент или браузер не удалось, он попадает в Unknown.
Что нужно для статистики
Статистика открытий собирается, только если для сервера или письма включено отслеживание открытий. Статистика кликов — если включено отслеживание ссылок. Пока аккаунт не прошёл модерацию, ссылки в письмах не отслеживаются.
Как получить статистику
Все четыре метода принимают одинаковые параметры:
| Параметр | Значение | По умолчанию |
|---|---|---|
| fromdate | начало периода, дата в формате 2026-10-01 |
месяц назад |
| todate | конец периода включительно | сегодня |
| messagestream | ID канала отправки | все каналы сервера |
С серверным ключом вы получите статистику своего сервера, с ключом аккаунта — по всем серверам. Тестовый ключ HASKIMAIL_API_TEST со статистикой не работает.
Даты передавайте строго в формате ГГГГ-ММ-ДД.
Пример запроса открытий по платформам за два дня:
curl "https://api.haskimail.ru/stats/opens/platforms?fromdate=2026-10-01&todate=2026-10-02" \
-X GET \
-H "Accept: application/json" \
-H "X-Haskimail-Server-Token: ваш_токен_сервера"
Пример ответа:
{
"Days": [
{ "Date": "2026-10-01", "Desktop": 18, "Mobile": 21, "WebMail": 5, "Unknown": 0 },
{ "Date": "2026-10-02", "Desktop": 20, "Mobile": 19, "WebMail": 6, "Unknown": 1 }
],
"Desktop": 38,
"Mobile": 40,
"WebMail": 11,
"Unknown": 1
}
В массиве Days — значения по дням, в полях верхнего уровня — итог за период. Дней без открытий и кликов в списке нет. В разбивке по клиентам и браузерам за день приходят только те названия, которые встретились в этот день, а итог за период отсортирован по убыванию.
Суммы открытий и кликов в этих разделах совпадают с полями Opened и Clicked сводной статистики /stats за тот же период.
Если в адресе запроса ошибка, например /stats/opens/platfroms, API вернёт HTTP 404 с кодом ошибки 404 «Неизвестный метод API».
Как считаются открытия и клики
-
Учитываются все открытия и клики, включая повторные.
-
Платформа, клиент и браузер определяются по User-Agent в момент открытия или клика.
-
Клики по ссылкам в текстовой версии письма учитываются, только если отслеживание ссылок настроено и для текстовой части.
Подробнее о точности открытий — в статье «Статистика открытий и Apple Mail».
Как использовать эти данные
-
Платформы. Если большинство получателей открывает письма на телефоне, проверьте, как шаблоны выглядят на маленьком экране.
-
Почтовые клиенты. Тестируйте вёрстку в тех клиентах, которые чаще всего встречаются у ваших получателей.
-
Браузеры. Проверьте, что страницы, на которые ведут ссылки из писем, корректно работают в популярных у ваших получателей браузерах.
Полное описание методов — в API статистики.