Mobile Push
Для отправки мобильных пуш-уведомлений (Mobile Push) необходимо:
- настроить мобильное приложение в сооветствии с инструкциями
- привязать мобильное приложение к сервису
- создать и настроить уведомления в enKod
Настройка мобильного приложения
Настройка мобильного приложения требует опыта работы с мобильными приложениями. Если вы не обладаете таким опытом - обратитесь к разработчикам вашего мобильного приложения.
Настройте мобильное приложение согласно инструкциям:
Привязка приложения в enKod
Для подключения приложения необходим опыт работы с мобильными приложениями. Если вы не обладаете таким опытом - обратитесь к разработчикам вашего мобильного приложения. Если ранее вы уже отправляли Mobile Push - Firebase service account key и Huawei-ключи уже у вас есть, если же вы хотите начать отправлять Mobile Push - нужно зарегистрировать и получить все необходимые данные.
Чтобы привязать ваше мобильное приложение перейдите в Настройки ➔ Рассылки
Заполните настройки:
- Название приложения - отображается только в сервисе в предпросмотре Mobile Push и в таблице объема базы
Android и iOS
В данный момент доступна настройка только через Firebase Cloud Messaging.
- Загрузите Firebase service account key (.json), который можно получить в учетной записи Firebase (Project Settings → Cloud Messaging → Service Account → Google Cloud Console в разделе Service Account выберите Keys) и сохраните изменения
HarmonyOS
Настройка мобильного приложения для устройств Huawei.
- Введите Huawei App Id и Huawei App Secret, которые можно получить в Huawei App Gallery Connect (My projects → Project settings → General information → App information→ OAuth 2.0 client ID) и сохраните изменения
После завершения настройки сообщите об этом вашему персональному менеджеру для активации модуля.
Мастер создания
Для того чтобы создать 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
В сегментах на отправку Mobile Push получатели пересчитываются по количеству уникальных контактов, однако за одним контактом может быть закреплено более одного устройства. В связи с этим количество отправленных сообщений (отображаются в Детали сообщения ➔ Статистика по количеству устройств) может быть больше ожидаемого. В разделе Детали сообщения ➔ Информация ➔ Получатели вы можете отслеживать количество получателей, отправленных и не отправленных сообщений отдельно по уникальным контактам и отдельно по количеству устройств.
Автоматическая отписка Mobile Push токенов
Если в получателях есть неактуальный мобильный токен (Firebase Cloud Messaging возвращает ошибку requested entity was not found
), то сообщение не будет ему доставлено, а сам токен будет автоматические отписан.