Для отправки мобильных пуш-уведомлений (Mobile Push) необходимо привязать мобильное приложение к сервису, после чего создать и настроить сообщение.

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

Чтобы привязать ваше мобильное приложение перейдите в Настройки ➔ Рассылки

Вам необходимо заполнить:

• Название приложения - используется как служебное имя и отображается в предпросмотре Mobile Push
• Способ подключения - Firebase Cloud Messaging

Настройка для Firebase Cloud Messaging

• Загрузите Firebase service account key (.json)

Firebase service account key вы можете получить у разработчиков, поддерживающих ваше приложение. Если ранее вы уже отправляли Mobile Push - все необходимое уже у вас есть, если же вы хотите начать отправлять Mobile Push - нужно зарегистрировать и получить все необходимые данные.

После завершения настройки сообщите об этом вашему персональному менеджеру для активации модуля.

Для того чтобы создать Mobile Push уведомление перейдите в раздел Рассылки ➔ Сообщения ➔ Новое сообщение и выберите канал Mobile Push

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

В мастере создания вы можете задать настройки отправки:

• Тема сообщения (на устройствах в теме отображается примерно 50 символов)
• Текст сообщения (около 200 символов)
• URL перехода - это действие при тапе по Mobile Push уведомлению (можно выбрать один из трех доступных вариантов: URL, Deeplink, Открытие приложения)
• URL изображения - ссылка на картинку, которая будет отображаться справа в Mobile Push

После того, как все настройки отправки заполнены, вы можете задать дополнительные настройки. Они не являются обязательными, но позволят персонализировать Mobile Push и сделать его более заметным для получателя.

• Кнопки - вы можете добавить до 3-х кнопок в свое уведомление, для каждой кнопки необходимо задать текст и действие при тапе по ней (три варианта аналогично настройке URL перехода)
• UTM метки и URL параметры - работают только в ссылках типа URL

Вы можете менять вид отображения для iOS и Android

На этом же шаге можно отправить тестовое Mobile Push, чтобы проверить, корректно ли отображается сообщение, и при необходимости исправить его до отправки пользователям.

Дополнительно в том же окне вы сможете отслеживать статус отправки тестового Mobile Push и узнать причину, если сообщение не дошло (например, если был введен невалидный токен).

Тестовая отправка доступна при создании или редактировании Mobile Push-сообщения. Перейдите в Рассылки → Сообщения → Мастер создания сообщения (Mobile Push). На шаге «Редактор сообщения» заполните обязательные поля:

• Тема сообщения;
• URL перехода.

Кнопка «Отправить тестовое сообщение» станет активной. По нажатию на нее в открывшемся окне:

• введите токен устройства вручную или выберите из списка ранее использованных;
• выберите операционную систему (Android или iOS) - важно выбрать соответствующую токену ОС, так как она будет записана в базу;
• нажмите «Отправить» (кнопка станет активной только после ввода токена).

В окне отобразится статус отправки тестового Mobile Push в реальном времени:

• Идет отправка - с индикатором загрузки;
• Доставлено - сообщение было успешно доставлено на устройство получателя;
• Не отправлено - с текстом ошибки, например, «Requested entity was not found.»

Ограничения и особенности

• Можно ввести только один токен за раз.
• Можно отправлять тесты даже на токены, которые:
  • отписаны;
  • не добавлены в базу контактов enKod - после тестовой отправки они будут добавлены;
  • удалены - после тестовой отправки контакт будет восстановлен из удаленных.
• Статистика тестовых отправок сохраняется до тех пор, пока вы не выйдете из Мастера создания сообщения (Mobile Push).

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

В сегментах на отправку Mobile Push получатели пересчитываются по количеству уникальных контактов, однако за одним контактом может быть закреплено более одного устройства. В связи с этим количество отправленных сообщений (отображаются в Детали сообщения ➔ Статистика по количеству устройств) может быть больше ожидаемого. В разделе Детали сообщения ➔ Информация ➔ Получатели вы можете отслеживать количество получателей, отправленных и не отправленных сообщений отдельно по уникальным контактам и отдельно по количеству устройств.

Если в получателях есть неактуальный мобильный токен (Firebase Cloud Messaging возвращает ошибку requested entity was not found), то сообщение не будет ему доставлено, а сам токен будет автоматические отписан.