OneSignalへの移行

• 開発者 - OneSignal SDKを実装する方
• マーケター - キャンペーンと分析を管理する方

​

前提条件

• OneSignalでアカウントを設定します
• チームメンバーを招待します

​

移行手順

​

1. 現在のメッセージング設定を監査する

• サポートしているプラットフォーム：iOS、Android、Web、メール、SMSなど
• プッシュとアプリ内メッセージイベントを処理するコード：
  • フォアグラウンド表示とクリック処理
  • プッシュ、メールなどのディープリンク使用
  • プッシュトークンとペイロード処理
• メールアドレス、電話番号、プッシュトークンなどの収集方法
• メールドメインとDNS所有権
• SMS送信者とオプトインメカニズム

• 送信するメッセージのタイプ：（トランザクション、マーケティングなど）
  • それらのメッセージのテンプレート
• ユーザーのセグメント化とターゲティング方法
• 追跡している分析またはコンバージョンメトリクス

​

2. OneSignalのコアコンセプト

• ユーザー - 外部IDで識別されます。ユーザーはプロパティ（タグ、セッションデータなど）とサブスクリプション（プッシュ、メール、SMS）で構成されます。
• サブスクリプション - ユーザーがメッセージを受信できる方法を指します。4種類のサブスクリプションがあります：
  • モバイル：プッシュ通知、アプリ内メッセージ、Live Activitiesを受信できます。
  • Webプッシュ：Webプッシュ通知を受信できます。
  • メール：メール通知を受信できます。
  • SMS：SMS通知を受信できます。
• セグメント - 共通のプロパティを持つユーザーのグループ。
• タグ - カスタムユーザープロパティ。
• カスタムイベント - ユーザーが実行するアクション。

​

3. OneSignal SDKを追加する（開発者向け）

​

外部IDでユーザーを識別する

• モバイルSDK
• Web SDK

​

新しいメールアドレスと電話番号を収集する

• メールサブスクリプション：モバイルSDKおよびWeb SDKのaddEmailメソッドを使用します
• SMSサブスクリプション：モバイルSDKおよびWeb SDKのaddSmsメソッドを使用します

​

4. レガシー実装を削除する

​

プッシュトークンの競合と形式

• フロントエンドモバイルSDKを使用してデバイスのプッシュトークン識別子を取得します
• ユーザーを表示 APIを使用してデバイスの識別子を取得します

• iOS Push APNSトークン形式：64文字、16進数文字のみ（0-9、a-f）。deviceToken.map {String(format: "%02x", $0)}.joined()
• Android Push FCMトークン形式：通常163文字、英数字、ハイフン、コロン、アンダースコアを含む場合があります。

​

プッシュペイロード処理

​

段階的移行（モバイルアプリのみ）

• 複数のSDKにプッシュトークンを生成させないでください。 OneSignalに処理させ、必要に応じて古いシステムとトークンを共有します。
  • フロントエンドSDKまたはユーザーを表示APIを使用します
• ペイロードフィルターを更新して、レガシーSDKがOneSignalプッシュを処理しないようにします。
  • OneSignalはrawPayloadで"custom"キーを使用します（ドキュメント）。
  • NotificationCompat（Android）でこのキーを確認します。
• どのプロバイダーがどのタイプの通知を処理するかを決定します。
• 明確なカットオフ日を設定し、レガシーシステムの段階的廃止計画を構築します。
  • 送信する通知のタイプごとに通知テンプレートを作成します。
  • 古いプロバイダーは古いバージョンのアプリのユーザーにメッセージを送信し、OneSignalは新しいバージョンのアプリのユーザーにメッセージを送信するように設定します。
  • 特定のユーザーグループをターゲットにするセグメントを作成します。

​

5. Webプッシュ移行

• ブラウザーのセキュリティ制限により、Webプッシュサブスクリプションをインポートすることはできません。OneSignalは、ユーザーが戻ってきたときに登録します。
• OneSignalが引き継ぐ前に、古いプッシュサービスワーカーの登録を解除する必要があります。

