アプリの評価とレビューを求める
ユニバーサル Windows プラットフォーム (UWP) アプリでは、プログラムによってユーザーにアプリの評価やレビューを求めるコードを追加できます。 これを実現する方法にはいくつかあります。
- アプリのコンテキストで評価とレビュー ダイアログを直接表示する。
- Microsoft Store のアプリの評価とレビュー ページをプログラムで開く。
評価とレビューのデータを分析する準備が整ったら、パートナー センターでデータを参照するか、Microsoft Store 分析 API を使ってプログラムでこのデータを取得することができます。
重要
アプリ内で評価関数を追加すると、すべてのレビューによって、選択した星評価に関係なく、ユーザーを Microsoft Store の評価メカニズムに送信する必要があります。 ユーザーからフィードバックまたはコメントを収集する場合は、Microsoft Store でのアプリの評価やレビューに関連付けられることなく、アプリの開発者に直接送信されることを明確にする必要があります。 不正行為に関する詳細については、「開発者倫理規定」を参照してください。
アプリ内での評価とレビュー ダイアログの表示
アプリを評価してレビューを提出するように顧客に求めるダイアログを、アプリ内からプログラムによって表示するには、Windows.Services.Store 名前空間の RequestRateAndReviewAppAsync メソッドを呼び出します。
重要
評価とレビュー ダイアログを表示する要求は、アプリの UI スレッドで呼び出す必要があります。
using Windows.ApplicationModel.Store;
private StoreContext _storeContext;
public async Task Initialize()
{
if (App.IsMultiUserApp) // pseudo-code
{
IReadOnlyList<User> users = await User.FindAllAsync();
User firstUser = users[0];
_storeContext = StoreContext.GetForUser(firstUser);
}
else
{
_storeContext = StoreContext.GetDefault();
}
}
private async Task PromptUserToRateApp()
{
// Check if we’ve recently prompted user to review, we don’t want to bother user too often and only between version changes
if (HaveWePromptedUserInPastThreeMonths()) // pseudo-code
{
return;
}
StoreRateAndReviewResult result = await
_storeContext.RequestRateAndReviewAppAsync();
// Check status
switch (result.Status)
{
case StoreRateAndReviewStatus.Succeeded:
// Was this an updated review or a new review, if Updated is false it means it was a users first time reviewing
if (result.UpdatedExistingRatingOrReview)
{
// This was an updated review thank user
ThankUserForReview(); // pseudo-code
}
else
{
// This was a new review, thank user for reviewing and give some free in app tokens
ThankUserForReviewAndGrantTokens(); // pseudo-code
}
// Keep track that we prompted user and don’t do it again for a while
SetUserHasBeenPrompted(); // pseudo-code
break;
case StoreRateAndReviewStatus.CanceledByUser:
// Keep track that we prompted user and don’t prompt again for a while
SetUserHasBeenPrompted(); // pseudo-code
break;
case StoreRateAndReviewStatus.NetworkError:
// User is probably not connected, so we’ll try again, but keep track so we don’t try too often
SetUserHasBeenPromptedButHadNetworkError(); // pseudo-code
break;
// Something else went wrong
case StoreRateAndReviewStatus.OtherError:
default:
// Log error, passing in ExtendedJsonData however it will be empty for now
LogError(result.ExtendedError, result.ExtendedJsonData); // pseudo-code
break;
}
}
RequestRateAndReviewAppAsync メソッドは、Windows 10 Version 1809 で導入されており、Windows 10 October 2018 Update (10.0、ビルド 17763) 以降のリリースをターゲットとする Visual Studio プロジェクトでのみ使用できます。
評価とレビューの要求に対する応答データ
評価とレビュー ダイアログを表示する要求を送信すると、StoreRateAndReviewResult クラスの ExtendedJsonData プロパティに、要求が成功したかどうかを示す JSON 形式の文字列が含められます。
次の例は、ユーザーが評価またはレビューを正しく提出した後のこの要求の戻り値を示しています。
{
"status": "success",
"data": {
"updated": false
},
"errorDetails": "Success"
}
次の例は、ユーザーが評価またはレビューを提出しなかった後のこの要求の戻り値を示しています。
{
"status": "aborted",
"errorDetails": "Navigation was unsuccessful"
}
次の表では、JSON 形式のデータ文字列に含まれるフィールドについて説明します。
| フィールド | 説明 |
|---|---|
| status | ユーザーから評価またはレビューが正しく提出されたかどうかを示す文字列です。 サポートされる値は success と aborted です。 |
| data | updated という名前の単一のブール値を含むオブジェクトです。 この値は、ユーザーが既存の評価またはレビューを更新したかどうかを示します。 data オブジェクトは、成功の応答にのみ含まれます。 |
| errorDetails | 要求のエラーの詳細を含む文字列です。 |
Store でのアプリの評価とレビュー ページの起動
Store のアプリの評価とレビュー ページをプログラムによって開くには、次のコード例に示すように、ms-windows-store://review URI スキームを指定して LaunchUriAsync メソッドを使用します。
bool result = await Windows.System.Launcher.LaunchUriAsync(new Uri("ms-windows-store://review/?ProductId=9WZDNCRFHVJL"));
詳しくは、「Microsoft Store アプリの起動」をご覧ください。
評価とレビュー データの分析
ユーザーから提出された評価とレビューのデータを分析するには、いくつかの方法があります。
- パートナー センターのレビュー レポートを使って、顧客からの評価とレビューを確認できます。 このレポートは、ダウンロードしてオフラインで参照することもできます。
- Microsoft Store 分析 API のアプリの評価の取得メソッドとアプリのレビューの取得メソッドを使って、ユーザーから提出された評価とレビューをプログラムによって JSON 形式で取得できます。