Первая 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, отправка на подписку с самой свежей датой создания. Если несколько подписок были созданы одновременно, то из них будет выбрана одна случайная. Если в рассылке заданы фильтры по провайдеру, дополнительным полям или категориям, то сначала накладываются фильтры, а потом уже ищется самая свежая подписка.
- Выбрать настроенный ранее ресурс подписок и аудиторию получателей
- Добавить в рассылку шаблон сообщения
- Установить расписание. Например, для броадкаста подойдёт вариант "В определённую дату в выбранное время":

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