1. レガシーSDKを削除します：WebサイトとService Workerファイルのコード。
2. Service Workerが確実に登録解除されるように、このコードを追加します。
3. sw.jsをサードパーティのService Workerファイルの名前に置き換えます。

if ('serviceWorker' in navigator) {
  navigator.serviceWorker.getRegistrations().then(function(registrations) {
    for (let registration of registrations) {
      if (registration.active.scriptURL.includes("sw.js")) {
        registration.unregister();
      }
    }
  });
}

​

OneSignalアプリ間の移行

• Webプッシュサブスクリプションは、アプリ間で直接転送できません。各サブスクリプションは、サイトのドメイン（オリジン）とOneSignalアプリIDの両方に関連付けられています。
• 移行するには、サイトのOneSignal初期化コードを更新して、アプリBのappIdを使用します：

OneSignal.init({
  appId: "YOUR_APP_B_ID",
});

• ユーザーがサイトを再訪問すると、ブラウザーの既存のプッシュ権限により、OneSignalはアプリBに自動的に登録します。
• 新しい権限プロンプトは表示されませんが、アプリBでサブスクリプションが作成されるには、ユーザーが少なくとも1回サイトを訪問する必要があります。
• サブスクライバーは、非アクティブになるまでアプリAに引き続き表示されます。

​

6. メールとSMSのセットアップ

​

メールウォームアップは必要ですか？

​

専用IPアドレスを取得できますか？

​

7. 既存ユーザーをインポートする（オプション）

​

プラットフォームの考慮事項

• メールアドレスは、アクティブで有効なユーザーのものである必要があります。これまでにメールをクリックまたは開封したことのないメールアドレスはインポートしないでください。
• 電話番号は特定の形式である必要があり、ユーザーはSMSの受信に同意している必要があります。
• iOSサブスクリプションは、インポート後すぐにプッシュ通知の受信を開始できます。通知クリックトラッキングや確認済み配信などの機能には、デバイスでSDKがアクティブである必要があります。
• Android/Huawei/Amazonサブスクリプションは、自動更新または手動更新を通じて、デバイスでSDKがアクティブである必要があります。
• Webサブスクリプションはインポートできません。Webプッシュ移行の上記に従うと、ユーザーがサイトに戻ったときに、SDKを介してWebプッシュサブスクリプションが作成され、プッシュトークンが取得されます。

​

インポート手順

1. 理解のためにユーザーおよびサブスクリプションドキュメントを確認します。
2. 古いシステムからテストユーザーデータをエクスポートします。
3. OneSignalのユーザーを作成 API用にデータをフォーマットします。
4. テストユーザーをインポートし、テストに成功したら、プレリリースチェックリストで繰り返すプロセスを保持します。

• token - プッシュトークン、メールアドレス、または電話番号
• type - サブスクリプションのタイプ：iOSPush、AndroidPush、WebPush、Email、SMS
• external_id - ユーザーの一意の識別子。トラッキングと分析に使用することをお勧めします。

  {
    "identity": {
      "external_id": "user_12345"
    },
    "subscriptions": [
      {
        "type": "iOSPush",
        "token": "7abcd49d0affb7426a8f1202420e8f4e2fc4df58e49501adc383f3bd66df8636"
      },
      {
        "type": "AndroidPush",
        "token": "dQGm89TZQXiTvLsRIj_GBo:APA91bpgqFgqkP2qYvV1uW2kdK5Z3TjgCXB_1jkL6VJrgH3hoYn16MvFY19tzDE4OuSgKjYC7itbFpSJYHBfKLWt-xZYBpgCVhYn9K5neV_9-Zj7s9mOSjRUJ2IwEwVSYhR-j5ICF9WB"
      },
      {
        "type": "Email",
        "email": "test@example.com"
      },
      {
        "type": "SMS",
        "phone_number": "+1234567890"
      }
    ]
  }

​

7. 移行をテストする

1. OneSignal SDKでデバッグログを有効にします。
2. すべてのプラットフォーム（Android、iOS、Webなど）の実機でテストします。
3. フォアグラウンドとバックグラウンドの両方の通知処理を確認します。

