O Google tem o compromisso de promover a igualdade racial para as comunidades negras. Saiba como.

Integrar avaliações no app (Kotlin ou Java)

Este guia descreve como integrar avaliações no app usando Kotlin ou Java. Há guias de integração separados se você estiver usando código nativo ou o Unity.

Configurar seu ambiente de desenvolvimento

A API In-App Review faz parte do SDK Play Core. Para configurar seu ambiente para desenvolvedores, siga as instruções de configuração na seção Java ou Kotlin do guia da biblioteca Play Core.

Criar o ReviewManager

O ReviewManager é a interface que permite ao app iniciar um fluxo de avaliação no app. Acesse-o criando uma instância usando o ReviewManagerFactory.

Kotlin

val manager = ReviewManagerFactory.create(context)

Java

ReviewManager manager = ReviewManagerFactory.create(context)

Solicitar um objeto ReviewInfo

Siga as orientações sobre quando solicitar avaliações no app para determinar bons pontos no fluxo do usuário para solicitar uma avaliação (por exemplo, quando o usuário conclui um nível em um jogo). Quando o app atingir um desses pontos, use a instância ReviewManager para criar uma tarefa de solicitação. Se for bem-sucedida, a API retornará o objeto ReviewInfo necessário para iniciar o fluxo de avaliação no app.

Kotlin

val request = manager.requestReviewFlow()
request.addOnCompleteListener { request ->
    if (request.isSuccessful) {
        // We got the ReviewInfo object
        val reviewInfo = request.result
    } else {
        // There was some problem, continue regardless of the result.
    }
}

Java

ReviewManager manager = ReviewManagerFactory.create(this);
Task<ReviewInfo> request = manager.requestReviewFlow();
request.addOnCompleteListener(task -> {
    if (task.isSuccessful()) {
        // We can get the ReviewInfo object
        ReviewInfo reviewInfo = task.getResult();
    } else {
        // There was some problem, continue regardless of the result.
    }
});

Iniciar o fluxo de avaliação no app

Use a instância ReviewInfo para iniciar o fluxo de avaliação no app. Aguarde o usuário concluir o fluxo de avaliação antes de continuar com o fluxo normal de usuários (como avançar para o próximo nível).

Kotlin

val flow = manager.launchReviewFlow(activity, reviewInfo)
flow.addOnCompleteListener { _ ->
    // The flow has finished. The API does not indicate whether the user
    // reviewed or not, or even whether the review dialog was shown. Thus, no
    // matter the result, we continue our app flow.
}

Java

Task<Void> flow = manager.launchReviewFlow(activity, reviewInfo);
flow.addOnCompleteListener(task -> {
    // The flow has finished. The API does not indicate whether the user
    // reviewed or not, or even whether the review dialog was shown. Thus, no
    // matter the result, we continue our app flow.
});

Próximas etapas

Teste o fluxo de avaliação no app para verificar se a integração está funcionando corretamente.