Статистика и отслеживание
От Сергей and Виктория
От Сергей and Виктория
Отслеживание открытий и кликов, статистика каналов и разбивка по устройствам, почтовым клиентам и браузерам.
Отслеживание открытий. Принцип работы
Отслеживание открытий работает только для HTML-писем. Если письмо содержит и HTML-, и текстовую версию, открытие будет зафиксировано, только когда получатель откроет HTML-версию. Для каждого письма, для которого вы включили отслеживание открытий, Haskimail добавляет в его тело невидимое изображение размером 1×1 пиксель. Когда получатель открывает письмо и изображение загружается, Haskimail фиксирует факт открытия. Большинство почтовых клиентов загружают изображения по умолчанию, но некоторые этого не делают. Если человек читает письмо, не загружая изображения, открытие письма не будет зафиксировано. Haskimail фиксирует каждое открытие, в том числе повторные, поэтому в статистике видно и число уникальных открытий, и общее. Если эти данные доступны, Haskimail также сохраняет: - местоположение; - операционную систему (macOS, Windows и др.); - браузер или почтовый клиент; - устройство и платформу. Как включить отслеживание — в статье «Отслеживание открытий. Как включить» и в документации. Учтите, что часть открытий может быть зафиксирована автоматически — см. «Статистика открытий и Apple Mail». Если отслеживание включено, в информации о письме в поле статуса открытий стоит галочка. При просмотре письма в интерфейсе Haskimail пиксель не загружается, поэтому ваш просмотр не засчитается как открытие. Информация о письме: открытия и клики по ссылкам отслеживаются
Отслеживание открытий. Как включить
Отслеживание открытий можно включить для всего сервера или для отдельного письма. Обратите внимание: для отдельного письма отслеживание можно только включить. Например, если в настройках сервера отслеживание выключено, письмо всё равно будет отслеживаться, если при отправке через API указать "TrackOpens": true. Отслеживание для всех писем на сервере Чтобы отслеживать все письма, отправляемые через конкретный сервер: 1. Выберите сервер. 2. Перейдите в Настройки. Вкладка «Настройки» на странице сервера 3. Включите переключатель отслеживания открытий. Блок «Трекинг» в настройках сервера: переключатель «Открытия» Отслеживание для одного письма с использованием API Чтобы отслеживать открытия конкретного письма, добавьте в запрос к /email параметр TrackOpens со значением true. Пример: "TrackOpens": true Обратите внимание: через API отключить отслеживание для отдельного письма нельзя, если оно включено на сервере: значение "TrackOpens": false в этом случае не действует. Отслеживание для одного письма с использованием SMTP Чтобы включить отслеживание открытий для письма, отправленного по SMTP, добавьте в него заголовок X-HM-TrackOpens со значением true: X-HM-TrackOpens: true Значение false выключает отслеживание для письма, но только если на сервере оно тоже выключено: настройка сервера приоритетна, и заголовок, который ей противоречит, ничего не меняет. Отслеживание кликов по SMTP настраивается заголовком X-HM-TrackLinks со значениями None, HtmlOnly, TextOnly или HtmlAndText. Подробнее — в статье «Отслеживание ссылок. Как включить».
Статистика открытий и Apple Mail
Начиная с iOS 15, в Apple Mail есть настройка конфиденциальности, из-за которой Haskimail фиксирует открытия, которых на самом деле не было. Если она включена, Apple Mail заранее загружает изображения из писем через прокси-серверы Apple — в том числе пиксель отслеживания. Поэтому доля открытий выглядит выше, чем есть на самом деле. Напомним, как работает отслеживание: Haskimail добавляет в письмо невидимое изображение 1×1 пиксель. Когда оно загружается, письмо отмечается как открытое. Так открытия считают почти все почтовые сервисы. Функция Apple называется Mail Privacy Protection (MPP), в настройках — «Защитить активность в Почте». Когда Apple загружает письмо на свой сервер, срабатывает пиксель, и Haskimail фиксирует открытие, хотя получатель письма ещё не видел. А когда получатель действительно открывает письмо, Apple показывает сохранённую копию, и пиксель повторно не загружается. Поэтому статистика открытий у таких получателей не отражает реального поведения. Открытия — полезный, но неточный показатель. Чтобы оценить эффективность писем, опирайтесь также на клики, ответы на письма и целевые действия на сайте. Каких получателей это касается Apple Mail — это почтовая программа, в которой можно читать почту любого сервиса: Gmail, Яндекс Почты, Mail.ru, корпоративной почты. Поэтому эффект возникает у всех, кто читает письма в Apple Mail с включённой защитой, а не только у владельцев адресов iCloud.
Отслеживание ссылок. Принцип работы
Отслеживание ссылок показывает, по каким ссылкам в ваших письмах переходят получатели. Включить его можно после того, как аккаунт пройдёт модерацию, — для всего сервера или для отдельного письма. Обзор Когда отслеживание включено, Haskimail находит ссылки в HTML-версии, текстовой версии или в обеих — в зависимости от настроек — и заменяет их на ссылки через домен отслеживания Haskimail или через ваш собственный поддомен, если он настроен (см. ниже). Когда получатель переходит по ссылке, мы сохраняем данные о клике и сразу перенаправляем его на исходный адрес. Сохраняются: - IP - User-Agent - ID ссылки - Временная метка Просмотр деталей отслеживания ссылок Успешно отслеживаемые ссылки будут отображаться в логе активности канала отправки и выглядеть так: Отслеживаемая ссылка в логе активности канала отправки Отслеживаемая ссылка в логе активности канала отправки, подробный вид Если открыть письмо для более подробной информации, можно увидеть данные о клике: Данные о клике в карточке письма Свой домен отслеживания По умолчанию ссылки в письмах ведут через домен отслеживания Haskimail. Чтобы в ссылках был ваш домен, настройте свой поддомен отслеживания: 1. Откройте раздел Домены и отправители и нажмите DNS настройки у нужного домена. 2. В блоке Кастомный домен трекинга укажите поддомен этого домена, например track.example.ru. 3. Нажмите Включить трекинг. 4. Добавьте в DNS домена CNAME-запись, которая ведёт с этого поддомена на haski.email, например track.example.ru → haski.email. Точное значение показано в том же блоке. Блок «Кастомный домен трекинга» на странице «Настройки DNS» домена Свой поддомен отслеживания улучшает доставляемость и узнаваемость: получатели видят в ссылках ваш домен, а не домен сервиса. Форматирование ссылок Не используйте сам адрес ссылки как её текст. Если текст ссылки выглядит как один адрес, а ведёт она через сервер отслеживания, почтовые сервисы, например Gmail и Mail.ru, могут принять письмо за фишинг. Неправильно: <a href="http://example.com">http://example.com</a> Правильно: <a href="http://example.com">Посетите наш сайт</a>
Отслеживание ссылок. Как включить
Отслеживание ссылок можно включить для всего сервера или для отдельного письма. В обоих случаях можно выбрать, где отслеживать ссылки: в HTML-версии письма, в текстовой или в обеих. Обратите внимание: настройка сервера приоритетна. Если на сервере отслеживание ссылок выключено, его можно включить для отдельного письма — через API, например "TrackLinks": "HtmlAndText", или по SMTP заголовком X-HM-TrackLinks (см. ниже). Если отслеживание включено на сервере, значение письма, которое ему противоречит, ничего не меняет. Чтобы не отслеживать конкретную ссылку, используйте атрибут data-hm-no-track (см. в конце статьи). Уровень сервера Чтобы отслеживать все письма, отправленные с конкретного сервера: 1. Выберите сервер. 2. Перейдите в его настройки. Вкладка «Настройки» на странице сервера 3. Внизу страницы включите отслеживание ссылок. Блок «Трекинг» в настройках сервера: переключатель «Клики по ссылкам» и выбор HTML- и текстовой версии Теперь ссылки отслеживаются во всех письмах этого сервера — по умолчанию и в HTML-, и в текстовой версии. При необходимости можно отключить отслеживание отдельно: - для HTML-версии; - для текстовой версии. Если отслеживание на сервере выключено, его можно включить для отдельных писем. Уровень письма При отправке через API отслеживание для конкретного письма задаётся полем TrackLinks: - TrackLinks: HtmlAndText — отслеживает ссылки как в HTML, так и в текстовой части письма. - TrackLinks: None — не отслеживает никакие ссылки. - TrackLinks: HtmlOnly — отслеживает ссылки только в HTML части письма. - TrackLinks: TextOnly — отслеживает ссылки только в текстовой части письма. - TrackLinks: null — не указывает значение, используется значение по умолчанию для сервера. Уровень письма при отправке по SMTP При отправке по SMTP режим отслеживания ссылок для конкретного письма задаётся заголовком X-HM-TrackLinks. Значения те же, что у поля TrackLinks в API: - HtmlAndText — отслеживать ссылки в HTML- и текстовой части; - HtmlOnly — только в HTML-части; - TextOnly — только в текстовой части; - None — не отслеживать ссылки. Например, чтобы отслеживать ссылки только в HTML-версии письма, когда на сервере отслеживание выключено: X-HM-TrackLinks: HtmlOnly Если заголовок не указан, действует настройка сервера. Отключение отслеживания для отдельных ссылок В HTML-письме можно отключить отслеживание отдельной ссылки: добавьте к ней атрибут data-hm-no-track. Например, эта ссылка не будет отслеживаться: <a data-hm-no-track href="http://example.com"> Неотслеживаемая ссылка </a>
Статистика канала отправки
Вкладка Статистика показывает, как работает канал отправки: сколько писем отправлено и доставлено, сколько вернулось, сколько получателей пожаловались на спам, открыли письма и перешли по ссылкам. Как открыть статистику Перейдите в раздел SMTP-серверы, откройте сервер, а затем нужный канал отправки. Вкладка Статистика открывается первой. Период и теги Вверху страницы выберите период: последний час, последние сутки, 7, 30 или 45 дней. В интерфейсе доступна статистика за последние 45 дней. Рядом находится фильтр по тегам. Если при отправке вы указываете тег письма, например welcome или order, можно посмотреть статистику только по письмам с этим тегом. Если тегов нет, в списке будет только пункт Все теги. Выбор периода и фильтр по тегам График и сводка На графике показано, сколько писем отправлено и доставлено (левая шкала), сколько возвратов и жалоб на спам (правая шкала). Чтобы скрыть линию, нажмите на её название под графиком. Под графиком — короткая сводка за выбранный период: сколько писем отправлено, доля возвратов, доля открытых писем и доля писем, в которых перешли по ссылкам. График отправок и сводка за период Возвраты и жалобы на спам Ниже возвраты разделены по типам: Жёсткие возвраты, Мягкие возвраты, Блокировки и Спам-блокировки. Для каждого типа указано количество и доля от всех возвратов. Нажмите на название типа, чтобы открыть Лог активности канала с письмами только этого типа. Отдельно показано число жалоб на спам. Чтобы не было проблем с доставкой, жалоб должно быть меньше 0,1% — не больше одной на 1000 писем. Если жалоб больше, рядом появится предупреждение. Что означают типы возвратов и что с ними делать, читайте в статьях «Возвраты, блокировки и жалобы на спам» и «Как исправить жёсткие возвраты». Возвраты по типам и жалобы на спам Открытия и клики Если отслеживание включено, ниже появятся графики открытий и кликов. Пока открытий или кликов нет, вместо графика будет подсказка. Открытия считаются только у получателей, чей почтовый клиент загружает изображения. Статистика по устройствам, почтовым программам и браузерам описана в статье «Статистика по устройствам, почтовым клиентам и браузерам». Сводная статистика по доменам В конце страницы — таблица по почтовым доменам получателей: gmail.com, mail.ru, yandex.ru и другим. Для каждого домена указано, сколько писем отправлено, сколько вернулось, сколько открытий, уникальных открытий, кликов, отписок и жалоб на спам. Процент в колонке Отправлено считается от всех писем за период, в остальных колонках — от писем на этот домен. Таблица помогает заметить, что проблемы с доставкой только у одного почтового сервиса. Количество строк на странице выбирается в поле Выводить по. Сводная статистика по доменам Вся статистика показывается по московскому времени (UTC+3). Чтобы получать статистику на почту раз в неделю, подпишитесь на еженедельный дайджест в настройках профиля.
Статистика по устройствам, почтовым клиентам и браузерам
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 статистики.