Релиз-ноты на практике

Шаблон письма об обновлении продукта, которое читают

5 мин чтения обновлено

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

Что такое письмо об обновлении продукта?

Это сообщение, рассказывающее существующим пользователям, что изменилось в продукте, которым они уже пользуются. Есть четыре разных типа, и обращение с ними как с одним списком — причина падения open rate. У каждого свой триггер, своя аудитория и своя приемлемая частота.

ТипТриггерАудиторияЧастота
Целевое уведомлениеКонкретный запрос кого-то выпущенОдин человекКаждый раз
Уведомление о breaking changeИзменение, стоящее читателю работыТолько затронутые аккаунтыКаждый раз
ДайджестТечение времениПользователи opt-inНе чаще раза в месяц
Анонс запускаЗапуск, стоящий прерыванияСегмент или всеРедко, и должно ощущаться редким

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

Все эти четыре строки написаны для клиентов. Продажам, саппорту и customer success тоже нужно знать, что вышло, обычно в форме, отличной от этих четырёх; внутренние release notes разбирают, что должен говорить этот документ и почему он должен выходить раньше заметки для клиентов.

Email — один из нескольких каналов, которые может использовать анонс запуска, не единственный. Как анонсировать новую функцию описывает остальные и как выбирать между ними в зависимости от того, насколько велика функция на самом деле.

Что входит в шаблон?

Шесть блоков в таком порядке. Первый — тот, которого обычно не хватает, и тот, что делает работу.

Тема:  <что изменилось, словами читателя>

1. Почему вы это получаете
   "Вы просили экспорт в CSV в марте." или
   "Ваша интеграция вызывает /v1/invoices, который меняется
   15 января."

2. Что изменилось
   Одно предложение. Что теперь возможно, или что теперь ломается.

3. Что вам нужно сделать
   Часто "ничего". Скажите это явно, не оставляйте подразумеваемым.

4. Где это увидеть
   Ссылка на запись changelog, а не на главную страницу.

5. Когда
   Дата выпуска, или с какого момента это действует.

6. Как отписаться
   Один клик, немедленно уважаемый.

Блок 1 — разница между сообщением и общей рассылкой. Читатель, которому в первой строке говорят, что это решение того, о чём он лично просил, читает дальше. Без него блоки 2-5 — рассылка, каким бы хорошим ни был текст.

Держите всё в пределах примерно 150 слов. Письмо — указатель на запись changelog, и именно там место деталям. Письмо, воспроизводящее всю запись целиком, не даёт читателю причины кликнуть, а вам — сигнала, было ли это кому-то важно.

Какие темы работают?

Называйте изменение, а не релиз. “Экспорт в CSV уже доступен” побеждает “обновление за сентябрь”, потому что первое — факт, который читатель может оценить, а второе — контейнер. Номера версий в теме полезны вызывающим API и шум для всех остальных, ещё одна причина разделить аудитории.

Избегайте заявлений о выгоде, на которую читатель не соглашался. “Ваши отчёты теперь быстрее” заявляет что-то о его опыте; “Отчёты свыше 10 000 строк теперь загружаются меньше чем за секунду” сообщает об изменении и позволяет ему решить, важно ли это.

Когда его отправлять, и кому?

Отправляйте целевое уведомление в момент, когда что-то выпущено, людям, которые это просили, индивидуально. Отправляйте уведомление о breaking change сразу, как дата станет точной, и ещё раз ближе к ней, реально затронутым аккаунтам, а не всему списку. Отправляйте дайджест, только если у вас достаточно изменений, чтобы читатель иначе что-то пропустил, и дайте людям подписываться отдельно.

Список, который почти никогда не стоит использовать, — “все пользователи”. Он превращает конкретное сообщение в общее и приучает к отпискам. Сегментируйте по поведению, которое вы уже храните: кто это просил, кто использует этот endpoint, кто на этом плане.

Нужно ли согласие на отправку?

