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