Freigeben über

Anfordern von Bewertungen und Rezensionen für Ihre App

Sie können Ihrer UWP-App (Universelle Windows-Plattform) Code hinzufügen, um Ihre Kunden programmgesteuert aufzufordern, Ihre App zu bewerten oder zu überprüfen. Es gibt verschiedene Möglichkeiten, wie Sie dies tun können:

  • Sie können ein Bewertungs- und Rezensionsdialog direkt im Kontext Ihrer App einblenden.
  • Sie können die Bewertungs- und Überprüfungsseite für Ihre App im Microsoft Store programmgesteuert öffnen.

Wenn Sie bereit sind, Ihre Bewertungs- und Rezensionsdaten zu analysieren, können Sie die Daten im Partner Center anzeigen oder die Microsoft Store-Analyse-API verwenden, um diese Daten programmgesteuert abzurufen.

Von Bedeutung

Wenn Sie ihrer App eine Bewertungsfunktion hinzufügen, müssen alle Rezensionen den Benutzer unabhängig von der ausgewählten Sternebewertung an die Bewertungsmechanismen des Store senden. Wenn Sie Feedback oder Kommentare von Benutzern sammeln, muss klar sein, dass es sich nicht auf die App-Bewertung oder Rezensionen im Store bezieht, sondern direkt an den App-Entwickler gesendet wird. Siehe den Verhaltenskodex für Entwickler für weitere Informationen zu betrügerischen oder unehrlichen Aktivitäten.

Zeigen Sie einen Bewertungs- und Rezensionsdialog in Ihrer App an

Rufen Sie die RequestRateAndReviewAppAsync-Methode aus dem Windows.Services.Store-Namespace auf, um von Ihrer App aus programmgestuert ein Dialogfeld anzuzeigen, in dem der Kunde aufgefordert wird, Ihre App zu bewerten und eine Rezension zu übermitteln.

Von Bedeutung

Die Anforderung, den Bewertungs- und Überprüfungsdialog anzuzeigen, muss im UI-Thread Ihrer App erfolgen.

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

Die RequestRateAndReviewAppAsync--Methode wurde in Windows 10, Version 1809, eingeführt und kann nur in Projekten verwendet werden, die auf das Windows 10 Oktober 2018 Update (10.0; Build 17763) oder eine spätere Veröffentlichung in Visual Studio abzielen.

Antwortdaten für die Bewertungs- und Rezensionsanfrage

Nachdem Sie die Anforderung zum Anzeigen des Bewertungs- und Überprüfungsdialogfelds übermittelt haben, enthält die ExtendedJsonData--Eigenschaft der StoreRateAndReviewResult-Klasse eine JSON-formatierte Zeichenfolge, die angibt, ob die Anforderung erfolgreich war.

Im folgenden Beispiel wird der Rückgabewert für diese Anforderung veranschaulicht, nachdem der Kunde erfolgreich eine Bewertung oder Rezension übermittelt hat.

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

Im folgenden Beispiel wird der Rückgabewert für diese Anfrage veranschaulicht, nachdem der Kunde sich entscheidet, keine Bewertung oder Rezension abzugeben.

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

In der folgenden Tabelle werden die Felder in der JSON-formatierten Datenzeichenfolge beschrieben.

Feld BESCHREIBUNG
Status Eine Zeichenfolge, die angibt, ob der Kunde erfolgreich eine Bewertung oder Rezension übermittelt hat. Die unterstützten Werte sind Erfolg und abgebrochen.
Daten Ein Objekt, das einen einzelnen booleschen Wert mit dem Namen enthält, deraktualisiert. Dieser Wert gibt an, ob der Kunde eine vorhandene Bewertung oder Rezension aktualisiert hat. Das Datenobjekt ist nur in Erfolgsantworten enthalten.
Fehlerdetails Eine Zeichenfolge, die die Fehlerdetails für die Anforderung enthält.

Öffnen Sie die Bewertungs- und Rezensionsseite für Ihre App im Store

Wenn Sie die Bewertungs- und Überprüfungsseite für Ihre App im Store programmgesteuert öffnen möchten, können Sie die LaunchUriAsync--Methode mit dem ms-windows-store://review URI-Schema verwenden, wie in diesem Codebeispiel veranschaulicht.

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

Weitere Informationen finden Sie unter Starten der Microsoft Store-App.

Analysieren Sie Ihre Bewertungen und Rezensionen-Daten

Um die Bewertungs- und Rezensionsdaten Ihrer Kunden zu analysieren, haben Sie mehrere Optionen:

  • Sie können den Bericht Rezensionen im Partner Center verwenden, um die Bewertungen und Rezensionen Ihrer Kunden einzusehen. Sie können diesen Bericht auch herunterladen, um ihn offline anzuzeigen.
  • Sie können die Methoden 'App-Bewertungen abrufen' und 'App-Rezensionen abrufen' in der Store-Analyse-API verwenden, um die Bewertungen und Rezensionen Ihrer Kunden automatisiert im JSON-Format abzurufen.