Android では、ダウンストリーム メッセージに配信の優先度を割り当てるオプションとして、標準（normal）と高（high）の 2 つの優先度があります。標準の優先度と高い優先度のメッセージの配信は、次のように行われます。
優先度: 標準。データ メッセージのデフォルトの優先度です。デバイスがスリープしていない場合、優先度が標準のメッセージはすぐに配信されます。デバイスが Doze モードの場合は、バッテリーを節約するために Doze モードが終了するまで配信が延期されることがあります。新着メールの通知、UI の同期の維持の通知、バックグラウンドでのアプリデータの同期の通知など、緊急度の低いメッセージでは、標準の配信優先度を選択します。
バックグラウンドでのデータ同期をアプリにリクエストする標準優先度のメッセージを Android で受け取る場合は、 WorkManager を使用してタスクのスケジュールを設定し、ネットワークが利用可能になったときにその処理を行えます。
優先度: 高。優先度の高いメッセージは、FCM によって即時配信が試みられます。その際に FCM は、スリープ状態のデバイスを必要に応じてアクティブにしたり、限られた処理（ごく限定的なネットワーク アクセスなど）を行ったりすることが可能です。通常、優先度の高いメッセージが配信されると、ユーザーによるアプリの操作やその通知の操作が行われることになります。
Android でのメッセージの処理と優先度の低下
Android において優先度の高いメッセージは、なるべく早くユーザーに確認してもらう必要のあるコンテンツ向けであり、ユーザーに対する通知の表示が行われます。ユーザーに対する通知の表示を行うべきでないメッセージのパターンが FCM によって検出された場合、そのメッセージの優先度は通常の優先度に下げられることがあります。また、Google Play 開発者サービスの処理に委任されることもあります。
FCM がメッセージの優先度を下げるかプロキシするかを判断する際には、過去 7 日間のメッセージの動作が使用されます。この決定はアプリケーションのインスタンスごとに独立して行われます。優先度の高いメッセージに対応して、ユーザーに対する通知の表示が行われた場合、その後の優先度の高いメッセージに影響を与えることはありません。
Google Play 開発者サービスによる通知の委任
特定の条件を満たす優先度の高い通知メッセージ（データ メッセージではない）は、優先度が下げられずに Google Play 開発者サービスによってプロキシされます。つまり、アプリを起動することなく、アプリに代わって Google Play 開発者サービスによって通知が表示されます。これは、Android デバイスで全体的なユーザー エクスペリエンスを向上させるためです。
プロキシされた通知メッセージにより、受信されるメッセージに関連するアナリティクスが報告される方法が変更されることに注意してください。
- プロキシされた通知のアナリティクスをレポートするには、アプリで FCM SDK バージョン 24.0.0 以降を使用する必要があります。
- プロキシされた通知の導入前と比較して、受信するメッセージの数が遅れたり減ったりすることがあります。これは、プロキシされた通知のアナリティクスがアプリの起動時にのみレポートされるためです。通知によってアプリが起動されなかった場合は、レポートがまったく行われないこともあります。
Android Q 以降と Google Play 開発者サービス バージョン 19054000 以降を使用するアプリでは、この方法で通知メッセージをプロキシするのがデフォルトの動作です。HTTP v1 API を介して送信されたメッセージはプロキシされますが、Firebase コンソールまたは従来の API を介して送信されたメッセージはプロキシされません。この機能は現在ベータ版であり、変更される可能性があります。
デバイスのバッテリーとメモリにメリットがあるため、委任を有効にしたままにすることを強くおすすめしますが、次のいずれかの方法でこの動作をオプトアウトできます。
- アプリレベル: アプリ マニフェストに
<meta-data android:name= "delivery_metrics_exported_to_big_query_enabled" android:value="false"/>ディレクティブを追加します。 - アプリ インスタンス単位: アプリ インスタンスの場合は、特定のユースケースに応じて、アプリの UI フローで
fun setNotificationDelegationEnabled(disable: Boolean): Task<Void!>を設定します。 - メッセージ単位: 送信リクエストの
AndroidNotificationオブジェクトで、proxyキーをDENYに設定します。
Android 向けメッセージの優先度低下の測定
個々のメッセージ。配信時に、配信優先度（getPriority() によって取得）と元の優先度（getOriginalPriority() によって取得）を比較することで、個々のメッセージの優先度が下げられたかどうかを確認できます。
すべてのメッセージ。FCM Aggregate Delivery Data API を使用して、Android 向けのすべてのメッセージのうち優先度が下げられたメッセージの割合を確認できます。メッセージによっては集計データのレポートから除外されるものもありますが、全体的に見れば、メッセージの優先度低下の割合に関する包括的な情報が得られます。配信の集計データに関する記事をご覧になり、詳細情報、および API のクエリを実行するサンプルコードを確認してください。また、API Explorer でクエリを試すこともできます。
プロキシ経由の通知: プロキシ経由の通知は、現在の FCM または GA の配信指標にはカウントされないため、通知配信指標が最大 15% 減少する可能性があります。プロキシ経由のメッセージのレポートには、FCM Aggregate Delivery Data API を使用します。
ProxyNotificationInsightPercentsは、正常終了したプロキシ経由の通知の割合と、正常にプロキシできなかったメッセージの詳細を報告します。
トラブルシューティング
アプリ インスタンスで通知が有効になっているかどうか確認します。ユーザーがアプリの通知権限を無効にしている場合、通知は配信されません。その結果として、メッセージの優先度が下がります。アプリケーション インスタンスに優先度の高いメッセージを送信する前には、通知が有効になっていることを確認してください。
通知を配信する前にサーバーを呼び出さないでください。Android モバイル ユーザーの一部はレイテンシの高いネットワークを利用しているので、通知の表示前にサーバーへの接続を開かないようにしてください。許容処理時間が経過しないうちにサーバーへのコールバックを行うことは、遅延の大きいネットワーク上のユーザーにとってリスクとなる場合があります。代わりに、通知コンテンツを FCM メッセージに含めて、すぐに表示されるようにします。Android で追加のアプリ内コンテンツを同期する必要がある場合は、 WorkManager を使用してタスクのスケジュールを設定し、バックグラウンドでこの処理を行うことができます。