[Документация Yandex Cloud](../../index.md) > [Yandex Cloud Postbox](../index.md) > [Концепции](index.md) > Отслеживание переходов по ссылкам в письмах

# Отслеживание переходов по ссылкам

Yandex Cloud Postbox позволяет отслеживать переходы по ссылкам в письмах. Когда получатель нажимает на ссылку в письме, Yandex Cloud Postbox отправляет уведомление о том, что был совершен переход.

## Принцип работы {#how-it-works}

Для отслеживания переходов по ссылкам Yandex Cloud Postbox использует технологию перенаправления ссылок. При включенном отслеживании сервис автоматически заменяет все ссылки в HTML-части письма на отслеживающие ссылки, которые ведут через промежуточный сервер Yandex Cloud Postbox.

Когда получатель нажимает на ссылку в письме, браузер сначала обращается к серверу Yandex Cloud Postbox, который регистрирует переход и отправляет уведомление, а затем перенаправляет пользователя на оригинальный адрес.

Описание формата уведомлений о переходах по ссылкам приведено в разделе [Уведомление о том, что получатель перешел по ссылке в письме](notification.md#click).

{% note warning %}

Yandex Cloud Postbox модифицирует тело письма, заменяя оригинальные ссылки на отслеживающие. Протокол в отслеживающей ссылке совпадает с протоколом оригинальной ссылки (например, `http://` или `https://`).

{% endnote %}

## Как включить {#setup}

Включить отслеживание переходов по ссылкам можно при [создании](../operations/create-configuration.md) или редактировании конфигурации следующими способами:

Способ | Сбор [метрики](statistics.md#metrics) `Переходы` | Отправка уведомлений в поток данных Data Streams
--- | --- | ---
Выбрать тип уведомления **Переход по ссылкам** в блоке **Подписки** | ![yes](../../_assets/common/yes.svg) | ![yes](../../_assets/common/yes.svg)
Включить опцию **Статистика вовлечённости** в блоке **Настройки сбора статистики** | ![yes](../../_assets/common/yes.svg) | ![no](../../_assets/common/no.svg)

{% note info %}

Отслеживание работает для писем, у которых только один получатель.

Отслеживающие ссылки добавляются только в письма, которые содержат HTML-часть. Если письмо содержит только текстовую часть, отслеживание недоступно.

{% endnote %}

## Особенности работы {#features}

### Множественные переходы {#multiple-clicks}

Yandex Cloud Postbox отправляет уведомление каждый раз, когда получатель переходит по ссылке. Если получатель нажал на одну и ту же ссылку несколько раз, вы получите соответствующее количество уведомлений.

### Поддерживаемые протоколы {#protocols}

Отслеживание поддерживается для ссылок с протоколами:

* `http://`
* `https://`

Ссылки с другими протоколами (например, `mailto:`, `tel:`, `ftp://`) не отслеживаются и остаются без изменений.

Для ссылок без протокола (например, `www.example.com`) Yandex Cloud Postbox добавляет протокол `http://` по умолчанию.

### Обработка ошибок {#error-handling}

Если оригинальная ссылка недоступна или возвращает ошибку, Yandex Cloud Postbox все равно отправит уведомление о переходе, а пользователь получит соответствующую ошибку в браузере.

### Теги ссылок {#link-tags}

Вы можете добавить теги в виде пар ключ-значение к ссылкам в письме, используя атрибут `postbox:tags`. При использовании этого атрибута указывайте ключи в формате `<ключ>:<значение>`. Если нужно передать несколько пар ключ-значение, разделяйте каждую пару точкой с запятой `;`.

Например, при добавлении тегов `product:book`, `genre:fiction`, `subgenre:scifi`, `type:newrelease` результирующая ссылка будет выглядеть следующим образом:

```html
<a postbox:tags="product:book;genre:fiction;subgenre:scifi;type:newrelease;"
   href="http://www.example.com/…/">Новинки научной фантастики</a>
```

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