Click tracking

Click tracking фиксирует переходы по ссылкам в HTML-письмах. Когда настройка включена для проекта, MailInfra заменяет подходящие href на короткие ссылки вида:

https://track.mailinfra.ru/c/<token>

При переходе получатель сразу перенаправляется на исходный URL, а в событиях письма появляется clicked.

Включение

В дашборде: Настройки → Проект → Click tracking.

Через Management API:

PATCH /v1/organizations/{organization_id}/projects/{project_id}
Authorization: Bearer <session_token>
Content-Type: application/json

{
  "settings": {
    "click_tracking": true
  }
}

Чтобы выключить трекинг, передайте false.

Какие ссылки отслеживаются

MailInfra переписывает только HTML-ссылки <a href="..."> с абсолютным http или https URL.

Не переписываются:

• mailto:, относительные ссылки и другие схемы;
• ссылки на сам tracking-домен;
• ссылки с rel="unsubscribe";
• ссылки с атрибутом data-mailinfra-no-track.

Пример исключения:

<a href="https://example.com/account" data-mailinfra-no-track>Личный кабинет</a>

События и вебхуки

Клик создаёт событие clicked у письма. В data.event приходят:

{
  "url": "https://example.com/order/123",
  "ip": "203.0.113.42",
  "user_agent": "Mozilla/5.0 ..."
}

Чтобы получать клики по HTTP, подпишите вебхук проекта на clicked.

Аналитика в дашборде

В разделе Метрики → Переходы по ссылкам выбранный период фильтрует переходы по времени самого клика. Дашборд показывает:

• общее число переходов, число писем с кликом и количество разных URL;
• самые популярные ссылки с числом переходов и писем;
• время последнего клика по каждой ссылке;
• последние переходы с IP-адресом и типом браузера или устройства.

Показатель Клики в верхней части страницы считается по cohort отправок: это доля доставленных писем, созданных в выбранном периоде, по которым был хотя бы один переход. Поэтому numerator и denominator относятся к одному набору писем. Повторные клики учитываются в детализации URL, но не увеличивают число писем с кликом.

Повторная отправка

При resend MailInfra разворачивает старые tracking-ссылки и создаёт новые токены для нового письма. Клик по повторно отправленному письму привязывается к новому email_id.

Ограничения

Click tracking работает только для HTML-тела письма. Текстовая версия (text) не переписывается.

Для тестовых API-ключей письмо сохраняется как SIMULATED, реальная отправка не выполняется и ссылки не переписываются.