Google Play アプリ内レビューとアプリ内アップデート 2026
Play Coreの2つの機能が、アプリがストア掲載情報上で自力で改善し続けるかどうかを静かに左右します。アプリ内レビューAPIを使えば、ユーザーはアプリを離れることなく評価とレビューができます。アプリ内アップデートを使えば、アクティブなユーザーにPlayストアへ移動させずに新しいビルドへの移行を促せます。うまく使えば評価が上がり、古いバージョンに取り残されるユーザーの割合が減ります。注意せずに使えば、ユーザーを苛立たせ、目に見えないクォータを消費し、シグナルではなくサポートチケットを抱え込むことになります。
このチュートリアルは、実際の実装順に両方のAPIを解説します。要件、リクエストのタイミング、設計上の制約、コードパス、そして実機でのテストです。以下の内容はすべてGoogleが文書化したPlay Coreの動作に従っており、2つのルールが全体を枠づけます。レビューダイアログを強制的に表示させることはできず、更新がこちらの予定どおりにインストールされることを約束することもできません。どちらもPlayが決めます。私たちの役割は、適切なタイミングで適切なフロータイプを使って要求し、答えが「いいえ」でもアプリが動作し続けるようにすることです。
1. 各APIの役割 — そして意図的に行わないこと
アプリ内レビューのフローでは、アプリからPlayストアの評価カードを表示できます。ユーザーは1〜5つ星と任意のコメントを残すことができ、レビューはPlayストアに送信され、やがて表示されます。得られないのは、自分のリクエストに関するフィードバックです。APIはユーザーがレビューしたかどうか、そもそもダイアログが表示されたかどうかさえ示しません。分岐すべき値も、読み取る星の数も、カードをオンデマンドで再表示する方法もありません。
アプリ内アップデートは、アクティブなユーザーに新しいバージョンのインストールを促します。これはリモートコントロールのスイッチではありません。インストールが無音で行われることも、再起動が強制されることもなく、アップデートはより高いバージョンコードへの前進のみです。あなたが制御できるのはフローの種類(柔軟または即時)と、リリースに付与する更新の優先度を通じた推奨の強さだけです。それ以外はすべてPlayの判断です。
UIを設計する前に知っておきたい点がもう1つあります。アプリがクローズドテストトラックにある場合、レビューフローで収集された評価とコメントは公開されず、デベロッパーであるあなたに非公開で共有されます。リハーサルには便利ですが、公開評価とは異なるデータです。
2. コードを書く前に確認すべき要件
- アプリ内レビューは、Google PlayストアがインストールされたAndroid 5.0(APIレベル21)以上を実行するAndroid端末(スマートフォン、タブレット、Google TV搭載テレビ)と、PlayストアがインストールされたChromeOS端末で動作します。
- レビュー連携にはPlay Coreライブラリのバージョン1.8.0以上が必要です。現在の統合ガイドでは
com.google.android.play:review:2.0.2、Kotlin向けにはcom.google.android.play:review-ktx:2.0.2を使用しています。 - In-app updates are supported on Android 5.0 (API level 21) or higher, and only on Android phones, Android tablets and ChromeOS. They are not compatible with apps that use APK expansion files (
.obb). - 更新の統合には
com.google.android.play:app-update:2.1.0を使用し、Kotlinの場合はcom.google.android.play:app-update-ktx:2.1.0も併用します。
そこから2つの帰結が生まれます。アプリが拡張ファイルを配信している場合、アプリ内アップデートは使えないため、ストア掲載情報を通じてアップデートを促すことになります。また、Playストアのない端末では、どちらのAPIも何もせず、静かに失敗します。したがって、機能が利用可能だと決めつけず、自身のリクエスト呼び出しの結果に基づいてUIを制御してください。
3. アプリ内レビュー:依頼が許されるタイミング
Googleのガイダンスは簡潔かつ厳格です。ユーザーが有用なフィードバックを与えられるほどアプリやゲームを体験した後にフローを起動してください。レベルをクリアした、エクスポートを完了した、初回セッションを成功させた、といったタイミングです。過度に促さないでください。不要なプロンプトはすべて、後述する割り当てを消費し、喜ばせるはずだった相手を苛立たせます。
固く禁じられているのは事前の質問です。アプリは評価ボタンやカードを表示する前や表示中に、ユーザーへ何も尋ねてはいけません。「このアプリは好きですか?」のような意見を問う質問や、「このアプリを5つ星で評価しますか?」のような誘導的な質問も含まれます。不満を持つユーザーを先にふるい落とすことは、まさにこのルールが防ごうとしている行為です。独自の導線を設けたい場合は、常に機能するシンプルなリンクとしてPlayストアの掲載情報へ誘導し、APIは自分で制御できるタイミングに取っておきましょう。
4. アプリ内レビュー:曲げられない設計ルール
このカードはPlayに属するものであり、あなたのデザインシステムのものではありません。サイズ、不透明度、形状その他のプロパティを変更せず、そのまま表示してください。カードの上や周囲にオーバーレイを重ねず、カードとその背景は最前面のレイヤーに保ちます。一度表示されたカードは、プログラムから決して削除しないでください。カードが閉じられるのは、ユーザーの明示的な操作かPlayストアの内部メカニズムによる場合だけです。
コード側では、アプリが通常の処理を続ける前に、たとえば次のレベルへ進む前に、審査フローが完了するのを待ちます。フロー中にエラーが発生しても、ユーザーに伝えず、フローも変更しません。完了コールバックが発火したら通常どおり続行します。
5. クォータ:launchReviewFlowがボタンではない理由
Playは、ユーザーにレビューダイアログを表示できる頻度に期間ベースの上限を設けています。そのため、短期間にlaunchReviewFlowを複数回呼び出すと(Google自身の例では1か月未満)、何も表示されないことがあります。正確な値は実装の詳細であり、予告なく変更されることがあります。
クォータは変動するため、成功を前提としたUIは作れません。APIを呼び出す専用のコールトゥアクションボタンは、Googleが明確に警告しているアンチパターンです。ユーザーがすでにクォータに達していればフローは表示されず、ボタンが壊れているように見えます。意図的な「評価する」クリックには、代わりにPlayストアへリダイレクトしてください。APIは、リクエストが想定され、ダイアログが出なくても違和感のない場面に限定して使いましょう。
6. アプリ内レビュー:コードパスを順を追って
3回の通話を、この順番で。
- マネージャーを作成する。
ReviewManagerFactory.create(context)で、フローを開始するReviewManagerが取得できます。 - 情報を事前にキャッシュしましょう。
requestReviewFlow()を呼び出します。成功すると起動に必要なReviewInfoオブジェクトを受け取ります。失敗した場合はReviewExceptionからReviewErrorCodeを読み取ってログに記録します。ReviewInfoオブジェクトは限られた期間しか有効ではないため、事前にリクエストしつつ、フローが起動することを確信できた時点でのみリクエストしてください。 - 起動。
launchReviewFlow(activity, reviewInfo)でカードが表示されます。完了コールバックはフローが終了したことだけを通知します。結果にかかわらずアプリのフローを続行してください。
7. アプリ内アップデート:柔軟か即時か
2つのフローがあり、それぞれ異なるプロダクト上の課題に応えるものです。柔軟なアップデートはバックグラウンドでダウンロードされ、状態を適切に監視するため、アップデートの到着を待つ間もユーザーは作業を続けられます。新バージョンが数分待てる機能追加やパフォーマンス改善をもたらす場合に適した選択です。即時アップデートは全画面のフローで、続行する前にユーザーがアップデートして再起動する必要があり、中核機能に不可欠なアップデート向けです。ユーザーが承諾すると、インストールとアプリの再起動の両方をPlayが処理します。
実際の問題を解決する最小のフローを選びましょう。エスカレーションは正当です — 最初は穏やかに通知し、最終的にはアップデートを必須にしてもよいでしょう — ただしそれは実装時に一度決める判断ではなく、優先度と陳腐化のロジックに組み込むべきものです。
8. 経過日数と更新の優先度:「どれだけ深刻か」をどう表現するか
アプリがアップデートをどれだけ遅れているかを示す2つのシグナル。
clientVersionStalenessDays()は、アップデートがPlay Storeで利用可能になってからの日数を返します。これは自然なエスカレーションの時計です。柔軟なプロンプトの前に数日待ち、即時プロンプトを要求する前にさらに数日待ちます。updatePriority()は、リリースに付けた優先度を返します。値は0(デフォルト)から5(最高)までの整数です。これはGoogle Play Developer APIのEdits.tracks.releases配下にあるinAppUpdatePriorityフィールドで設定します。リリース内で新たに追加されたすべてのバージョンはそのリリースの優先度を共有し、優先度は新しいリリースの段階的リリース中にしか設定できません。後から変更はできないため、公開前に値を決めておく必要があります。
見落とされがちな微妙な点が一つあります。アプリが参照する優先度は、インストール済みバージョンと最新の利用可能バージョンの間にあるすべてのバージョンコードを考慮します。それぞれがどのトラックでリリースされたかは関係ありません。バージョン1を優先度なしで製品版に、バージョン2を優先度5で内部テストトラックに、バージョン3を優先度なしで製品版にリリースした場合、製品版ユーザーが1から3へ更新しても優先度5が適用されます。間にバージョン2があるからです。
制限にも注意してください。inAppUpdatePriorityは内部アプリ共有へのビルドのアップロードではサポートされないため、優先度に依存する動作をその方法でリハーサルすることはできません。
9. アップデートフローの開始と結果の読み取り
まず利用可能か確認します。AppUpdateManagerFactory.create(context)でAppUpdateManagerを生成し、appUpdateInfoを読み取り、updateAvailability()がUPDATE_AVAILABLEを返すことを確認し、使用予定のフロータイプがisUpdateTypeAllowed()で許可されていることを確認します。そのうえで初めて、組み込みのStartIntentSenderForResultコントラクトに登録したアクティビティ結果ランチャーを使ってstartUpdateFlowForResult()を呼び出します。
各AppUpdateInfoインスタンスは、更新を1回しか開始できません。更新が失敗して再試行したい場合は、新しいAppUpdateInfoを取得し、可用性と権限を再度確認してください。コールバックはRESULT_OK(承認)、RESULT_CANCELED(拒否)、またはRESULT_IN_APP_UPDATE_FAILED(同意や更新を別の要因が妨げた)を返します。即時更新では、制御がアプリに戻る前に更新が通常完了しているため、RESULT_OKを目にしないこともあります。
AppUpdateOptionsにはAllowAssetPackDeletionフラグもあり、デフォルトはfalseで、デバイスのストレージが逼迫した際に更新でアセットパックを削除できるようにします。意図的に設定してください。まずフラグをfalseのまま更新が成功するか確認し、それから初めて有効化しましょう。このフラグはまさにアセットを削除するために存在するからです。
10. 柔軟なアップデート:監視、ダウンロード、再起動
フローを開始する前にInstallStateUpdatedListenerを登録し、更新が不要になったら登録を解除します。状態がDOWNLOADINGの間は、bytesDownloaded()とtotalBytesToDownload()を読み取って実際の進捗を表示できます。状態がDOWNLOADEDに達しても、Playはアプリを自動で再起動しません。これがフレキシブルフローの狙いです。通知やスナックバーを表示し、ユーザーに確認してもらい、確認後にcompleteUpdate()を呼び出してください。
その呼び出しをどこで行うかで体験が変わる。フォアグラウンドではプラットフォームが全画面UIを表示し、アプリをバックグラウンドで再起動する。バックグラウンドでは更新がサイレントにインストールされる。いずれにせよ、アプリへのすべての入り口——通常はonResume()——で、更新がまだDOWNLOADED状態のまま残っていないかを確認し、残っていれば再度促すこと。そうしなければ、ダウンロード済みのバイトがインストールされないままユーザーのストレージを占有し続ける。
11. 即時更新:停止したフローを再開する
ユーザーが即時更新を承諾すると、Playはその間ずっとあなたのUIの上に進捗を表示し、ユーザーがアプリを閉じたり終了したりしてもダウンロードとインストールはバックグラウンドで継続します。これは更新には便利ですが、コードにとっては厄介で、アプリがフォアグラウンドに戻ったときフローが正式に完了していない状態になり得ます。
onResume()で処理します。updateAvailability()がDEVELOPER_TRIGGERED_UPDATE_IN_PROGRESSを返したら、startUpdateFlowForResult()を再度呼び出して再開します。ユーザーが拒否またはキャンセルした場合、PlayのUIは閉じるので、アプリ側で判断する必要があります。更新なしで動作できるなら、そのまま続行させ、後で再度促します。本当に動作できないなら、フローを再開する前に平易な言葉でそう伝え、再開がクラッシュループとして体験されるのではなく、理解されるようにしましょう。
12. 両方のAPIを実機でテストする
「壊れている」統合のほとんどはテスト時の人為的な要因です。アプリ内アップデートの場合、内部アプリ共有が標準的な方法です。テスト端末に、内部アプリ共有URLからインストールしたアプリ内アップデート対応のビルドがあることを確認し、より高いバージョンコードのバージョンをアップロードし、端末で新しいバージョンの共有リンクを開き、表示されるPlayページからはインストールせずに、ランチャーからアプリを起動します。これでアプリにアップデートが提示されるはずです。
それでも解決しない場合は、よくある4つの原因を確認してください。アカウントがアプリを所有していること、つまりそのアカウントがPlayからあなたのアプリを少なくとも一度ダウンロードしている必要があります。テストビルドがPlay版とアプリケーションIDおよび署名キーを共有していること。インストール済みのバージョンコードがアップデートより低いこと。そしてinAppUpdatePriorityは内部アプリ共有ではサポートされないため、優先度に基づくフローはそこでは異なる挙動になります。
レビューに関して実務上の違いは、テスターに何が見えるかです。クローズドテストトラックでは、集めた評価とコメントは公開されず開発者に非公開で届きます。連携やタイミングの検証には向いていますが、実際の評価の変動を代弁するものではありません。
13. 両方が公開された後に注視すべきこと
レビュー依頼は評価件数を徐々に動かすべきで、リリースと重なる急増は決してあってはなりません。急増は品質の変化ではなくタイミングの効果であり、原因はたいていセッションのかなり早い段階に置かれた依頼です。アップデートでは、最新のバージョンコードを使っているアクティブユーザーの割合を週次で追跡してください。柔軟なアップデートは評価平均に触れることなくこの数値を伸ばし、古いビルドから届くバグ報告の数を減らすはずです。
プロンプトがアンインストールや、怒った星1レビューと相関しているなら、答えはプロンプトの頻度を増やしたり、インストール直後の早い段階に出すことではありません。トリガーをユーザージャーニーのより深い位置へ移し、アプリの価値がすでに示された段階で表示しましょう。
デベロッパーアカウントを大規模に運用中ですか? 運用面は当社が対応します。
メッセージを受け付けました。24時間以内に返信します。
← 編集に戻る