一般的なプッシュエラーのトラブルシューティング

プッシュ通知の配信は、期限切れのトークンや過度に大きなメッセージなど、いくつかの要因により失敗する可能性があります。この文書では、最も一般的なエラーとその理由について説明します。

内部エラー

私たちの内部システムは、すべてのプラットフォームに送信されるプッシュ通知に影響を与えるいくつかのエラーを生成します。

エラー/代替エラー	Description	救済
MOE_PFR パーソナライズに失敗しました	このエラーは、プッシュパーソナライズが失敗し、フォールバックメッセージが定義されていない場合に発生します。システムはユーザーに通知を送信せず、結果としてパーソナライズ失敗エラーが発生します。	すべてのユーザーが必要なパーソナライズされた属性を持っていることを確認してください。
最小遅延のため削除されました	このエラーは、ユーザーがキャンペーンの最小遅延のために通知の受信から削除されたときに発生します。	設定の設定 > 配信コントロール > 最小遅延の下で構成された最小遅延を確認してください。
キャンペーンレベルの最小遅延のため送信されませんでした	このエラーは、ユーザーがキャンペーンの最小遅延のために通知を受け取ることから削除されると発生します。	キャンペーンで設定されている最小遅延を確認してください。キャンペーンで設定されている最小遅延を確認するには、スケジュールと目標 > 配信コントロール > 2つの通知の間の最小遅延に移動してください。
DNDのため却下されました	このエラーは、キャンペーンに設定されたDNDのためにキャンペーンが拒否されたときに発生します。	「設定」 > 「配信管理」 > 「おやすみモード」を開いて、おやすみモードがオンになっているか確認してください。
タイマーの期間が制限を超えました	このエラーは、タイマーテンプレートの期間が 12 時間を超えると発生します。	タイマーのテンプレートの所要時間が12時間未満であることを確認してください。
重複トークンの削除	このエラーは、システムがユーザーのデバイスに関連付けられた冗長なプッシュ通知トークンを特定し、削除したことを示しています。	No action required.これは期待される動作です。
タイマーの持続時間は15分未満です	このエラーは、タイマーテンプレートの期間が 15 分未満の場合に発生します。	タイマーテンプレートの期間が15分以上であることを確認してください。
Users removed due to Global Control Group	ユーザーはグローバルコントロールグループのために削除されました。	グローバルコントロールグループ Global Control Group のトグルがオフになっていることを確認してください。
Users removed due to Campaign Control Group	キャンペーントコントロールグループによりユーザーが削除されました。	「キャンペーンコントロールグループ」トグルがオフになっていることを確認してください。

プラットフォームエラー

MoEngageは、それぞれFCMおよびAPNSサービスを使用して、AndroidおよびiOS通知を送信します。これらのサービスを使用中にエラーが発生した場合、通知が送信されないことがあります。ここに一般的なエラーのリストがあります。

Android - FCM/HMS
iOS

Android - Firebase Cloud Messaging(FCM) と Huawei Messaging Service (HMS) エラー

