Meminta peringkat dan ulasan untuk aplikasi Anda

  • Artikel

Anda dapat menambahkan kode ke aplikasi Platform Windows Universal (UWP) untuk secara terprogram meminta pelanggan Anda 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.

Penting

Saat menambahkan fungsi peringkat dalam aplikasi Anda, semua ulasan harus mengirim pengguna ke mekanisme peringkat Toko, terlepas dari peringkat star yang dipilih. Jika Anda mengumpulkan umpan balik atau komentar dari pengguna, harus jelas bahwa itu tidak terkait dengan peringkat aplikasi atau ulasan di Store tetapi dikirim langsung ke pengembang aplikasi. Lihat Kode Etik Pengembang untuk informasi lebih lanjut terkait Aktivitas Penipuan atau TidakJumlah.

Menampilkan dialog peringkat dan peninjauan di aplikasi Anda

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

Penting

Permintaan untuk menampilkan dialog peringkat dan peninjauan harus dipanggil pada utas UI di aplikasi Anda.

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 dalam 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.

Bidang Deskripsi
status String yang menunjukkan apakah pelanggan berhasil mengirimkan peringkat atau tinjauan. Nilai yang didukung berhasil dan dibatalkan.
data Objek yang berisi satu nilai Boolean bernama diperbarui. Nilai ini menunjukkan apakah pelanggan memperbarui peringkat atau tinjauan yang ada. Objek data hanya disertakan dalam respons keberhasilan.
errorDetails String yang berisi detail kesalahan untuk permintaan tersebut.

Luncurkan halaman peringkat dan ulasan untuk aplikasi Anda di Bursa

Jika Anda ingin membuka halaman peringkat dan ulasan secara terprogram untuk aplikasi Anda di Store, 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.