Anfordern von Bewertungen und Bewertungen 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. Hierfür gibt es mehrere Möglichkeiten:

  • 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 Bewertungen und Überprüfungsdaten zu analysieren, können Sie die Daten im Partner Center anzeigen oder die Microsoft Store-Analyse-API verwenden, um diese Daten programmgesteuert abzurufen.

Wichtig

Beim Hinzufügen einer Bewertungsfunktion innerhalb Ihrer App müssen alle Bewertungen den Benutzer unabhängig von star gewählten Bewertungsmechanismen 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 die Bewertungen im Store bezieht, sondern direkt an den App-Entwickler gesendet wird. Weitere Informationen zu betrügerischen oder unehrlichen Aktivitäten finden Sie im Code of Conduct für Entwickler.

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

Um programmgesteuert ein Dialogfeld aus Ihrer App anzuzeigen, in dem Ihr Kunde aufgefordert wird, Ihre App zu bewerten und eine Überprüfung zu übermitteln, rufen Sie die RequestRateAndReviewAppAsync-Methode im Windows.Services.Store-Namespace auf.

Wichtig

Die Anforderung, das Bewertungs- und Überprüfungsdialogfeld anzuzeigen, 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 Windows 10 Update vom Oktober 2018 (10.0; Build 17763) oder eine höhere Version in Visual Studio.

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

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 entschieden hat, keine Bewertung oder Überprüfung zu übermitteln.

{ 
  "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 Überprüfung übermittelt hat. Die unterstützten Werte sind erfolgreich und abgebrochen.
data Ein Objekt, das einen einzelnen booleschen Wert namens updated enthält. Dieser Wert gibt an, ob der Kunde eine vorhandene Bewertung oder Überprüfung aktualisiert hat. Das Datenobjekt ist nur in Erfolgsantworten enthalten.
errorDetails Eine Zeichenfolge, die die Fehlerdetails für die Anforderung enthält.

Starten Sie die 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 Überprüfungsdaten

Um die Bewertungen und Bewertungsdaten Ihrer Kunden zu analysieren, haben Sie mehrere Möglichkeiten:

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