Миграция подписчиков мобильных приложений на PushEngage

Вы можете перенести существующих подписчиков на 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

1. Войдите в панель управления PushEngage.
2. Перейдите в раздел Настройки » Установка » Android SDK.
3. Настройте параметры Google Android FCM, используя тот же идентификатор отправителя Firebase (Firebase Sender ID), который вы уже используете.

Шаг 3: Настройка iOS APNs в PushEngage

1. В панели управления PushEngage перейдите в раздел Настройки » Установка » iOS SDK.
2. Настройте параметры Apple iOS APNs, используя тот же идентификатор push-уведомлений приложения (App Push ID) из вашей текущей настройки.
3. Загрузите сертификат 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, а также любые другие соответствующие поля.

Если у вас возникнут какие-либо проблемы, пожалуйста, свяжитесь с нами, нажав здесь. Наша служба поддержки сможет вам помочь.