Webサイトで問題が発生していて、モバイルアプリがない場合は、Webプッシュトラブルシューティングガイドを参照してください。
トラブルシューティング手順
1. セットアップ手順を確認し、OneSignal SDKを更新する
モバイルSDKセットアップ手順は、一般的な問題を防ぎ、統合をテストするのに役立つように設計されています。 バグ修正、改善、および最新のオペレーティングシステムの変更のサポートを含む更新を頻繁にリリースしています。 問題が発生している場合は、まず最新のSDKバージョンを使用していることを確認し、セットアップ手順に従ってください。2. 一般的なトラブルシューティングガイド
通知が表示されない、または遅延する
プッシュ通知を送信しても、デバイスに表示されないか遅延します。
通知画像が表示されない
通知の展開ビューで通知画像が表示されません。
通知CTR
通知のクリック数が少ない、またはクリックがありません。
重複通知
通知が複数回表示されています。
アプリ内メッセージのトラブルシューティング
アプリ内メッセージの一般的な問題をトラブルシューティングします。
3. SDKのサンプルプロジェクトをテストする
エンジニアリングチームが各SDKのために作成したビルドを使用して、問題が再現可能かどうかを確認してください。- iOSサンプルプロジェクト
- Androidサンプルプロジェクト
- Cordovaバリアントサンプルプロジェクト
- React Nativeサンプルプロジェクト
- Flutterサンプルプロジェクト
- Unityサンプルプロジェクト
- .NET Mauiサンプルプロジェクト
4. エラーログを確認する
問題を診断する前に、ログデータを収集することが重要です:- デバッグログの取得に関するガイドに従ってください。
- 動作を説明できるエラー、警告、または非推奨の通知を探してください。
5. サポートに連絡する
それでも問題が解決しない場合:- 次の情報を添えて
support@onesignal.comに連絡してください:- OneSignalアプリID。
- 問題が発生しているデバイスの外部IDまたはサブスクリプションID。
- 該当する場合、通知IDまたはOneSignalダッシュボードの通知へのリンク。
- 可能であれば、問題を再現するデバイスからのデバッグログ。
一般的なエラー
APNS Delegate never fired
「Apns Delegate Never Fired」や「APNS 3000」などのAPNSエラーは、プッシュ通知に必要なAppleのAPNSサーバーにデバイスが接続できなかったことを示す、Appleが提供するタイムアウトメッセージです。これは次の場合に最も一般的です:- APNS開発環境でテストしている
- OneSignalで複数のプッシュ通知依存関係またはネイティブiOSプッシュAPIを使用している
- ユーザーが次回新しいセッションを開始したときに自動的に解決される一時的なエラー(アプリが30秒以上フォーカスから外れた後、再度開かれる)。
- 他のプッシュ通知依存関係またはネイティブiOSプッシュAPIを削除し、OneSignalのみを使用してください。エラーが解決したら、他のコードを追加し直して、ベストプラクティスについて
support@onesignal.comに連絡してください。 - 詳細については、デバイスからのデバッグログを確認してください。
- エラーが解決しない場合は、次の手順に従ってサポートに連絡してください。
FAQ
アプリでOneSignalアプリIDを変更するとどうなりますか?
アプリの初期化コードでOneSignalアプリIDを変更すると、ユーザーがアプリを最新バージョンに更新して開いたときに、新しいアプリIDの下に新しいユーザーとプッシュサブスクリプションが作成されます。 iOSバンドルIDまたはAndroidパッケージIDが同じ場合、デバイスは同じプッシュサブスクリプションステータスを継続します。ユーザーデータは新しくなります。つまり、新しいレコードにエイリアス、タグ、メールアドレス、電話番号を追加し直す必要があります。 iOSバンドルIDまたはAndroidパッケージIDが異なる場合、これは新しいアプリであり、異なるプッシュ証明書/キーが必要です。OneSignalはオンプレミスのクローズドネットワークでプッシュ通知を送信できますか?
クローズドネットワーク上のコンピュータが、サポートしたいプッシュゲートウェイサーバーにアクセスできる限り、これは機能します:- https://support.apple.com/en-us/HT203609
- https://firebase.google.com/docs/cloud-messaging/concept-options#messaging-ports-and-your-firewall