Admin Guide

Сообщения

Сообщение — это push-уведомление, отправленное группе пользователей. В разделе «Сообщения» создаются кампании: разовые и запланированные рассылки с гибкими настройками аудитории и содержимого.

Статусы сообщений

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

draft
→
scheduled
→
sending
→
sent
→
cancelled
draft
Черновик

Сообщение сохранено, но не отправлено. Сохраняется как исторический артефакт при некоторых сценариях.

scheduled
Запланировано

Сообщение ожидает наступления указанного времени. Автоматически переходит в sending, когда воркер опрашивает очередь (каждые 15 секунд).

sending
Отправляется

Воркер активно рассылает уведомления. Аудитория разбивается на пакеты по 500 подписчиков.

sent
Отправлено

Все пакеты обработаны. Доставка завершена — доступна аналитика.

cancelled
Отменено

Сообщение было отменено вручную до начала или во время отправки.

Создание сообщения

Нажмите «Создать сообщение» в toolbar. Форма состоит из трёх блоков.

Блок 1: Аудитория

Определяет, кто получит уведомление.

Отправить всем

Уведомление получат все активные подписчики приложения (все браузеры с разрешением). Используйте для важных общих анонсов.

По сегментам

Выберите один или несколько Include-сегментов (кто получит) и, при необходимости, Exclude-сегменты (кого исключить). Аудитория = объединение Include минус пересечение с Exclude.

💡
Один и тот же сегмент нельзя добавить одновременно в Include и Exclude — система покажет ошибку валидации.

Блок 2: Содержимое уведомления

Выберите источник контента: вручную или из шаблона.

ПолеОбязательноеОписание
ЗаголовокДаЗаголовок уведомления. Рекомендуется до 60 символов — длинные заголовки обрезаются браузером.
ТекстДаТело уведомления. До 120–200 символов в зависимости от платформы.
URLНетСтраница, которая откроется при клике на уведомление. Если не указан — откроется главная страница приложения.
ИзображениеНетURL изображения, отображаемого в уведомлении (большое фото). Поддерживается в Chrome и Edge на десктопе. Рекомендуемый размер: 1080×565.
ТегНетSlug-строка для группировки уведомлений в браузере. Уведомление с тем же тегом заменяет предыдущее.
ℹ️
В поле Тег уведомления используйте slug-строку (например orders или promo). Если браузер получает два уведомления с одинаковым тегом, второе заменяет первое — это предотвращает «спам» уведомлений для одного события.

Из шаблона

Переключите источник на «Из шаблона» и выберите нужный шаблон из списка. Поля Заголовок, Текст, URL, Изображение и Тег заполнятся автоматически из шаблона и будут недоступны для редактирования. Для изменения контента — создайте новый шаблон или отредактируйте существующий.

Шаблонные переменные

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

ПеременнаяЧто подставляетсяГде применять
{{ title }}Заголовок сообщенияURL, изображение, тег
{{ sendDate }}Дата отправки в формате YYYY-MM-DDURL, тег
{{ messageId }}Уникальный ID сообщенияURL, тег
{{ tag.KEY }}Значение тега KEY конкретного пользователя — уникально для каждого получателяURL, тег
text
// URL — UTM tags with campaign name and date:
https://example.com/promo?utm_campaign={{ title }}&utm_content={{ messageId }}&date={{ sendDate }}

// Tag — unique for each broadcast (notifications don't replace each other):
{{ messageId }}

// Tag — fixed (repeat broadcast replaces previous unread):
promo
💡
Переменные особенно полезны в поле Тег уведомления: если передать {{ messageId }} как тег, каждая рассылка получит уникальный тег — уведомления разных кампаний не будут вытеснять друг друга в браузере пользователя. Напротив, фиксированный тег (например promo) означает, что повторная рассылка заменит предыдущее непрочитанное уведомление.

Персональные переменные из тегов пользователя

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

{{ tag.KEY }}— подставляет значение тега KEY для каждого получателя индивидуально