Для существующих клиентов обновление об услуге, которой они пользуются, обычно другой юридический вопрос, чем маркетинг потенциальному клиенту, и ответ зависит от того, где они находятся, и что вы сказали им при регистрации. В ЕС релевантный вопрос — какое правовое основание из статьи 6 GDPR применимо, а в США коммерческие сообщения несут конкретные требования, установленные в руководстве по соответствию CAN-SPAM от FTC. Оба на практике требуют одного и того же: скажите, кто вы, проясните цель, и дайте людям возможность остановить рассылку.

Каким бы ни было основание, держите транзакционный и маркетинговый потоки раздельными на уровне отправки. Уведомление о breaking change, от которого клиент отписался, потому что оно делило список с промо-дайджестом, — это инцидент поддержки, ждущий своей даты.

Как это выглядит заполненным?

Целевое уведомление — самое ценное письмо об обновлении продукта и то, которое большинство команд никогда не строят:

Тема: Экспорт в CSV уже доступен

Привет, Дана,

ты просила экспорт в CSV в марте.

Это стало доступно сегодня утром. У отчётов теперь есть
кнопка Export, создающая CSV текущего вида, включая фильтры.

С твоей стороны ничего делать не нужно. Уже включено на
твоём аккаунте.

  Подробности: example.com/changelog#csv-export
  Выпущено: 2 сентября 2026

Ты получаешь это, потому что просила. Отписаться от
обновлений по запросам: <ссылка>

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

Что стоит измерять?

Не только open rate. Для целевого уведомления вопрос в том, вернулся ли попросивший человек и воспользовался ли этим, так что число для отслеживания — клик к записи и использует ли этот аккаунт функцию в течение недели. Для уведомления о breaking change это покрытие: какая доля затронутых аккаунтов открыла письмо до даты, и с кем вы связались индивидуально.

Дайджест — единственный из четырёх типов, где open rate что-то значит, и даже там он полезнее как тренд относительно собственной истории, чем относительно отраслевого бенчмарка. У разных типов писем об обновлении продукта разные задачи, так что усреднённая по всем цифра не описывает ничего, на что можно опереться в действиях.

Чем это отличается от release notes?

Release notes — документ, который остаётся доступным. Письмо — механизм доставки, случающийся один раз. Одно и то же изменение порождает оба, и письмо должно быть короче записи, на которую указывает. Лучшие практики release notes охватывает документ, а changelog против release notes охватывает, какой из них вы пишете.

Отношение, которое стоит наладить правильно: запись changelog — канонический текст, а письмо его цитирует. Когда эти два расходятся, читатель, кликнувший по ссылке, находит другое описание изменения и перестаёт доверять обоим. Публикация записи первой и генерация письма из неё убирает расхождение конструктивно. changeloop со своей стороны работает так же: запись рецензируется один раз и публикуется на странице, в потоке и виджете, а человека, попросившего о ней через виджет, оповещают в GitHub issue, которым стал его отзыв, и в самом виджете. Письмо changeloop не отправляет; ваш почтовый инструмент цитирует опубликованную запись.

FAQ

Как часто должно выходить письмо об обновлении продукта? Так часто, как есть что-то конкретное, что получатель хочет знать, что для целевого уведомления означает каждый раз, когда выпускается его запрос, а для дайджеста — не чаще раза в месяц.

Должно ли письмо содержать всю запись changelog целиком? Нет. Одно предложение и ссылка. Запись — каноническая версия, а полная копия в письме означает два текста, которые нужно держать согласованными.

Какой open rate стоит ожидать? Сравнивайте каждый тип с самим собой, а не с бенчмарком. Целевое уведомление и месячный дайджест — разные продукты, и их усреднение скрывает единственную цифру, за которой стоит следить.

Нужен ли отдельный список для breaking changes? Да, и это должен быть тот список, от которого люди не могут отписаться небрежно, не понимая последствий, потому что это тот список, что стоит им сбоя.


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

По теме на changeloop: Примеры changelog, Документация для разработчиков

changeloop
Команда, которая делает changelog, замыкающий цикл. Пользователи о чём-то просят, ваша команда это делает, тот, кто просил, узнаёт об этом.