Richiedi valutazioni e recensioni per la tua app

Puoi aggiungere codice alla tua app UWP (Universal Windows Platform) per chiedere ai tuoi clienti di valutare o recensire la tua app a livello di codice. Esistono diversi modi per farlo:

• You can show a rating and review dialog directly in the context of your app.
• Puoi aprire a livello di codice la pagina di valutazione e revisione della tua app in Microsoft Store.

Quando sei pronto per analizzare le tue valutazioni e rivedere i dati, puoi visualizzare i dati nel Centro per i partner o utilizzare l'API di analisi di Microsoft Store per recuperare questi dati a livello di codice.

Mostra una finestra di dialogo di valutazione e revisione nella tua app

Per mostrare a livello di codice una finestra di dialogo dalla tua app che chiede al cliente di valutare la tua app e inviare una recensione, chiama RequestRateAndReviewAppAsync metodo nello spazio dei nomiWindows.Services.Store.

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

Il medoto RequestRateAndReviewAppAsync è stato introdotto in Windows 10, verrsione 1809, e può essere utilizzato solo nei progetti destinati a Windows 10 aggiornamento ottorbe 2018 (10.0; Build 17763) o una versione successiva in Visual Studio.

Dati di risposta per la richiesta di valutazione e revisione

Dopo aver inviato la richiesta per visualizzare la finestra di dialogo di valutazione e revisione, la proprietà d ExtendedJsonData della classe StoreRateAndReviewResult contiene una stringa in formato JSON che indica se la richiesta ha avuto esito positivo.

L'esempio seguente mostra il valore restituito per questa richiesta dopo che il cliente ha inviato correttamente una valutazione o una recensione.

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

L'esempio seguente mostra il valore restituito per questa richiesta dopo che il cliente ha scelto di non inviare una valutazione o una recensione.

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

La tabella seguente descrive i campi nella stringa di dati in formato JSON.

Avvia la pagina di valutazione e recensione della tua app nello Store

Se desideri aprire a livello di codice la pagina di valutazione e revisione della tua app nello Store, puoi utilizzare il metodo LaunchUriAsyn con lo ms-windows-store://review schema URI come dimostrato in questo esempio di codice.

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

Per ulteriori informazioni, vedere Avvia l'app Microsoft Store.

Analizza le tue valutazioni e rivedi i dati

Per analizzare le valutazioni e i dati delle recensioni dei tuoi clienti, hai diverse opzioni:

• Puoi usare il rapporto sulleRecensioni nel Centro per i partner per visualizzare le valutazioni e le recensioni dei tuoi clienti. Puoi anche scaricare questo rapporto per visualizzarlo offline.
• Puoi utilizzare i metodi Ottieni valutazioni app e Ottieni recensioni app nell'API di analisi del negozio per recuperare in modo programmatico le valutazioni e le recensioni dei tuoi clienti in formato JSON.

Argomenti correlati

• Inviare richieste allo Store
• Avviare l'app Microsoft Store
• Rapporto sulle recensioni