内部エラー
内部システムでは、すべてのプラットフォームに送信されるプッシュ通知に影響するいくつかのエラーが生成されます。| エラー/代替エラー | 説明 | 対処法 |
|---|---|---|
| MOE_PFR Personalization Failed | このエラーは、プッシュのパーソナライゼーションが失敗し、フォールバックメッセージが定義されていない場合に発生します。システムはユーザーに通知を送信せず、Personalization Failed エラーとなります。 | すべてのユーザーが必要なパーソナライズ属性をすべて持っていることを確認してください。 |
| Removed due to Minimum Delay | このエラーは、キャンペーンの最小遅延により、ユーザーが通知の受信対象から除外された場合に発生します。 | Settings > Deliverycontrols > Minimum delay で設定されている最小遅延を確認してください。 |
| Not sent due to campaign level min delay | このエラーは、キャンペーンの最小遅延により、ユーザーが通知の受信対象から除外された場合に発生します。 | キャンペーンで設定されている最小遅延を確認してください。Schedule and goals > Delivery controls > Minimum delay between two notifications に移動して、キャンペーンで設定されている最小遅延を確認します。 |
| Rejected because of DND | このエラーは、キャンペーンで設定された DND によりキャンペーンが拒否された場合に発生します。 | Settings > Delivery control > Do not disturb に移動して、Do Not Disturb モードがオンになっているかを確認してください。 |
| Timer Duration Exceeded Limit | このエラーは、Timer テンプレートの期間が 12 時間を超えた場合に発生します。 | Timer テンプレートの期間が 12 時間未満であることを確認してください。 |
| Removal of duplicate tokens | このエラーは、システムがユーザーのデバイスに関連付けられた重複するプッシュ通知トークンを特定して削除したことを示します。 | 対応は不要です。これは想定どおりの動作です。 |
| Timer Duration Less Than 15 Minutes | このエラーは、Timer テンプレートの期間が 15 分未満の場合に発生します。 | Timer テンプレートの期間が 15 分を超えていることを確認してください。 |
| Users removed due to Global Control Group | Global Control Group によりユーザーが除外されました。 | Global Control Group のトグルがオフになっていることを確認してください。 |
| Users removed due to Campaign Control Group | Campaign Control Group によりユーザーが除外されました。 | Campaign Control Group のトグルがオフになっていることを確認してください。 |
| Users removed due to campaign frequency limit | キャンペーンの Limit Message 設定で許可されている最大数のメッセージをすでに受信していたため、ユーザーが除外されました。 | 除外が意図しないものである場合は、キャンペーンの配信設定で Limit Message を見直すか無効にしてください。詳細については、定期キャンペーンおよびトリガーキャンペーンのメッセージ制限を参照してください。 |
プラットフォームエラー
MoEngage は、Android と iOS の通知をそれぞれ FCM と APNS サービスを使用して送信します。これらのサービスの使用中にエラーが発生した場合、通知が送信されないことがあります。参考として、一般的なエラーの一覧を以下に示します。- MoEngage は、FCM と APNS が返すレスポンスからプラットフォームエラーを取得します。
- FCM と APNS は不正確な原因を返すことがあるため、報告されたエラーが実際の問題を特定しているとは限りません。
- プラットフォームエラーは、確定的な診断としてではなく、統合の健全性を示す指標として使用してください。
- アプリビルドで異なる FCM 認証情報を使用しており認証情報の不一致が生じている場合、同じエラーがあるユーザーには影響し、別のユーザーには影響しないことがあります。
Android - Firebase Cloud Messaging(FCM) and Huawei Messaging Service (HMS) Errors
| エラー/代替エラー | 説明 | 対処法 |
|---|---|---|
| Invalid Registration 別名:
| このエラーは、登録時に無効な FCM プッシュトークンが送信された場合に発生します。 | コードの実装を見直し、MoEPushKitHelper.getInstance().passPushToken() および MoEFirebase.getInstance().passPushToken() メソッドに渡されるトークンが正確であることを確認してください。 |
| Not Registered 別名:
| このエラーは、次の理由により登録トークンが無効になった場合に発生します。
| 古いトークンの有効期限が切れた場合、新しいトークンは Firebase または HMS サービスクラス（またはこのクラスを継承したクラス）の onNewToken() に渡されます。受け取ったトークンを、それぞれの MoEngage モジュール API（HMS トークンの場合は MoEPushKitHelper.getInstance().passPushToken()、Firebase トークンの場合は MoEFirebase.getInstance().passPushToken()）に渡してください。
|
| FCM Message rate exceeded 別名:
| この Firebase Cloud Messaging (FCM) エラーは、送信メッセージの量がアカウントのサービス容量を超えた場合に発生します。受信メッセージレートを管理するため、この容量を超えるリクエストは拒否されます。この状況は通常、多数のキャンペーンが同時に高速で開始された場合に発生します。 | FCM エラーを減らすには、次の対応を行います。
|
| FirebaseCloudMessaging 別名:
| このエラーは、使用している FCM プロジェクトに Cloud Messaging へのアクセス権がない場合に発生します。 | Firebase プロジェクト/Google Cloud プロジェクトで Firebase Messaging / Google Cloud Messaging が有効になっているかを確認してください。FCM コンソールで、Firebase Cloud Services とは別に Firebase Cloud Messaging を有効にする必要がある場合があります。 |
| Mismatch Sender Id 別名:
| このエラーは、登録された Sender ID が MoEngage に提供された Sender ID と一致しない場合に発生します。 | アプリのコードに追加された google-services.json ファイルと、MoEngage ダッシュボードに追加された service-account.json ファイルが、異なる 2 つの Firebase プロジェクトのものになっています。ファイル（アプリに追加された google-services.json と MoEngage コンソールに追加された service-account.json）が同じ Firebase プロジェクトのものであることを確認してください。 |
| Message Too Big 別名:
| このエラーは、メッセージペイロードのサイズ制限を超えた場合に発生します。 | Firebase Messaging には、メッセージサイズとキーと値のペア/ペイロードサイズに制限があります。ペイロードサイズを減らしてください（文字数制限 - 1000 文字、ペイロードサイズ制限 - 4096 バイト/4KB）。API からペイロードを送信する場合は、適切なキーがペイロードに追加されていることを確認してください。 |
| Invalid FCM Auth Key 別名:
| このエラーは、FCM 用にアップロードされた認証キーが無効または期限切れの場合に発生します。 | FCM 認証のドキュメントに記載されている手順に従って、新しいキーを生成してください。 |
| Device Message Rate Exceeded | このエラーは、アカウント/プロジェクトへのメッセージレートが、デフォルトのレート制限である 1 分あたり 600,000 リクエストを超えた場合に発生します。 | キャンペーンの送信速度を下げるか、FCM でクォータを引き上げる必要があります。詳細については、FCM 認証を参照してください。 |
| Push Amplification™ Plus targets were invalid | 通知の送信時に、Push Amplification™ Plus のトークンが無効であるか、見つかりません。 | PushAmp+ の統合が適切に完了しているかを確認してください。PassPushToken に渡されたトークンが FCM ではなく PushAmp+ サービス (HMS) のものであるかを確認してください。 |
| Sender temporarily unavailable 別名:
| このエラーは、送信者側のサーバーに問題があることを示します。サーバーがリクエストの処理中に内部エラーを起こしたか、一時的にオフラインになっている可能性があります。 | これは FCM からの一時的なエラーで、断続的に発生することがあります。お客様側での対応は不要です。 |
| Response Decode Error | このエラーは、認識できない JSON 形式のために FCM のレスポンスを解析できなかった場合に発生します。 | これは FCM からの一時的なエラーで、断続的に発生することがあります。お客様側での対応は不要です。 |
| HMS Message too big 別名:
| このエラーは、HMS のメッセージペイロードのサイズ制限を超えた場合に発生します。 | Firebase Messaging には、メッセージサイズとキーと値のペア/ペイロードサイズに制限があります。ペイロードサイズを減らしてください（最大メッセージサイズは 4 KB です）。API からペイロードを送信する場合は、適切なキーがペイロードに追加されていることを確認してください。詳細については、FAQs-Push Kit を参照してください。 |
| FCM Insufficient Permission 別名:
| このエラーは、生成された FCM 秘密鍵に Cloud Messaging の作成権限がない場合に発生します。 | Firebase プロジェクト/Google Cloud プロジェクトで Firebase Messaging / Google Cloud Messaging が有効になっていること、および更新された JSON キーが MoEngage ダッシュボードに追加されていることを確認してください。詳細については、FCM 認証を参照してください。 |
iOS - Apple Push Notification Service Errors
| エラー/代替エラー | 説明 | 対処法 |
|---|---|---|
| Invalid payload size PayloadTooLarge | このエラーは、メッセージに含まれるペイロードデータの合計サイズが APNS の制限である 4096 バイトを超えた場合に発生します。 | プッシュ通知の最大ペイロードサイズが 4096 バイト以内であることを確認してください。渡しているキーと値のペアの数を減らす必要がある場合があります。詳細については、APNS ドキュメントの Generating a remote notification を参照してください。 |
| Invalid token size | このエラーは、MoEngage に提供されたトークンが正しくない場合に発生します。 | 正しいプッシュトークンを MoEngage に渡す必要があります。詳細については、プッシュ通知の実装を参照してください。 |
| APNS Provider Certificate Expired | このエラーは、MoEngage ダッシュボードにアップロードされた APNS プロバイダー証明書の有効期限が切れた場合に発生します。 | 新しい PEM ファイルを作成して MoEngage にアップロードするか、APNS 認証キー方式に切り替えてください。Apple は、より優れた制御と管理の簡素化のために、AuthKey ベースの方式 (.p8) への移行を推奨しています。詳細については、APNS Certificate/PEM file を参照してください。 |
| APNs Client Connection Failed | このエラーは次の理由で発生します。
|
|
| Device Token Not For Topic 別名:
| このエラーは、MoEngage ダッシュボード上で誤った BundleId に関連付けられた PEM ファイルまたは AuthKey がアップロードされた場合に発生します。 | MoEngage ダッシュボードで、正しい Bundle Identifier が PEM ファイルまたは AuthKey (.p8 ファイル) に関連付けられていることを確認してください。 |
| BadDeviceToken | このエラーは、MoEngage に提供された APNS Bundle ID が、トークンの登録に使用された Bundle ID と一致しない場合に発生します。また、プッシュ通知が誤った環境（開発環境と本番環境）に送信された場合にも発生します。 | 次の設定を確認してください。
|
| Invalid Provider Token 別名:
| このエラーは次の場合に発生します。
| 次の点を確認してください。
|
| TopicDisallowed | このエラーは、トピックへのプッシュが許可されていない場合、または証明書/AuthKey の App Identifier Prefix とアプリの Bundle ID が一致しない場合に発生します。 | AuthKey (.p8 ファイル) とともに MoEngage ダッシュボードのプッシュ設定に追加された BundleIdentifier が、プッシュ通知をテストするアプリの BundleIdentifier と一致していることを確認してください。 |
| Authorization Error 別名:
| このエラーは、APNS の認証キーが無効または期限切れの場合に発生します。 | APNS でこのエラーが発生した場合は、新しい証明書をアップロードする必要があります。 |
| Unregistered | このエラーは、次のようないくつかのシナリオで既存の登録トークンが無効になった場合に発生します。
|
|
| TooManyProviderTokenUpdates | このエラーは、プロバイダートークンの更新頻度が高すぎる場合に発生します。 | 1 人のユーザーに大量のプッシュ通知を送信しないようにしてください。 |
| Sender temporarily unavailable 別名:
| このエラーは、送信者側のサーバーがリクエストの処理中に内部エラーを起こした場合、または一時的に利用できない場合に発生します。 | Apple Push Notification service (APNs) からの “InternalServerError” は、コードではなく Apple 側の問題を示しているため、Apple に報告してください。 |
| ServiceUnavailable | このエラーは、サービスが利用できない場合に発生します。 | これは Apple からの一時的なエラーであり、お客様側での対応は不要です。 |
その他のエラーについては、MoEngage カスタマーサポートにお問い合わせください。