Вы можете перенести существующих подписчиков на push-уведомления ваших iOS и Android приложений в PushEngage, повторно используя те же учетные данные Apple и Firebase, которые уже использует ваше приложение. Поскольку токены устройств выдаются Apple и Google, а не вашим поставщиком push-уведомлений, сохранение этих учетных данных позволяет вашим токенам продолжать работать после переключения. Это руководство объясняет, как работает миграция и шаги по ее настройке. Миграция — это серверный процесс, выполняемый совместно с нашей командой.
Прежде чем начать
- Создайте свою учетную запись PushEngage.
- Имейте доступ к своим учетным данным для push-уведомлений Apple, в частности к идентификатору push-уведомлений вашего приложения (App Push ID) и сертификату p12 из вашей учетной записи разработчика Apple.
- Имейте доступ к настройкам Android Firebase, в частности к идентификатору отправителя Firebase (Firebase Sender ID).
- Имейте возможность экспортировать данные ваших подписчиков от текущего поставщика.
Как работает миграция мобильных приложений
Токены устройств для push-уведомлений приложений поступают из службы push-уведомлений Apple (APNs) и Firebase Cloud Messaging (FCM), а не от вашего текущего поставщика. Если вы настроите PushEngage с теми же учетными данными APNs и FCM, которые вы уже используете, эти токены останутся действительными, а миграция произойдет на стороне сервера.
Разрешение на уведомления также переносится. Если пользователь уже предоставил разрешение на уведомления в вашем приложении, ему не нужно будет предоставлять его снова после миграции.
Шаги по миграции
Шаг 1: Экспорт подписчиков от текущего поставщика
Экспортируйте данные ваших подписчиков, используя любой из методов, предлагаемых вашим поставщиком:
- Экспорт через API с использованием идентификатора приложения и ключа API вашего текущего поставщика.
- Экспорт в CSV с файлом, включающим
identifier,device_type,languageи любые другие соответствующие поля.
Шаг 2: Настройка Android FCM в PushEngage
- Войдите в панель управления PushEngage.
- Перейдите в раздел Настройки » Установка » Android SDK.
- Настройте параметры Google Android FCM, используя тот же идентификатор отправителя Firebase (Firebase Sender ID), который вы уже используете.
Шаг 3: Настройка iOS APNs в PushEngage
- В панели управления PushEngage перейдите в раздел Настройки » Установка » iOS SDK.
- Настройте параметры Apple iOS APNs, используя тот же идентификатор push-уведомлений приложения (App Push ID) из вашей текущей настройки.
- Загрузите сертификат p12 из вашей учетной записи разработчика Apple, тот же, который вы уже используете.
Важные замечания о переходе на новую версию приложения
Миграция push-уведомлений приложения зависит от того, какую версию вашего приложения использует подписчик, поэтому тщательно спланируйте переход к выпуску.
- Старые версии приложения с SDK предыдущего поставщика. После миграции подписчики, использующие старые версии приложения, не будут получать уведомления, отправленные из PushEngage, поскольку пакет PushEngage не может быть декодирован старым SDK.
- Новые версии приложения с PushEngage SDK. Если вы отправляете уведомления с панели управления предыдущего поставщика после миграции, эти уведомления не появятся в новых версиях приложения, поскольку старый полезный груз не может быть декодирован PushEngage SDK.
Короче говоря, отправляйте уведомления из PushEngage для пользователей новой версии приложения и ожидайте, что пользователи, которые не обновились, перейдут на новую версию по мере обновления приложения.
Часто задаваемые вопросы
Должны ли подписчики снова предоставлять разрешение на уведомления?
Нет. Если разрешение уже было предоставлено в вашем приложении, его не нужно предоставлять повторно после миграции.
Получат ли все подписчики уведомления сразу после миграции?
Пользователи новой версии приложения с PushEngage SDK — да. Пользователи, которые все еще используют старую версию приложения с SDK предыдущего поставщика, не будут получать уведомления PushEngage до тех пор, пока не обновят приложение.
Почему я должен повторно использовать те же учетные данные APNs и Firebase?
Потому что токены устройств привязаны к этим учетным данным. Повторное использование того же идентификатора приложения Push, сертификата p12 и идентификатора отправителя Firebase сохраняет ваши существующие токены действительными, что и делает миграцию возможной без необходимости повторной регистрации пользователей.
Какие данные мне нужны от моего текущего поставщика?
Либо экспорт API с использованием идентификатора приложения и ключа API вашего поставщика, либо CSV-файл, который включает как минимум identifier, device_type и language, а также любые другие соответствующие поля.
Если у вас возникнут какие-либо проблемы, пожалуйста, свяжитесь с нами, нажав здесь. Наша служба поддержки сможет вам помочь.