エラー/代替エラー	Description	救済
無効な登録別名: INVALIDREGISTRATION	このエラーは、登録中に無効なFCMプッシュトークンが送信されたときに発生します。	MoEPushKitHelper.getInstance().passPushToken() および MoEFirebase.getInstance().passPushToken() メソッド内で渡されたトークンの正確性を確認するために、コード実装をレビューしてください。
NOT REGISTERED 別名: NOTREGISTERED 要求されたエンティティが見つかりませんでしたその登録トークンは有効なFCM登録トークンではありません	このエラーは、登録トークンが以下の理由により無効になると発生します：トークンの有効期限 : Googleは登録トークンを更新することがあり、古いトークンを無効にします。アプリのアンインストール : アプリケーションはデバイスから削除されました。	古いトークンが期限切れになると、新しいトークンはFirebaseまたはHMSサービスクラス（またはこのクラスを拡張するクラス）のonNewToken()に渡されます。受信したトークンをそれぞれのMoEngageモジュールAPIに渡してください。すなわち、HMSトークンの場合はMoEPushKitHelper.getInstance().passPushToken()を、Firebaseトークンの場合はMoEFirebase.getInstance().passPushToken()を使用します。 FCM/HMSの統合を検証し、トークン登録とメッセージ受信者が正しく設定されていることを確認してください。ユーザーがアプリをアンインストールすると、NotRegisteredとしてマークされます。これは有効なシナリオと見なされます。
FCMメッセージのレートを超えました別名: Quotaexceededforquotametric FCMMESSAGERATEEXCEEDED リソースが枯渇しました (例: クォータを確認してください)	このFirebase Cloud Messaging (FCM) エラーは、送信されたメッセージの量がアカウントのサービス容量を超えたときに発生します。受信メッセージのレートを管理するため、この容量を超えるリクエストは拒否されます。この状況は、複数のキャンペーンが同時に迅速に開始されるときに一般的に発生します。	FCMエラーを減らすために、次のことができます：キャンペーンの送信速度を減らしてください。一回限りのキャンペーンと定期的なキャンペーンを間隔を空けて実施してください。 FCMからレートリミットの増加をリクエストします。詳細については、 FCM 認証を参照してください。
FirebaseCloudMessaging 別名: APIHASNOTBEENUSEDINPROJECT FirebaseCloudMessaging	エラーは、使用されているFCMプロジェクトにクラウドメッセージングのアクセスがない場合に発生します。	Firebase Messaging / Google Cloud MessagingがFirebaseプロジェクト/Google Cloudプロジェクトで有効になっているか確認してください。Firebase Cloud Services から Firebase Cloud Messaging を FCM コンソールで別途有効にする必要があるかもしれません。
ミスマッチ送信者ID 別名: MismatchSenderId SenderIdmismatch	このエラーは、登録された送信者IDがMoEngageに提供された送信者IDと一致しない場合に発生します。	google-services.jsonファイルはアプリのコードに追加され、service-account.jsonファイルはMoEngageダッシュボードに追加されており、2つの異なるFirebaseプロジェクトに属しています。ファイル（Appに追加されたgoogle-services.jsonとMoEngageコンソールに追加されたservice-account.json）が同じFirebaseプロジェクトのものであることを確認してください。
メッセージが大きすぎます別名: ANDROIDMESSAGEISTOOBIG MESSAGE TO BIG Requestcontainsaninvalidargument	このエラーは、メッセージペイロードサイズの制限を超えたときに発生します。	Firebase メッセージングには、メッセージサイズとキー-バリューペア/ペイロードサイズの制限があります。ペイロードサイズを減らしてください（文字制限 - 1000 文字、ペイロードサイズ制限 - 4096 バイト/4KB） API からペイロードを送信する際は、ペイロードに適切なキーが追加されていることを確認してください。
無効なFCM認証キー別名: GCM 認証例外 INVALID_SERVER_CREDS GCMAuthenticationException 認証バックエンドの未知のエラーあなたの認証にエラーがあります	このエラーは、アップロードされたFCM用の認証キーが無効または期限切れのときに発生します。	新しいキーを生成するには、 FCM認証のドキュメントに記載されている手順に従ってください。
デバイスメッセージレート超過	このエラーは、アカウント/プロジェクトへのメッセージのレートが、1分あたり600,000リクエストというデフォルトのレート制限を超えた場合に発生します。	キャンペーンの送信速度を減らすか、FCMからのクォータを増やす必要があります。詳細については、 FCM 認証を参照してください。
Push Amplification™ Plus のターゲットは無効です	Push Amplification™ Plusトークンは、通知を送信する際に無効または見つかりません。	PushAmp+の統合が適切に完了したか確認してください。 PassPushTokenに渡されたトークンがPushAmp+サービス（HMS）に属していることを確認し、FCMに属していないことを確認してください。
送信者は一時的に利用できません別名: 認証バックエンドが利用できません接続の確立に失敗しました: HTTPSConnectionPool GCE 内部エラー内部サーバーエラー FCMサービスからの内部サーバーエラー INTERNALERRORENCOUNTERED FCMサービスからの一時的なエラーサービスは現在利用できません予期しないHTTPレスポンス、ステータス: 502	このエラーは、送信者のサーバーに問題があることを示しています。サーバーはリクエスト処理中に内部エラーが発生したか、一時的にオフラインである可能性があります。	これはFCMからの一時的なエラーであり、断続的に表示される可能性があり、あなたの側でのアクションは必要ありません。
レスポンスデコードエラー	このエラーは、FCMの応答が認識されないJSON形式のために解析できなかった場合に発生します。	これはFCMからの一時的なエラーであり、断続的に表示される可能性があり、あなたの側でのアクションは必要ありません。
HMS メッセージが大きすぎます別名: メッセージボディサイズがデフォルト値を超えています	このエラーは、メッセージペイロードサイズの制限がHMSを超えたときに発生します。	Firebase メッセージングには、メッセージサイズとキー-バリューペア/ペイロードサイズの制限があります。ペイロードサイズを削減してください（最大メッセージサイズは4 KBです）。 APIからペイロードを送信する際は、ペイロードに適切なキーが追加されていることを確認してください。詳細については、 FAQs-Push Kit を参照してください。
FCM 権限が不十分です別名: Permission'cloudmessaging messagescreate'deniedonresource	このエラーは、生成されたFCMプライベートキーにクラウドメッセージングを作成する権限がない場合に発生します。	Firebase Messaging / Google Cloud Messaging が Firebase プロジェクト / Google Cloud プロジェクトで有効になっているか確認し、更新された JSON キーが MoEngage ダッシュボードに追加されていることを確認してください。詳細については、 FCM 認証を参照してください。

iOS - Apple Push Notification Service エラー

