Google Play In-App Review API を使用すると、ユーザーにアプリやゲームから離れる不便さを感じさせることなく、Play ストアの評価とレビューを送信するよう促すことができます。
一般に、アプリ内レビューフロー（図 1 を参照）は、ユーザーがアプリを使用する過程のどこでもトリガーされる可能性があります。フローの中で、ユーザーは 1 個から 5 個までの星でアプリを評価し、任意でコメントを追加できます。送信されたレビューは Play ストアに送信され、しばらくすると表示されます。
ユーザーのプライバシーを保護し、API の不適切な使用を避けるため、アプリ内レビューをリクエストするタイミングと、レビュー プロンプトのデザインに関して、アプリが遵守する必要がある厳格なガイドラインがあります。
図 1. ユーザー視点でのアプリ内レビューのフロー
デバイスの要件
アプリ内レビューは、次のデバイスでのみ機能します。
- Google Play ストアがインストールされ、Android 5.0（API レベル 21）以降が搭載されている Android デバイス（スマートフォンとタブレット）。
- Google Play ストアがインストールされている ChromeOS デバイス。
Play Core ライブラリの要件
アプリ内レビューをアプリに統合するには、バージョン 1.8.0 以降の Play Core ライブラリを使用する必要があります。
アプリ内レビューをリクエストするタイミング
ユーザーにアプリ内レビューをリクエストするタイミングを判断するには、以下のガイドラインに従ってください。
- ユーザーがアプリやゲームを十分に使用して有益なフィードバックを提供できる状態になったら、アプリ内レビューフローをトリガーします。
- ユーザーに過度にレビューを求めない。このアプローチにより、ユーザーの不満を最小限に抑え、API の使用を制限できます（割り当てに関するセクションをご覧ください）。
- アプリでは、評価ボタンやカードを表示する前や表示中に、ユーザーに質問（「このアプリは気に入りましたか？」など）や予測質問（「このアプリを 5 つ星に評価しますか？」など）を投げかけてはなりません。
設計ガイドライン
アプリ内レビューをアプリに統合する方法を決める際は、次のガイドラインに従ってください。
- サイズ、不透明度、形状などのプロパティを変更したり、既存のデザインを改ざんしたりせずに、カードをそのまま表示します。
- カードの上や周囲にオーバーレイを追加しない。
- カードとカードの背景は最上位のレイヤに配置する必要があります。カードが表示されたら、プログラムでカードを削除しないでください。カードは、ユーザーの明示的な操作または Google Play ストアの内部メカニズムに基づいて自動的に削除されます。
割り当て
優れたユーザー エクスペリエンスを提供するため、Google Play では、ある一定期間中レビュー ダイアログをユーザーに表示する回数に対して上限を設けています。この上限のため、短期間（たとえば 1 か月未満）に launchReviewFlow メソッドを複数回呼び出すと、ダイアログが表示されないことがあります。
表示回数の上限は変更される場合があります。そのため、独自のロジックを適用し、可能な限り最適なタイミングでレビューをリクエストすることが重要です。たとえば、API をトリガーするコールトゥアクション オプション（ボタンなど）は使用しないでください。ユーザーがすでに割り当てに達している場合、フローは表示されず、ユーザーにエラーが発生する可能性があります。このユースケースでは、代わりにユーザーを Google Play ストアにリダイレクトします。
アプリ内レビューをアプリに統合する
アプリ内レビューを統合する方法を開発環境ごとに示します。
利用規約とデータ セーフティ
Play アプリ内レビュー ライブラリにアクセスするか、これを使用すると、Play Core ソフトウェア開発キット利用規約に同意したことになります。ライブラリにアクセスする前に、適用されるすべての利用規約とポリシーを確認してください。
データ セーフティ
Play Core ライブラリは、Google Play ストアにおけるアプリのランタイム インターフェースです。そのため、アプリで Play Core を使用すると、Play ストア独自のプロセスが実行され、Google Play 利用規約に則ってデータが処理されます。下記の情報は、Play Core ライブラリがアプリからの特定のリクエストを処理するためにどのようにデータを処理するかを示しています。
アプリ内レビュー
| 使用量について収集されたデータ | ユーザーが入力したデータ（評価と自由形式のレビュー） |
| データ収集の目的 | 収集されたデータは、Play ストアでレビューを書き込むために使用されます。 |
| データの暗号化 | データは暗号化されています。 |
| データの共有 | 収集されたデータは、Play ストアでの公開レビューの際に使用されます。また、アプリがクローズド テスト トラックにある場合、収集されたデータはアプリ デベロッパーと非公開で共有されます。 |
| データの削除 | ユーザーは、Google Play ストア アカウントまたは Google アカウントによるレビューを削除できます。 |
Google は、デベロッパーのサポートにおいて可能な限り透明性を確保するよう努めておりますが、アプリによるユーザーデータの収集、共有、アプリのセキュリティ対策に関して、Google Play のデータ セーフティ セクションのフォームにどのように対応するかの判断については、アプリ デベロッパーがすべての責任を負うものとします。