• OneSignal SDKを追加する前に、OneSignalからインポートされたユーザーにテスト通知を送信します。
  • iOSではプッシュを受信しますが、確認済み配信やクリック分析は取得できません。
  • 別のプッシュSDKがあり、まだペイロード処理要件を実装していない場合、Androidでプッシュを受信する可能性があります。通知にはデータが欠けている可能性が高く、クリックしても期待どおりに機能しません。
• OneSignal SDKを追加した後、OneSignalからインポートされたユーザーにテスト通知を送信します。
  • AndroidとiOSの両方で、確認済み配信とクリック分析と共にプッシュを受信するはずです。
• さまざまな状態のアプリで通知動作をテストします。
• ディープリンクとカスタムアクションが正しく機能することを確認します。

• 現在のプロバイダーとOneSignalの両方から送信します。
• 重複通知を確認します
• 各プロバイダーの通知が正しく表示されることを確認します
• ユーザーのログイン/ログアウトシナリオをテストします

​

プレリリースチェックリスト

• アプリ更新を促すメッセージング計画を構築します
• 古いシステムからのプッシュとアプリ内メッセージを使用して、ユーザーに更新を優しく促すことを検討してください。

• プッシュとアプリ内メッセージの分析が期待どおりに機能していることを確認します。
  • クリックイベントと確認済み配信がAndroidとiOSで追跡されます。
• 両方のプロバイダーから送信されたメッセージについて、クリックイベントとフォアグラウンド受信イベントが正しく処理されることを確認します。
• ユーザーをインポートする場合は、過去270日間にアプリでアクティブだったAndroidおよびiOSユーザーをエクスポートして、期限切れトークンのインポートを防ぎます。詳細については、FCM期限切れトークンFAQを参照してください。

​

アプリ/サイトをリリースする

• ほとんどのユーザーは、アプリが最新バージョンに自動的に更新されます。
• ユーザーが更新されたアプリを開いたとき、権限が既に付与されている場合（必須の権限プロンプトまたはアプリの通知設定を通じて）、プッシュ通知のサブスクライブを求められることはありません。

• ユーザーがアプリの更新バージョンを開くと、OneSignalで自動的に作成されます。以前にサブスクライブしていた場合、プッシュを求められることはありません。
• メッセージを送信する前に、更新されたアプリを開くのを待つ必要があります。
• OneSignalに十分なユーザーが表示されるまで数日間、以前のプッシュプロバイダーから通知とアプリ内メッセージを送信し続けます。アプリを最新バージョンに更新するよう求める追加のアラートを送信します。

​

結果を監視する

• デプロイ後のエラー率とクラッシュを監視します。
• 予期しないトークンの無効化に注意します。
• SDK統合の分析を確認します。

• アプリのリリース日をマークします。
• 開発者と次のことについてコミュニケーションします：
  • どの移行パスが取られたか（クリーン移行または段階的移行）。
  • ユーザーはインポートされましたか？
• クリーン移行を実行している場合：
  • 以前のプラットフォームで、引き続きアクティブなユーザーのセグメントまたはコホートを作成します。セッション時間、受信したメッセージ、クリックイベントを確認します。
  • アプリを更新していないユーザーのみが、引き続きアクティブでこのグループに含まれているはずです。
  • これらのユーザーに以前のプロバイダーからプッシュとアプリ内メッセージを送信し続け、優しく更新を促します。
  • OneSignalに完全に移行する準備ができるまで、以前のプロバイダーからの送信を停止します。
• 段階的移行を実行している場合：
  • 以前のプラットフォームで、OneSignal以前の古いアプリバージョンを持つユーザーのセグメントまたはコホートを作成します。
  • これらの古いアプリのユーザーに以前のプロバイダーからプッシュとアプリ内メッセージを送信し続け、優しく更新を促します。
  • OneSignalに完全に移行する準備ができるまで、以前のプロバイダーからの送信を停止します。
  • 次のアプリリリースで以前のプッシュプロバイダーのコードを削除します。