При отправке воркер заменяет переменную на значение тега этого конкретного пользователя. Каждый получатель видит свою персонализированную ссылку.

Пример: брошенный просмотр товара

1
На сайте: устанавливаем тег пользователю

Когда пользователь просматривает товар, ваш сайт записывает тег. В Пользователи → карточка пользователя → Теги вы увидите:

js
// Tag is set automatically by your site
// when the user views a product page.
//
// In Users → user profile → Tags you will see:
//
//   Key                          Value
//   dropped_view_product_url     /products/iphone-15-pro
//   last_category                electronics
2
В шаблоне сообщения: используем тег в URL

В поле «Click URL» шаблона указываем переменную:

text
// "Click URL" field in the message template:
https://example.com{{ tag.dropped_view_product_url }}
3
При отправке: каждый получает свою ссылку

Воркер подставляет значение тега для каждого пользователя:

text
// User user-42 (tag = "/products/iphone-15-pro"):
→  https://example.com/products/iphone-15-pro

// User user-99 (tag = "/products/samsung-s24"):
→  https://example.com/products/samsung-s24

// User user-01 (tag not set):
→  https://example.com  ← empty string instead of variable
⚠️
Если тег не установлен у пользователя — переменная заменяется пустой строкой. URL вида https://example.com будет работать как ссылка на главную. Лучше заранее сегментировать аудиторию: отправляйте кампанию только тем, у кого тег dropped_view_product_url существует. Для этого в сегменте добавьте правило «Тег "dropped_view_product_url" существует».

Где настраиваются теги пользователей

Теги хранятся в профиле каждого пользователя и управляются из раздела Пользователи:

1
Перейдите в Пользователи и найдите нужного по External ID.
2
Откройте карточку пользователя — блок «Теги» отображает все установленные теги с их ключами и значениями.
3
Доступные действия:
  • Добавить тег — кнопка «+» в заголовке блока → укажите ключ и значение.
  • Редактировать — кнопка «⋮» напротив тега → «Редактировать» → измените ключ или значение → Сохранить.
  • Удалить — кнопка «⋮» → «Удалить».
ℹ️
Теги устанавливаются автоматически вашим сайтом в момент события (просмотр товара, добавление в корзину и т.д.). Ручное управление в админке полезно для отладки, корректировки значений или добавления тестовых тегов перед запуском кампании.

Блок 3: Режим отправки

Отправить сейчас

Сообщение немедленно ставится в очередь и начинает доставляться активным подписчикам. Статус сразу становится sending.

Запланировать

Укажите дату и время в будущем. Сообщение получает статус scheduled и будет отправлено автоматически в указанный момент. Запланированное сообщение можно отменить пока оно не перешло в sending.

Предпросмотр

В форме создания отображается живой предпросмотр уведомления — как оно будет выглядеть на устройстве пользователя (с заголовком, текстом и URL). Проверьте его перед отправкой.

Аналитика сообщений

На детальной странице каждого отправленного сообщения доступна воронка доставки:

Sent

Количество подписчиков, которым была предпринята попытка доставки.

Delivered

Уведомление успешно принято браузером (push-сервер вернул 200/201).

Clicked

Пользователь нажал на уведомление.

Failed

Доставка не удалась (истёкший endpoint, сетевая ошибка).

CTR

Clicked ÷ Delivered × 100%. Показатель вовлечённости аудитории.

ℹ️
CTR (Click Through Rate) = Clicked ÷ Delivered × 100%. Хороший показатель для web push — 5–15% в зависимости от тематики.

Отмена запланированного сообщения

Откройте детальную страницу сообщения в статусе scheduled и нажмите «Отменить». После перехода в статус sending отмена невозможна — доставка уже началась.

Связи с другими разделами

← Сегменты

Создайте сегменты заранее, чтобы использовать их в поле «По сегментам».

← Шаблоны

Создайте шаблоны сообщений для повторно используемого контента кампаний.

← Настройки → UTM

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