Udostępnij za pośrednictwem

Żądanie ocen i przeglądów aplikacji

Możesz dodać kod do aplikacji platformy uniwersalnej systemu Windows (UWP), aby programowo monitować klientów o ocenę lub przejrzenie aplikacji. Można to zrobić na kilka sposobów:

  • Możesz wyświetlić ocenę i przejrzeć okno dialogowe bezpośrednio w kontekście aplikacji.
  • Możesz programowo otworzyć stronę klasyfikacji i przeglądu aplikacji w Sklepie Microsoft Store.

Gdy będziesz gotowy do analizowania danych dotyczących klasyfikacji i recenzji, możesz wyświetlić dane w Centrum partnerskim lub użyć interfejsu API analiz Microsoft Store, aby programowo pobrać te dane.

Ważne

Podczas dodawania funkcji klasyfikacji w aplikacji wszystkie recenzje muszą wysłać użytkownika do mechanizmów klasyfikacji sklepu, niezależnie od wybranej klasyfikacji gwiazdek. W przypadku zbierania opinii lub komentarzy od użytkowników należy pamiętać, że nie jest to związane z oceną aplikacji lub recenzjami w Sklepie, ale jest wysyłane bezpośrednio do dewelopera aplikacji. Zobacz Kodeks postępowania dla deweloperów, aby uzyskać więcej informacji dotyczących fałszywych lub nieuczciwych działań.

Wyświetlanie okna dialogowego oceny i przeglądu w aplikacji

Aby programowo wyświetlić okno dialogowe z aplikacji, które prosi klienta o ocenę aplikacji i przesłanie przeglądu, wywołaj metodę RequestRateAndReviewAppAsync w przestrzeni nazw Windows.Services.Store.

Ważne

Żądanie wyświetlenia okna dialogowego oceny i przeglądu musi być wywoływane w wątku interfejsu użytkownika w aplikacji.

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

Metoda RequestRateAndReviewAppAsync została wprowadzona w systemie Windows 10 w wersji 1809 i może być używana tylko w projektach przeznaczonych dla systemu Windows 10 October 2018 Update (10.0; Kompilacja 17763) lub nowsze wydanie w programie Visual Studio.

Dane odpowiedzi dotyczące oceny i żądania przeglądu

Po przesłaniu żądania w celu wyświetlenia okna dialogowego oceny i przeglądu, właściwość ExtendedJsonData klasy StoreRateAndReviewResult zawiera ciąg w formacie JSON wskazujący, czy żądanie zakończyło się pomyślnie.

W poniższym przykładzie pokazano wartość zwracaną dla tego żądania po pomyślnym przesłaniu przez klienta oceny lub recenzji.

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

W poniższym przykładzie pokazano wartość zwracaną dla tego żądania, gdy użytkownik zdecyduje się nie wysyłać oceny ani recenzji.

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

W poniższej tabeli opisano pola w ciągu danych w formacie JSON.

(No changes needed) Opis
stan Ciąg wskazujący, czy klient pomyślnie przesłał ocenę, czy recenzję. Obsługiwane wartości to powodzenie i przerwane.
dane Obiekt zawierający pojedynczą wartość logiczną o nazwie zaktualizowaną. Ta wartość wskazuje, czy klient zaktualizował istniejącą ocenę, czy recenzję. Obiekt danych jest uwzględniany tylko w odpowiedziach na powodzenie.
szczegółyBłędu Ciąg zawierający szczegóły błędu dotyczące zapytania.

Uruchom stronę oceny i recenzji swojej aplikacji w Sklepie

Jeśli chcesz programowo otworzyć stronę klasyfikacji i przejrzenia aplikacji w Sklepie, możesz użyć metody LaunchUriAsync ze schematem identyfikatora URI ms-windows-store://review, jak pokazano w tym przykładzie kodu.

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

Aby uzyskać więcej informacji, zobacz Uruchamianie aplikacji ze sklepu Microsoft Store.

Przeanalizuj swoje dane dotyczące ocen i recenzji

Aby przeanalizować dane dotyczące ocen i przeglądów od klientów, masz kilka opcji:

  • Aby zobaczyć oceny i opinie swoich klientów, możesz użyć raportu opinii w Centrum partnerskim. Możesz również pobrać ten raport, aby wyświetlić go w trybie offline.
  • Można wykorzystać metody Pobierz oceny aplikacji i Pobierz recenzje aplikacji w interfejsie API analizy sklepu, aby programowo pobierać oceny i recenzje od klientów w formacie JSON.