Первая Mobile push-рассылка
Мобильные push-уведомления отображаются по мере получения в центре уведомлений мобильного устройства — в шторке Android и iOS смартфонов, планшетов и других гаджетов.
Это руководство поможет вам организовать рассылку мобильных push-уведомлений в платформе Altcraft.
Push-уведомления подходят для регулярной коммуникации с пользователями приложения и не требуют номера телефона получателя.
Шаг 1: Настройте домен для работы с Push
Убедитесь, что и ваш веб-сайт, и платформа работают по протоколу HTTPS.
Если вы пользуетесь облачным решением, пропустите следующий шаг и перейдите к настройкам подписки.
При установке Altcraft Platform на ваше оборудование On-premises передайте инструкции из этого шага администраторам вашей платформы. Или свяжитесь с нашей службой поддержки!
Для платформы должен быть настроен pixel-домен. Также необходимо активировать push-уведомления в Панели администратора для аккаунтов, с которых планируется отправка:

Шаг 2: Настройте проект мобильного провайдера
В зависимости от выбранного провайдера создайте проект на его стороне и получите данные, необходимые для настройки ресурса в платформе:
- Firebase Cloud Messaging — проект в Firebase Console.
- APNs — ключ или сертификат в Apple Developer.
- AppMetrica — приложение в AppMetrica.
- Huawei Mobile Services — проект в AppGallery Connect.
- RuStore — проект push-уведомлений в RuStore Console.
Шаг 3: Создай те базу данных и ресурс подписок
Рассылки Altcraft Platform получают ваши подписчики. Профили подписчиков хранятся в базах данных профилей.
Рассылки при отправке Push используют подписки профиля на Ресурсы: так вы можете отправлять уведомления на различные устройства клиента. Ресурсом может быть отдельное направление маркетинга, сайт, приложение или тип контента.
Создайте базу данных профилей, если её ещё нет. Затем создайте новый ресурс с Push-каналом:

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

В настройках Push-канала ресурса выберите платформы, на которые собираетесь отправлять уведомления, и внесите настройки провайдера, полученные на предыдущем шаге:

Шаг 4: Интегрируйте mSDK в приложение
Для работы Mobile Push требуется интеграция Altcraft mSDK в мобильное приложение. mSDK обрабатывает подключение к push-провайдеру, отправку токенов подписок, отображение уведомлений и регистрацию событий.
Авторизация через JWT-токен
При настройке ресурса используйте JWT-токен для авторизации mSDK. Токен формируется и подписывае тся на сервере приложения, что обеспечивает безопасность и позволяет искать профили по любым идентификаторам (email, телефон, custom ID). Поддерживается несколько пользователей на одном устройстве и восстановление профиля после переустановки приложения.
Для работы JWT потребуется подготовить бэкенд приложения для генерации и подписи токенов. Подробнее — в статье Работа с ролевым и JWT-токеном.
В качестве альтернативы доступен rToken (ролевой токен), при котором матчинг профилей происходит только по push-токену. Этот вариант менее надёжен и ограничивает возможности — профиль может быть «потерян» при смене устройства или переустановке приложения.
Передайте разработчикам приложения токен ресурса и следуйте инструкции по быстрому старту для вашей платформы:
Подписка на Yandex.AppMetrica может добавляться автоматически пользователям приложения с подключенным сервисом метрики. Подробнее в статье Интеграция с Yandex.AppMetrica.
Шаг 5: Подготовьте контент для отправки
Контент для ваших Push-рассылок создаётся в Шаблонах сообщений. Шаблоны содержат контент для всех доступных каналов. При создании нового шаблона выберите Push-канал, или добавьте его для существующего.
Push-версия шаблона содержит:
- Заголовок — аналогичен теме Email письма.
- Иконка — любое изображение для отображения в уведомлении.
- Тело сообщения — основная текстовая часть сообщения.
- Ссылка для перехода — ссылка, по которой перейдёт подписчик при нажатии на push. Отдельно настраивается deeplink для каждой платформы.
В заголовок, ссылку и тело сообщения вы можете добавить данные конкретного клиента, а также динамический текстовый контент из внешних источников:

