tracking-domain

<signals>

Домен в подставляемых ссылках отслеживания
в конфигурации это строкаtracking-domain собственный трекинг-домен поставщикавнутри блока <signals>
Чей домен получатель увидит в ссылке

Строка задаёт домен подставляемых ссылок. Умолчание — pmta.spgo.io, то есть домен вендора. Работает только при engagement-tracking со значением sparkpost.

🔴 Для Европы умолчание не годится. Руководство говорит прямо: европейским клиентам эту строку задавать обязательно — либо своей областью, либо pmta.eu.spgo.io.

Своя область — это запись CNAME на pmta.spgo.io (или на европейский адрес) плюс регистрация области в кабинете вендора. Одного DNS мало.

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

Задать её можно тремя способами: здесь, в строке охвата enable-signals и в правиле отбора sender-or-from — последнее позволяет разную область разным доменам отправки.

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

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

Значение Когда
не задавать США, своей области нет
pmta.eu.spgo.io Европа, своей области нет — обязательно
своя область всегда, когда домен в письме важен
Умолчание, обязательность для Европы, оба адреса для записи CNAME, требование регистрации области и три места, где её можно задать, — из руководства (§ 11.1.6.2.8).
Пример в конфигурации
# своя область: запись CNAME плюс регистрация у вендора
<signals>
    engagement-tracking sparkpost
    tracking-domain track.mydomain.com</signals>
Запись CNAME должна указывать на адрес вендора, а сама область — быть зарегистрирована в его кабинете.
жёлтым — — имена директив, голубым — блоки. Так же они подсвечены и в тексте карточки.
▲

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

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

Заводят запись CNAME и не регистрируют область

наш опыт

Чем чреватоУсловий два. DNS отвечает, служба области не знает — ссылки в письмах не работают.
Как заметитьПереходы по ссылкам не регистрируются, ссылка ведёт в никуда.
Как правильноЗарегистрировать область в кабинете вендора.

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

§ 11.1.6.2.8

Чем чреватоСтроки подстановки работают только при engagement-tracking со значением sparkpost. При других значениях они не делают ничего.
Как заметитьСтрока задана, в письмах ничего не изменилось.
Как правильноПроверить значение engagement-tracking.
Совместимость
PowerMTA 6.0
описана в руководстве этой версии · платформа: любая
С какой версии директива доступна, вендор указывает не для всех — здесь пометки нет. Имя встречается и в издании руководства 5.0.
Справочные данные
Синтаксис
tracking-domain <domain>
Значения
имя домена
Умолчание
собственный трекинг-домен поставщика § 11.1.6.2.8
Применение
reload, перезапуск не нужен
Очередь
уже поставленное в очередь не затронет
Где писать
<signals>
Сколько раз
один раз в блоке
Всё здесь — из руководства, с разделом.
Наследование
Наследования нет: строка живёт внутри <signals>, а такой блок на узле один. Охват выгрузки по потокам задаётся строкой enable-signals с тремя уровнями.
Как проверить на узле
Результат виден в самом письме — проверять надо по доставленному:
grep -i "signals\|html" /var/log/pmta/log | tail -20
Надёжнее посмотреть письмо, дошедшее до контрольного ящика: ссылки и пиксели в нём либо есть, либо нет.
В Хабе
Цена ошибки
обратимо: вредит, пока стоит
Сценарии
Инфраструктура трекинга