Freigeben über

Anfordern von Bewertungen und Rezensionen für Ihre App

  • Artikel

Sie können Ihrer Universelle Windows-Plattform -App (UWP) 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 Überprüfungsdialogfeld direkt im Kontext Ihrer App anzeigen.
  • 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.

Wichtig

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. Weitere Informationen zu betrügerischen oder unehrlichen Aktivitäten finden Sie im Entwicklerkodex.

Anzeigen eines Bewertungs- und Überprüfungsdialogfelds in Ihrer App

Rufen Sie die RequestRateAndReviewAppAsync-Methode im Windows.Services.Store-Namespace auf, um programmgesteuert ein Dialogfeld ihrer App anzuzeigen, das Ihren Kunden auffordert, Ihre App zu bewerten und eine Rezension zu übermitteln.

Wichtig

Die Anforderung zum Anzeigen des Bewertungs- und Überprüfungsdialogfelds muss im UI-Thread in Ihrer App aufgerufen werden.

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 Windows 10 Oktober 2018 Update (10.0) abzielen . Build 17763) oder eine höhere Version in Visual Studio.

Antwortdaten für die Bewertungs- und Überprüfungsanfrage

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 Überprüfung übermittelt hat.

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

Im folgenden Beispiel wird der Rückgabewert für diese Anforderung veranschaulicht, nachdem der Kunde eine Bewertung oder Rezension nicht übermitteln möchte.

{ 
  "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 erfolgreich und abgebrochen.
data Ein Objekt, das einen einzelnen booleschen Wert mit dem Namen "updated" enthält. Dieser Wert gibt an, ob der Kunde eine vorhandene Bewertung oder Rezension aktualisiert hat. Das Datenobjekt ist nur in Erfolgsantworten enthalten.
errorDetails Eine Zeichenfolge, die die Fehlerdetails für die Anforderung enthält.

Starten der Bewertungs- und Überprüfungsseite 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 Ihrer Bewertungen und Rezensionsdaten

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 anzuzeigen. 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 von Ihren Kunden im JSON-Format programmgesteuert abzurufen.