エラー/代替エラー	Description	救済
無効なペイロードサイズ PAYLOADTOOLARGE	このエラーは、メッセージに含まれるペイロードデータの合計サイズがAPNSの制限である4096バイトを超えたときに発生します。	プッシュ通知の最大ペイロードサイズが4096バイト以内であることを確認してください。キーと値のペアの数を減らす必要があるかもしれません。詳細については、リモート通知の生成に関するAPNSドキュメントを参照してください。
無効なトークンサイズ	このエラーは、MoEngageに提供されたトークンが正しくない場合に発生します。	正しいプッシュトークンはMoEngageに渡されるべきです。詳細については、プッシュ通知の実装を参照してください。
APNSプロバイダ証明書が期限切れです	このエラーは、MoEngageダッシュボードにアップロードされたAPNSプロバイダー証明書が期限切れになったときに発生します。	新しいPEMファイルを作成し、MoEngageにアップロードするか、APNS認証キー方式に切り替えてください。Appleは、より良い管理と簡素化された管理のために、AuthKeyベースの方法（.p8）への移行を推奨しています。詳細については、 APNS証明書/PEMファイルを参照してください。
APNs クライアント接続に失敗しました	このエラーは以下の理由で発生します： MoEngageダッシュボードのPEMファイルにリンクされたAPNS証明書は取り消されました。 Apple Developer アカウントの AuthKey は取り消されました。	新しいPEMファイルまたはAuthKeyを作成し、MoEngageダッシュボードにアップロードします。必要なAppleサービスを適切なポートで許可するためにファイアウォールルールを確認してください。
デバイストークンはトピック用ではありません別名: DeviceTokenNotForTopic	このエラーは、PEMファイルまたはAuthKeyがMoEngageダッシュボードでリンクされた間違ったBundleIdでアップロードされたときに発生します。	MoEngage ダッシュボードで正しいバンドル識別子が PEM ファイルまたは AuthKey (.p8 ファイル) にリンクされていることを確認してください。
BadDeviceToken	このエラーは、MoEngageに提供されたAPNSバンドルIDが、トークンを登録するために使用されたバンドルIDと一致しない場合に発生します。プッシュ通知が間違った環境（開発環境対本番環境）に送信されるときにも発生します。	以下の設定を確認してください：デバッグ設定 : 開発者証明書とMoEngageのテストダッシュボードを使用します。リリース構成 : プロダクションまたは AdHoc 証明書を使用し、MoEngage のライブダッシュボードを使用します。
無効なプロバイダートークン別名: APNSプロバイダ証明書が取り消されました APNSプロバイダ証明書が不明です INVALIDPROVIDERTOKEN	このエラーは以下のケースで発生します：アップロードされた AuthKey（.p8ファイル）に提供されたチームIDが間違っています。 AuthKey（.p8ファイル）がアップロードされている場所に誤ったキーIDが提供されています。 AuthKey(.p8ファイル)はApple Developer Keysで取り消され、新しいキーが生成されました。	次のことを確認してください： AuthKey（.p8ファイル）が追加されると、あなたのチームIDがMoEngageダッシュボードに追加されます。 MoEngage ダッシュボードで AuthKey (.p8 ファイル) ID を、auth key が生成された関連の Apple 開発者アカウントと確認してください。 Appleの開発者アカウントで新しいキーが生成された場合は、それをMoEngageダッシュボードにアップロードしてください。
TopicDisallowed	このエラーは、トピックへのプッシュが許可されていない場合、または証明書/AuthKeyのApp Identifier PrefixとアプリのBundle IDの間に不一致がある場合に発生します。	MoEngageダッシュボードのプッシュ設定に追加されたBundleIdentifierが、プッシュ通知がテストされるアプリのBundleIdentifierと一致していることを確認してください。
認証エラー別名: 禁止不正な認証	このエラーは、APNSの認証キーが無効または期限切れのときに発生します。	APNSでこのエラーが発生した場合は、新しい証明書をアップロードする必要があります。
未登録	このエラーは、既存の登録トークンが無効になる可能性があるいくつかのシナリオで発生します。これには以下が含まれます：登録トークンが期限切れになった場合（たとえば、Googleが登録トークンを更新することを決定した場合や、iOSデバイスのAPNSトークンが期限切れになった場合）。デバイスはアンインストールされました。	デバイスで生成された最新のプッシュトークンがMoEngageと同期されていることを確認してください。 APNSサーバーは、デバイストークンが指定されたトピック（アプリのバンドル識別子）に対して非アクティブな場合、Unregisteredエラーをスローします。
TooManyProviderTokenUpdates	このエラーは、プロバイダートークンが頻繁に更新されているときに発生します。	単一のユーザーに対して大量のプッシュ通知を送信するのは避けてください。
送信者は一時的に利用できません別名: INTERNALSERVERERROR	このエラーは、送信者サーバーがリクエストを処理しようとして内部エラーが発生した場合、または一時的に利用できない場合に発生します。	Apple Push Notificationサービス（APNs）からの「InternalServerError」は、あなたのコードではなくApple側の問題を示しており、Appleに報告する必要があります。
SERVICE UNAVAILABLE	このエラーは、サービスが利用できないときに発生します。	これはAppleからの一時的なエラーであり、あなたからのアクションは必要ありません。

info	Information さらなるエラーについては、MoEngageのカスタマーサポートにお問い合わせください。