Подключить
Полезное

Трекинг открытий и кликов

С помощью пикселя и редирект-ссылки для отправок по SMTP и API-протоколу

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

Открытия: с помощью пикселя открытий — невидимого получателю изображения размером 1×1 px, которое добавляется в HTML-версию письма. В пиксель (картинку) зашита ссылка с индентификаторами.

Клики: через редирект на ссылках — незаметного для получателя перехода по ссылке, в которую зашит уникальный ID отправки.
Способы добавления пикселя и редиректа на ссылки отличаются при отправке по SMTP и по API. Можете сразу перейти в нужный раздел:

Если вы отправляете по SMTP-протоколу ›
Если вы отправляете по API-протоколу ›
Отслеживание работает для отправок, для которых задан X-Track-ID.

Пример формирования X-Track-ID

X-Track-ID — это ваш внутренний ID уникальный для каждой отправки. Вот хорошая практика для формирования этой переменной:
{{login}}-{{timestamp}}-{{your-id}}
login — ваш логин к SMTP
timestamp — временная метка запроса
your-id — любой понятный вам ID

Пример реального X-Track-ID:
12345-1742467886-22222

Если вы отправляете по SMTP-протоколу

Нужно добавить трекинг-пиксель и обернуть ссылки в письме на своей стороне.
При отправке по SMTP мы не вмешиваемся в контент, который вы передаёте. Соответственно, добавить пиксель и редирект не можем.

Добавить заголовок X-Track-ID

Чтобы трекинг работал, необходимо передать заголовок X-Track-ID при отправке письма.

Пример кода на Python ›

Как добавить пиксель открытий

В вёрстку письма через следующую конструкцию:
[domain] - ваш настроенный домен для редиректов, либо дефолтный домен track.smtprvl.ru
[X-Track-ID] - уникальный ID отправки, сгенерированный вами
<img src="[domain]/open/[X-Track-ID]" alt="" height="1" width="1" border="0">
Пример использования конструкции:
<img src="https://yourtrackdomain.ru/open/12345-1742467886-22222" alt="" height="1" width="1" border="0">

Как обернуть ссылки

Все ссылки в письме нужно обернуть в редирект по следующей конструкции:
[domain]/click/[X-Track-ID]?goto_url=[url]
url — это целевая ссылка в urlencode
domain — это track.smtprvl.ru или ваш домен, на котором настроена CNAME запись на track.smtprvl.ru

Пример использования конструкции:
https://yourtrackdomain.ru/click/12345-1742467886-22222?goto_url=https%3A%2F%2Fyour-target-url.ru
Документация по SMTP
Рекомендуем настроить свой домен для редиректов для корректного отслеживания кликов в письмах. Перейти к разделу ›

Если вы отправляете по API-протоколу

Мы можем добавить пиксель и редирект в отправку сами, без сложных действий с вашей стороны. Для этого передайте в запросе следующие параметры:

x_track_id — уникальный идентификатор отправки
track_open — для отслеживания открытий
track_click — для отслеживания кликов
track_domain — домен для редиректов

Пример запроса ›
Документация по API

Как заменить стандартный домен для редиректов

Для настройки своего домена создайте CNAME-запись track.domain.com в содержимом укажите track.smtprvl.ru. Итоговая запись будет выглядеть так:
track.domain.com CNAME track.smtprvl.ru
Затем обратитесь в поддержку или создайте обращение через запрос на почту support@samotpravil.ru, чтобы мы добавили ваш домен в разрешённые.
Напишите в поддержку, если нужна помощь.