MobilePush Detail Extract Report (MobilePush 詳細抽出レポート) を活用したプッシュ通知送信結果の切り分け方法について

プッシュ通知がデバイスに届かない事象が発生した場合、まずは「MobilePush詳細抽出レポート」を出力し、配信ステータスを確認することで問題の所在を切り分けます。このレポートには、ジョブおよびデバイスごとに MCE から Push Notification Service (PNS: APNs や FCM) へのリクエスト結果が記録されています。確認の結果、レポート内の Status カラムの値によって、以下の通り調査対象が異なります。

• Success: MCE からの送信は成功しています。アプリの実装やデバイス設定を確認します。

• Fail: PNS がリクエストを拒否しました。ServiceResponse カラムのエラー内容やアプリのプロビジョニングを確認します。

• レコードなし: MCE が送信を抑制しました。オプトアウト状況や連絡先ごとのデバイスの紐づけを確認します。

[詳細]

各ステータスにおける詳細な切り分け手順は以下の通りです。

A. 送信結果が Success の場合

Marketing Cloud から PNS へのリクエストは正常に完了しています。Marketing Cloud および PNS 側のログではこれ以上の追跡ができないため、受信側のデバイス設定およびアプリの実装に原因がある可能性が高い状態です。その場合は下記に従って確認を勧めます。

注意: アプリがアンインストールされている、または通知がオフになっている場合でも、PNS への反映タイミングにより一時的に Success が返されることがあります。

1. デバイス側の設定を確認する

   • 通信環境（機内モード、社内 Wi-Fi の制限など）を確認します。

     • 社内ネットワークや公衆 Wi-Fi の場合にネットワークの制限が行われる場合があるため、可能なら通信キャリアのネットワークにつないで確認します。

   • OS の設定（省電力モード、おやすみモード、通知の許可設定など）を確認します。

     • 上記のような通知を妨げる可能性の設定が入っている場合は解除します。

2. アプリの実装を確認する

   • 通知受信時のハンドリング処理など、アプリの実装漏れにより通知が表示されないケースがあります。

     • 特に他者の通知の SDK を導入している場合には、通知の処理が競合しあい、通知が表示されないケースがあります。

   • サンプルアプリと実装を比較し、通知のテストを行います。

     • Learning App や、非常にシンプルなアプリに SDK を組み込んで実装の違いから問題点を推測します。

実装の確認方法は多岐にわたります。後述 Additional Resources の Integrate the MobilePush Android/iOS SDK を参照して、実装の見直しや、アプリのログを確認するなどして切り分けを行います。

B. 送信結果が Fail の場合

PNS への送信試行時にエラーが発生しています。レポートの ServiceResponse カラムにプロバイダーからの応答が含まれます。詳細な意味は FCM や APNs の公式ドキュメントを参照してください。

例）FCM(Legacy) / APNs

また、弊社側でも参考として下記を案内しており、併せてご活用ください。

Reference: https://help.salesforce.com/s/articleView?id=sf.mc_mp_mobilepush_message_detail_extract_errors.htm&type=5

また、よくあるエラーは下記の通りです。

1. 無効なトークンを利用している

   • Requested entity was not found、NotRegistered (Android)、InvalidToken (iOS) などのメッセージは、送信に使用したデバイスのトークンが無効であることを示します。

   • ユーザーがアプリを削除した、または長期間利用していない、OSの設定で通知をオフにした場合などに発生します。

