Demo
Demo
База знаний PMTA›Блок <signals>›Директива§ 11.1.6.2.9

use-https

<signals>

Шифровать ли подставляемые ссылки отслеживания
в конфигурации это строкаuse-httpsвнутри блока <signals>
Ссылка без шифра в письме от вас

Строка делает подставляемые ссылки шифрованными. Умолчание — false, то есть ссылки идут по обычному протоколу.

🔴 Умолчание означает незашифрованные ссылки в ваших письмах. Почтовые клиенты и почтовики это видят; современный читатель — тоже.

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

Работает только при engagement-tracking со значением sparkpost — как и остальные строки подстановки.

Главная ловушка — включить без подготовленной области. Ссылки перестанут открываться, и заметит это не мониторинг, а получатель — то есть узнаете вы поздно и от клиента.
Что делает Хаб. Не пишет — и не собирается: подстановка чужих ссылок в наши письма означала бы, что переходы получателей идут через домен вендора.
Рекомендуемые значения

Выбор здесь короткий:

Значение Когда
false (умолчание) своей защищённой области нет
true своя область настроена на шифрование
Умолчание false и требование своей защищённой области — из руководства (§ 11.1.6.2.9).
Пример в конфигурации
# только вместе со своей областью, настроенной на шифрование
<signals>
    engagement-tracking sparkpost
    tracking-domain track.mydomain.com
    use-https true</signals>
Без подготовленной области строка ломает ссылки в уже отправленных письмах.
жёлтым — — имена директив, голубым — блоки. Так же они подсвечены и в тексте карточки.
▲

Типичные ошибки и проблемы

что делают не так и чем это кончается2 ошибки▶

Включают шифрование без подготовленной области

наш опыт

Чем чреватоСсылки перестают открываться. Узнаёте об этом от получателей, а не из мониторинга.
Как заметитьЖалобы на неработающие ссылки в письмах.
Как правильноСначала настроить область на шифрование, потом включать строку.

Ждут действия строки при выключенной подстановке

§ 11.1.6.2.9

Чем чреватоСтроки подстановки работают только при engagement-tracking со значением sparkpost. При других значениях они не делают ничего.
Как заметитьСтрока задана, в письмах ничего не изменилось.
Как правильноПроверить значение engagement-tracking.
Совместимость
PowerMTA 6.0
описана в руководстве этой версии · платформа: любая
С какой версии директива доступна, вендор указывает не для всех — здесь пометки нет. Имя встречается и в издании руководства 5.0.
Справочные данные
Синтаксис
use-https { yes | no }
Значения
yes | no | true | false
Умолчание
§ 11.1.6.2.9
Применение
reload, перезапуск не нужен
Очередь
уже поставленное в очередь не затронет
Где писать
<signals>
Сколько раз
один раз в блоке
Всё здесь — из руководства, с разделом.
Наследование
Наследования нет: строка живёт внутри <signals>, а такой блок на узле один. Охват выгрузки по потокам задаётся строкой enable-signals с тремя уровнями.
⇄

Связанные директивы

1 связь

Без чего не работает

tracking-domain<signals>Работает только со своей областью отслеживания, настроенной на шифрование. § 11.1.6.2.9

Как проверить на узле
Результат виден в самом письме — проверять надо по доставленному:
grep -i "signals\|html" /var/log/pmta/log | tail -20
Надёжнее посмотреть письмо, дошедшее до контрольного ящика: ссылки и пиксели в нём либо есть, либо нет.
◇

Что ещё почитать

3 статьи

◇Отдать письмо вебхуку вместо приёмникаОчередь шлёт письмо запросом POST в виде объекта JSON; успехом считается только ответ 2xx.◇Узел умеет сам вставлять пиксели и переписывать ссылкиВ режиме отслеживания вендора MTA разбирает исходящий HTML, переписывает ссылки на домен отслеживания и вставляет пиксели открытия — с выбором того, что делать, если разметка не разбирается.◇Разбор и правка разметкиОтслеживание открытий и переходов в режиме sparkpost правит разметку письма с помощью встроенного разборщика gumbo-parser; письмо, разметку которого разобрать не удалось, по умолчанию отбивается.

В Хабе
Цена ошибки
безопасно: неверное значение ничего не ломает
Сценарии
Инфраструктура трекинга
Соседние настройки блока <signals>:privacy-policyhtml-edit-error-modecustom-message-id-headerretain-x-sp-subaccount-idengagement-trackingВсе 16 директив блока →