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

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

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, замыкающий цикл. Пользователи о чём-то просят, ваша команда это делает, тот, кто просил, узнаёт об этом.