Обзор

Интеграции

Руководство пользователя

Справочник API

Вебхуки

Отслеживание ссылок

Что такое отслеживание ссылок?
#

Как и отслеживание открытий, отслеживание ссылок — это метод сбора ценной информации о том, как получатели взаимодействуют с вашими письмами. В отличие от отслеживания открытий, этот метод не ограничен HTML-форматом и не зависит от того, разрешил ли пользователь загрузку изображений в своем почтовом клиенте. Статистика будет записываться при клике по любой отслеживаемой ссылке, независимо от того, в какой части письма она находилась — в HTML или в текстовой. Отслеживание ссылок также может предоставить полезную диагностику, например, для определения, перешел ли получатель по отправленной ему ссылке.

Как это работает? #

Когда отслеживание ссылок включено, все ссылки в ваших письмах заменяются на новые, которые проходят через серверы Haskimail. Когда получатель нажимает на такую ссылку, она открывается в его браузере. Браузер отправляет запрос на один из наших серверов, и в этот момент мы записываем информацию о геолокации пользователя, его браузере и части письма, из которой был сделан переход (HTML или текст). Одновременно с записью этой информации мы мгновенно перенаправляем пользователя на исходный URL-адрес из вашего письма. Домен отслеживания, который увидит пользователь, — click.hskmail.it..

Ссылки, отслеживаемые Haskimail, не имеют срока действия. Поскольку такие сервисы, как Gmail, хранят письма годами, ваши получатели могут переходить по ссылкам даже спустя долгое время. Каждая отслеживаемая ссылка, созданная Haskimail, содержит всю необходимую информацию для перенаправления на исходный URL, даже если вы удалите свой сервер в Haskimail. Таким образом, ссылки, которые вы отправляете, будут работать в обозримом будущем. Наша инфраструктура перенаправлений глобально распределена и отказоустойчива. Мы создали ее с целью сделать этот процесс максимально прозрачным и быстрым для ваших получателей.

Безопасность ссылок #

Все отслеживаемые Haskimail ссылки проходят через наши серверы с использованием HTTPS/TLS. В отличие от других сервисов, которые используют незашифрованные HTTP-соединения, мы гарантируем, что злоумышленники не смогут перехватить ссылки, отправленные вашим получателям. Транзакционные письма часто содержат персональные ссылки, поэтому постоянное использование HTTPS для отслеживания является важной защитой, которую мы считаем необходимой для ваших самых важных писем.

Требования #

Подтверждение аккаунта

Одним из обязательных условий для использования нашей системы отслеживания ссылок является наличие подтвержденного аккаунта. После того как ваш аккаунт пройдет стандартную процедуру проверки, вы сможете использовать все функции отслеживания. До этого момента ссылки в письмах, отправляемых через Haskimail, отслеживаться не будут.

Правильное кодирование

Ссылки должны быть правильно закодированы как для текстовой, так и для HTML-части письма. Это включает следующие требования:

  • Ссылки должны быть корректно сформированы согласно  RFC-3986.
  • Ссылки в HTML-элементах  a должны быть HTML-экранированы. Мы автоматически декодируем URL-адреса при обработке вашего HTMLBody. Не экранируйте ссылки в TextBody, это может привести к некорректному отслеживанию.elements must be HTML-encoded. We automatically HTML-decode the URLs when processing your HTMLBody.
  • Ссылки должны быть правильно  URL-encoded.
  • Домены с Unicode-символами должны использовать punycode для их корректного представления в ASCII.
  • Для корректного отслеживания ссылки должны содержать протокол  http или https.

Обратите внимание: если ссылка в письме некорректно сформирована или экранирована, мы пропустим ее и не будем заменять на отслеживаемую. Это гарантирует, что Haskimail будет создавать только те ссылки, которые могут быть корректно перенаправлены.

Только в открывающем теге

Некоторые стандарты (XML, XHTML) позволяют включать атрибут href в закрывающий тег (например,  </a href="" >), однако Haskimail не будет отслеживать такие ссылки.

Поддерживаются только HTTP и HTTPS

Существует множество протоколов, которые можно использовать в ссылках (например,  ftp://,ssh://,mailto:, итд). В настоящее время Haskimail отслеживает только ссылки с протоколами http и https.

Включение отслеживания ссылок #

Варианты отслеживания

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

  • None - Никакие ссылки не заменяются и не отслеживаются. Это настройка по умолчанию для всех писем и серверов.
  • HtmlAndText - Ссылки заменяются и в HTML-, и в текстовой части письма. Идентичные ссылки в обеих частях считаются "одной и той же" ссылкой и засчитываются как один уникальный клик, независимо от того, где получатель нажал на нее.
  • HtmlOnly - Ссылки заменяются только в HTMLBody. Это полезно, если вы не хотите, чтобы в текстовой версии письма были закодированные ссылки отслеживания.
  • TextOnly - Ссылки заменятся только в TextBody. 

Как включить отслеживание

После выбора нужного типа отслеживания вы можете включить его одним из следующих способов:

  • На уровне сервера - Вы можете установить свойство  TrackLinks в настройках сервера. Эта настройка будет применяться ко всем письмам, отправляемым с этого сервера. Однако ее можно переопределить для отдельных писем.
  • На уровне письма (через API) - Вы можете установить свойство TrackLinks для каждого письма, отправляемого через API. Эта настройка имеет приоритет над настройкой сервера.
  • На уровне письма (через SMTP) - Вы можете установить заголовок X-PM-TrackLinks для каждого письма, отправляемого через SMTP. Эта настройка также имеет приоритет над настройкой сервера.

Отключение отслеживания для отдельных ссылок

IИногда может потребоваться исключить из отслеживания конкретную ссылку, даже если для остального письма отслеживание включено. Для этого добавьте атрибут data-hm-no-track к нужной ссылке в HTMLBody вашего письма. Например:

<a data-hm-no-track href="http://example.com"> Неотслеживаемая ссылка </a>

Обратите внимание: эта функция работает на уровне ссылки. Если одна и та же ссылка (с атрибутом в HTML) присутствует и в TextBody, она также не будет отслеживаться.