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.

## Что нужно для статистики

Статистика открытий собирается, только если для сервера или письма включено отслеживание открытий. Статистика кликов — если включено отслеживание ссылок. Пока аккаунт не прошёл модерацию, ссылки в письмах не отслеживаются.

* [Отслеживание открытий. Как включить](https://help.haskimail.ru/hc/haskimail/articles/1768996531-otslezhivanie-otkrytiy-kak-vklyuchit)

* [Отслеживание ссылок. Как включить](https://help.haskimail.ru/hc/haskimail/articles/1768996599-otslezhivanie-ssylok-kak-vklyuchit)

## Как получить статистику

Все четыре метода принимают одинаковые параметры:

| Параметр      | Значение                                    | По умолчанию       |
| ------------- | ------------------------------------------- | ------------------ |
| 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»](https://help.haskimail.ru/hc/haskimail/articles/1768996553-statistika-otkrytiy-i-apple-mail).

## Как использовать эти данные

* **Платформы.** Если большинство получателей открывает письма на телефоне, проверьте, как шаблоны выглядят на маленьком экране.

* **Почтовые клиенты.** Тестируйте вёрстку в тех клиентах, которые чаще всего встречаются у ваших получателей.

* **Браузеры.** Проверьте, что страницы, на которые ведут ссылки из писем, корректно работают в популярных у ваших получателей браузерах.

Полное описание методов — в [API статистики](https://haskimail.ru/developer/api/stats-api).