既存のiOSおよびAndroidアプリのプッシュ購読者を、アプリが既に利用しているのと同じAppleおよびFirebase認証情報（クレデンシャル）を再利用することでPushEngageに移行できます。デバイスートークンはプッシュプロバイダーではなくAppleおよびGoogleによって発行されるため、これらの認証情報を保持することで、切り替え後もトークンが引き続き機能します。このガイドでは、移行がどのように機能するか、および設定手順について説明します。移行は、当社のチームと協力して処理されるバックエンドプロセスです。
開始する前に
- PushEngageアカウントを作成します。
- Appleプッシュ認証情報、特にApple Developerアカウントから取得したApp Push IDとp12証明書にアクセスできるようにします。
- Android Firebase設定、特にFirebase Sender IDにアクセスできるようにします。
- 現在のプロバイダーから購読者データをエクスポートする方法を用意します。
モバイルアプリ移行の仕組み
アプリプッシュのデバイスートークンは、現在のプロバイダーからではなく、Apple Push Notification service（APNs）およびFirebase Cloud Messaging（FCM）から提供されます。PushEngageを現在使用しているのと同じAPNsおよびFCM認証情報で設定すれば、これらのトークンは有効なままで、移行はバックエンドで処理されます。
通知の許可も引き継がれます。ユーザーが既にアプリで通知の許可を付与している場合、移行後に再度付与する必要はありません。
移行手順
ステップ1：現在のプロバイダーから購読者をエクスポートする
プロバイダーが提供するいずれかの方法を使用して、購読者データをエクスポートします。
- APIエクスポート（現在のプロバイダーのアプリIDとAPIキーを使用）。
- CSVエクスポート（
identifier、device_type、language、およびその他の関連フィールドを含むファイル）。
ステップ2：PushEngageでAndroid FCMを設定する
- PushEngageダッシュボードにログインします。
- 設定 » インストール » Android SDKに移動します。
- 現在使用しているのと同じFirebase Sender IDを使用して、Google Android FCM設定を構成します。
ステップ3：PushEngageでiOS APNsを設定する
- PushEngageダッシュボードで、設定 » インストール » iOS SDKに移動します。
- 現在の設定から取得した同じApp Push IDを使用して、Apple iOS APNs設定を構成します。
- Apple Developerアカウントから取得したp12証明書（現在使用しているものと同じ）をアップロードします。
アプリバージョンの切り替えに関する重要な注意点
アプリプッシュの移行は、購読者が実行しているアプリのバージョンに依存するため、リリース切り替えを慎重に計画してください。
- 古いアプリバージョン（以前のプロバイダーのSDKを使用）。移行後、古いアプリバージョンを使用している購読者は、PushEngageペイロードが古いSDKでデコードできないため、PushEngageから送信された通知を受信できません。
- PushEngage SDK を搭載した新しいアプリバージョン。移行後に以前のプロバイダーのダッシュボードから送信した場合、古いペイロードは PushEngage SDK でデコードできないため、その通知は新しいアプリバージョンには表示されません。
要するに、新しいアプリバージョンのユーザーには PushEngage から送信し、アップグレードしていないユーザーはアプリをアップグレードするにつれて移行してくることを期待してください。
よくある質問
購読者は再度通知の許可を与える必要がありますか？
いいえ。移行後にアプリで既に許可が与えられている場合、再度許可を与える必要はありません。
移行直後にすべての購読者が通知を受け取りますか？
PushEngage SDK を搭載した新しいアプリバージョンのユーザーは受け取ります。以前のプロバイダーの SDK を搭載した古いアプリバージョンのユーザーは、アプリを更新するまで PushEngage 通知を受け取りません。
同じ APNs および Firebase の認証情報を再利用する必要があるのはなぜですか？
デバイス トークンはそれらの認証情報に紐付けられているためです。同じ App Push ID、p12 証明書、および Firebase Sender ID を再利用することで、既存のトークンが有効なままになり、ユーザーに再登録を求めることなく移行が可能になります。
現在のプロバイダーからどのようなデータが必要ですか？
プロバイダーのアプリ ID と API キーを使用した API エクスポート、または少なくとも identifier、device_type、language を含む CSV、およびその他の関連フィールド。
問題が発生した場合は、ここをクリックしてお気軽にお問い合わせください。サポートチームがお手伝いします。