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

enable-top-open-pixel

<signals>

Отслеживать ли открытия — по картинке вверху письма
в конфигурации это строкаenable-top-open-pixel 1внутри блока <signals>
Одна из трёх вставок в письмо

При отслеживании силами MTA он вставляет прозрачную картинку в начало письма. Строка позволяет эту часть выключить. Умолчание — yes.

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

Картинка вверху срабатывает чаще: письмо часто дочитывают не до конца.

🔴 Работает только при engagement-tracking со значением sparkpost. При external события шлёте вы сами, и вставлять MTA нечего.

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

Выключают отдельные вставки редко и по конкретной причине:

Значение Когда
yes (умолчание) отслеживание включено и нужно целиком
no эта конкретная вставка мешает вёрстке или политике
Умолчание yes и условие «только при отслеживании силами MTA» — из руководства (§ 11.1.6.2.5). Замечание о том, чем различаются две картинки, — наше.
Пример в конфигурации
# выключаем одну вставку, остальные две работают
<signals>
    engagement-tracking sparkpost
    enable-top-open-pixel no</signals>
Три вставки независимы: выключение одной не отменяет остальных.
жёлтым — — имена директив, голубым — блоки. Так же они подсвечены и в тексте карточки.
▲

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

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

Выключают вставку, рассчитывая сохранить метрику

наш опыт

Чем чреватоМетрика считается по вставке. Без неё соответствующих событий не будет вовсе, и оценка здоровья станет неполной.
Как заметитьОткрытия или переходы в отчётах упали до нуля.
Как правильноВернуть умолчание либо принять, что этой метрики не будет.
Совместимость
PowerMTA 6.0
описана в руководстве этой версии · платформа: любая
С какой версии директива доступна, вендор указывает не для всех — здесь пометки нет. Имя встречается и в издании руководства 5.0.
Справочные данные
Синтаксис
enable-top-open-pixel yes | no
Значения
yes | no | true | false
Умолчание
1 § 11.1.6.2.5
Применение
reload, перезапуск не нужен
Очередь
уже поставленное в очередь не затронет
Где писать
<signals>
Сколько раз
один раз в блоке
Всё здесь — из руководства, с разделом.
Наследование
Наследования нет: строка живёт внутри <signals>, а такой блок на узле один. Выборочно по потокам вставки не настраиваются — только охват выгрузки целиком, строкой enable-signals.
⇄

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

1 связь

Работают в паре

enable-bottom-open-pixel<signals>Вторая картинка той же пары: одна вверху письма, другая внизу. § 11.1.6.2.6

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

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

3 статьи

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

В Хабе
Цена ошибки
безопасно: неверное значение ничего не ломает
Сценарии
Инфраструктура трекинга
Соседние настройки блока <signals>:html-edit-error-modetracking-domainengagement-trackingenable-click-trackingenable-bottom-open-pixelВсе 16 директив блока →