Solicitar classificações e revisões para seu aplicativo

Você pode adicionar código ao aplicativo UWP (Plataforma Universal do Windows) para solicitar programaticamente que seus clientes classifiquem ou examinem seu aplicativo. Há várias maneiras de fazer isso:

• Você pode mostrar uma caixa de diálogo de classificação e revisão diretamente no contexto do seu aplicativo.
• Você pode abrir programaticamente a página de classificação e revisão do aplicativo na Microsoft Store.

Quando estiver pronto para analisar suas classificações e examinar dados, você poderá exibir os dados no Partner Center ou usar a API de análise da Microsoft Store para recuperar esses dados programaticamente.

Mostrar uma caixa de diálogo de classificação e revisão em seu aplicativo

Para mostrar programaticamente uma caixa de diálogo do seu aplicativo que pede ao cliente para classificar seu aplicativo e enviar uma revisão, chame o método RequestRateAndReviewAppAsync no namespace Windows.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;
    }
}

O método RequestRateAndReviewAppAsync foi introduzido no Windows 10, versão 1809, e só pode ser usado em projetos destinados Atualização de outubro de 2018 do Windows 10 (10.0; Build 17763) ou uma versão posterior no Visual Studio.

Dados de resposta para a solicitação de classificação e revisão

Depois de enviar a solicitação para exibir a caixa de diálogo de classificação e revisão, a propriedade ExtendedJsonData da classe StoreRateAndReviewResult contém uma cadeia de caracteres formatada em JSON que indica se a solicitação foi bem-sucedida.

O exemplo a seguir demonstra o valor retornado dessa solicitação depois que o cliente envia uma classificação ou revisão com êxito.

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

O exemplo a seguir demonstra o valor retornado dessa solicitação depois que o cliente opta por não enviar uma classificação ou revisão.

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

A tabela a seguir descreve os campos na cadeia de caracteres de dados formatada em JSON.

Inicie a página de classificação e revisão do seu aplicativo na Loja

Se você quiser abrir programaticamente a página de classificação e revisão do aplicativo na Loja, poderá usar o método LaunchUriAsync com o esquema de URI ms-windows-store://review, conforme demonstrado neste exemplo de código.

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

Para obter mais informações, consulte Iniciar o aplicativo da Microsoft Store.

Analisar os dados de suas classificações e avaliações

Para analisar os dados de classificações e revisões de seus clientes, você tem várias opções:

• Você pode usar o relatório Resenhas no Partner Center para ver as classificações e avaliações de seus clientes. Você também pode baixar este relatório para exibi-lo offline.
• Você pode usar os métodos Obter classificações de aplicativo e Obter avaliações de aplicativo da API de análise da Store para recuperar de forma programática as classificações e avaliações de seus clientes no formato JSON.

Tópicos relacionados

• Enviar solicitações para a Loja
• iniciar o aplicativo da Microsoft Store
• Relatório de revisões