Meminta peringkat dan ulasan untuk aplikasi Anda

Anda dapat menambahkan kode ke aplikasi Platform Windows Universal (UWP) untuk secara terprogram meminta pelanggan Anda untuk menilai atau meninjau aplikasi Anda. Ada beberapa cara untuk melakukan ini:

• Anda dapat menampilkan dialog peringkat dan peninjauan langsung dalam konteks aplikasi Anda.
• Anda dapat secara terprogram membuka halaman peringkat dan ulasan untuk aplikasi Anda di Microsoft Store.

Saat Anda siap menganalisis data peringkat dan ulasan, Anda dapat melihat data di Pusat Mitra atau menggunakan API analitik Microsoft Store untuk mengambil data ini secara terprogram.

Menampilkan dialog peringkat dan tinjauan di aplikasi Anda

Untuk menampilkan dialog secara terprogram dari aplikasi Anda yang meminta pelanggan anda untuk menilai aplikasi anda dan mengirimkan tinjauan, panggil metode RequestRateAndReviewAppAsync di namespace Windows.Services.Store .

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;
    }
}

Metode RequestRateAndReviewAppAsync diperkenalkan di Windows 10, versi 1809, dan hanya dapat digunakan dalam proyek yang menargetkan Pembaruan Windows 10 Oktober 2018 (10.0; Build 17763) atau rilis yang lebih baru di Visual Studio.

Data respons untuk permintaan peringkat dan peninjauan

Setelah Anda mengirimkan permintaan untuk menampilkan dialog peringkat dan peninjauan, properti ExtendedJsonData dari kelas StoreRateAndReviewResult berisi string berformat JSON yang menunjukkan apakah permintaan berhasil.

Contoh berikut menunjukkan nilai pengembalian untuk permintaan ini setelah pelanggan berhasil mengirimkan peringkat atau tinjauan.

{ 
  "status": "success", 
  "data": {
    "updated": false
  },
  "errorDetails": "Success"
}

Contoh berikut menunjukkan nilai pengembalian untuk permintaan ini setelah pelanggan memilih untuk tidak mengirimkan peringkat atau tinjauan.

{ 
  "status": "aborted", 
  "errorDetails": "Navigation was unsuccessful"
}

Tabel berikut ini menjelaskan bidang dalam string data berformat JSON.

Luncurkan halaman peringkat dan tinjauan untuk aplikasi Anda di Bursa

Jika Anda ingin membuka halaman peringkat dan ulasan secara terprogram untuk aplikasi Anda di Toko, Anda dapat menggunakan metode LaunchUriAsync dengan ms-windows-store://review skema URI seperti yang ditunjukkan dalam contoh kode ini.

bool result = await Windows.System.Launcher.LaunchUriAsync(new Uri("ms-windows-store://review/?ProductId=9WZDNCRFHVJL"));

Untuk informasi selengkapnya, lihat Meluncurkan aplikasi Microsoft Store.

Menganalisis data peringkat dan ulasan Anda

Untuk menganalisis data peringkat dan ulasan dari pelanggan Anda, Anda memiliki beberapa opsi:

• Anda dapat menggunakan laporan Ulasan di Pusat Mitra untuk melihat peringkat dan ulasan dari pelanggan Anda. Anda juga dapat mengunduh laporan ini untuk melihatnya secara offline.
• Anda dapat menggunakan metode Dapatkan peringkat aplikasi dan Dapatkan ulasan aplikasi di Store analytics API untuk mengambil peringkat dan ulasan secara terprogram dari pelanggan Anda dalam format JSON.

Topik terkait

• Mengirim permintaan ke Bursa
• Meluncurkan aplikasi Microsoft Store
• Laporan ulasan