2. プロビジョニングの誤り（開発段階）

   • 開発中に Fail が多発する場合、PNS 用の認証キーやサービスアカウントキーの設定（プロビジョニング）、ビルドの方法に誤りがある可能性があります。

   • iOS(APNs) では [Production / Development] のラジオボタンの設定が、実際の当該アプリの配布方法に対して正しく設定されていないケースがよくあります。

      

     ※注意※ MCE では、FCM サービスアカウントキーや APNs 認証キーなどの設定を行います。MCE 側では入力された値を正として PNs へリクエストを行います。よってこれらの設定値が、実際にビルドされたアプリ側の署名や構成と正しく一致しているかどうかは、送信結果をもって判断します。そのため、サポートケースで弊社のサービスに登録された情報から、これらの整合性の確認は技術的にできかねます。
     Fail が発生する場合は、MCE の設定（環境設定や Bundle ID 等）とアプリのビルド環境に食い違いがないか、上述の [Production/Development]の区分に誤りがないか、条件を変えながら試行錯誤的に切り分けを実施していただく必要があります。

   • 以下のドキュメントに記載の前提条件や設定が途中で誤っているケースもお問い合わせでよくある事象のため、下記や各PNSの提供するTIPsなどをもとに、設定やビルドなどを再確認してください。

      

     ・Prerequisites
     https://developer.salesforce.com/docs/marketing/mobilepush/guide/prerequisites.html
     ・Troubleshoot Your Push Implementation
     https://developer.salesforce.com/docs/marketing/mobilepush/guide/troubleshoot-push-implementation.html
     ・MobilePush 導入時における、外部のプッシュ通知サービス (PNS) の設定に関するまとめ
     https://help.salesforce.com/s/articleView?id=004397548&type=1

      

C. 対象デバイスへの配信結果のレコードが存在しなかった場合

Marketing Cloud 側で送信対象から除外されていることが考えられます。主な要因は以下の通りです。

1. デバイスがオプトアウトになっている
   対象デバイスが「オプトアウト」になっている場合、MCE 側で通知送信対象から除外されます。
   Contact Builder などで対象デバイスのステータスが Opted-In であることを確認します。

2. 連絡先キーに当該のデバイスIDが紐づいていない

   Contact Builder で対象の連絡先キーを検索し、[MobilePush Data] タブなどでデバイス ID が正しく紐づいているか確認します。

   配信時点での紐づけ状況が現在と異なる可能性がある点に注意してください。

3. スクリプトエラーが発生した

   メッセージ内に AMPScript や SSJS を使用している場合、レンダリングでエラーが発生すると当該デバイスへの送信が控えられることがあります。MobilePush または Content Builder のプレビュー機能を使用し、当該のメッセージ・連絡先キーでスクリプトのエラーが発生しないか検証します。

その他の配信から除外されうる契機

• デバイスステータスが Inactive の場合:

  • オプトイン・アウトとは別に、デバイス自体が無効（Inactive）になっている場合は送信されません。通常はすべてのデバイスが Active ですが、インポートアクティビティなどで意図的に変更されている場合、一部のデバイスがInactive になっている場合があります。この場合、配信から除外されます。

  • ここでのステータスの確認方法は、[Contact Builder] -> [All Contacts] -> [MobilePush] で任意のMobilePushの連絡先キーをクリックし、[Attribute] タブから [MobilePush Data] までスクロールします。ここに当該連絡先の持つデバイス情報が表示されます。Status という項目がそれに該当します。この Status は Opt-In/Outとは関係ありません。デバイスが無効であることを示します。（上記の通り、Import などで書き換えない限りActiveになります)

• 意図しないオプトアウト:

  • ユーザーが通知を許可しているにもかかわらず、システム上でオプトアウトとなる場合があります。これは特に APNs において認証キーの不一致などプロビジョニングの誤りにより、PNS からフィードバックを受けてシステムが自動的にオプトアウト処理を行うためです。

参考) インポートでデバイスを InActive に変更するケース

種々の要件によりますが、例えば当該連絡先の最新の 1 デバイスのみにのみ Push 通知を送信したい要件の場合などに、古いデバイスを InActive にするなどがあります。ただし連絡先・デバイスの管理が煩雑になるため、事前に動作検証を重ね、慎重に検討してください。

※よく問い合わせのある質問は下記 FAQ をあわせて参照してください。

・本レポートに記録されるデータに関してよくあるFAQ

https://help.salesforce.com/s/articleView?id=005223889&type=1