Если вы рассылаете Rich push уведомления, то для создания шаблона вам стоит воспользоваться специальным редактором. В Rich push уведомления можно добавлять не только текст и иконку, но и кнопки, изображения, банеры и даже аудио и видеофайлы. Более того, новый редактор позволяет отдельно настраивать уведомление для определенной ОС, а также добавлять адаптивные ссылки и deeplink.
Чтобы открыть новый редактор, создайте начальную версию push-сообщения и сохраните шаблон. Затем вернитесь к созданному шаблону и нажмите воспользуйтесь редактором β, чтобы перейти в новый редактор.

Шаг 6: Выберите тип рассылки
![]() | Для отправки Push-сообщений используется инструмент Рассылка. |

Определитесь с датой и создайте рассылку нужного типа:

Подробную инструкцию по настройке Броадкаста вы найдёте на этой странице.
Подробную инструкцию по настройке Регулярной рассылки вы найдёте на этой странице.
- Выбрать Push как канал связи
- Выберите провайдеров для рассылки и режим отправки. Есть два вида отправки — fanout, рассылка на все подписки с учетом фильтров, или last, отправка на подписку с самой свежей датой создания. Если несколько подписок были созданы одновременно, то из них будет выбрана одна случайная. Если в рассылке заданы фильтры по провайдеру, дополнительным полям или категориям, то сначала накладываются фильтры, а потом уже ищется самая свежая подписка.
- Выбрать настроенный ранее ресурс подписок и аудиторию получателей
- Добавить в рассылку шаблон сообщения
- Установить расписание. Например, для броадкаста подойдёт вариант "В определённую дату в выбранное время":

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

Шаг 7: Оцените эффективность рассылки
Журнал рассылок
Журнал рассылок — это инструмент, предоставляющий краткую сводку о ходе выполнения рассылки. В нем фиксируются ключевые события, параметры рассылок и статистика, что позволяет выявить возможные проблемы.
Чтобы открыть журнал рассылки, нажмите на кнопку Журнал в меню быстрых действий:

Журнал рассылки содержит следующую информацию:
| Тип | Описание |
|---|---|
| Запуск рассылки | Время начала выполнения Push-рассылки |
| Лимит | Показывает, установлен ли лимит на количество Push-уведомлений |
| Источник подписчиков | Источник контактов: List — База данных Segment — Сегмент |
| ID сегмента / ID базы данных | Идентификатор сегмента или базы данных |
| Время получения данных | Время загрузки данных из сегмента или базы данных(мс) |
| Количество профилей из источника | Общее число профилей в базе данных или сегменте |
| Количество найденных подписчиков | Число пользователей в выбранной базе данных или сегменте с активной подпиской на выбранный ресурс |
| Количество подписчиков без push-подписок | Профили без разрешения на Push-уведомления |
| Количество отправленных Push | Фактическое число успешных отправок |
| Профилей игнорировано настройками ресурса | Пользователи, исключённые по правилам рассылки |
| Рассылка завершена | Время окончания рассылки |
| Всего времени затрачено | Общая продолжительность рассылки |

Отчеты и Аналитика
Для оценки результатов ваших рассылок воспользуйтесь отчетом по каналам.Отчёт по каналам предоставляет аналитику по одной или нескольким рассылкам, по одному или нескольким каналам связи.
На платформе есть три способа получения аналитики по текущей рассылке:
- К отчёту по каналам конкретной рассылки можно перейти по ссылке в редакторе рассылки:

- Вызов аналитики по текущей рассылке также возможен через меню быстрых действий:

- Выберите раздел Аналитика по Каналам в главном меню платформы. По умолчанию отобразится отчет по Всем каналам за последние 7 дней. Для группировки по Push-каналу выберите "Отчет по":

Следующим шагом Добавьте фильтр по Рассылкам. В отобразившемся списке выберите нужную рассылку.

В результате отобразится статистика по выбранной рассылке.

Действия в Push-рассылке или шаблоне могут стать шагами в интерактивной воронке конверсии:

