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