Este guia descreve como integrar avaliações no app usando o Unity. Há guias de integração separados se você estiver usando o Kotlin ou Java ou código nativo.
Visão geral do SDK do Unity
A API Google Play In-App Review faz parte da família do SDK
Play Core. A API para
Unity oferece uma classe ReviewManager
para solicitar e iniciar o fluxo usando os métodos RequestReviewFlow
e
LaunchReviewFlow
. Depois que uma solicitação for feita, seu app poderá verificar o status dela
usando ReviewErrorCode
.
Configurar seu ambiente de desenvolvimento
Para configurar seu ambiente para desenvolvedores, siga as instruções de configuração na seção do Unity do guia da biblioteca Play Core.
Criar o ReviewManager
Crie uma instância de ReviewManager
que processe a comunicação entre seu app e a API.
// Create instance of ReviewManager
private ReviewManager _reviewManager;
// ...
_reviewManager = new ReviewManager();
Solicitar um objeto ReviewInfo
Siga as orientações sobre quando solicitar avaliações no
app para determinar bons pontos
no fluxo de usuários para solicitar uma avaliação (por exemplo, depois que
um usuário dispensar a tela de resumo ao final de um nível em um jogo). Quando o
app estiver perto de um desses pontos, use a instância ReviewManager
para criar uma operação assíncrona, como mostrado no exemplo a seguir:
var requestFlowOperation = _reviewManager.RequestReviewFlow();
yield return requestFlowOperation;
if (requestFlowOperation.Error != ReviewErrorCode.NoError)
{
// Log error. For example, using requestFlowOperation.Error.ToString().
yield break;
}
_playReviewInfo = requestFlowOperation.GetResult();
Se a chamada for bem-sucedida, a API retornará o objeto PlayReviewInfo
necessário para iniciar o fluxo de avaliação no app. No exemplo, a
chamada é feita dentro de uma corrotina
para executar a operação assíncrona. Isso não bloqueia a linha de execução principal. Como
a chamada é feita de maneira assíncrona, ela pode demorar alguns segundos. Assim,
o app precisa fazer a chamada antes de chegar ao ponto no fluxo
de usuários em que você quer exibir a chamada de avaliação no app.
Iniciar o fluxo de avaliação no app
Depois que o app receber a instância PlayReviewInfo
,
ele poderá iniciar o fluxo de avaliação. Observe que o objeto PlayReviewInfo
é válido apenas por um período limitado, de modo que seu aplicativo não pode aguardar
muito tempo antes de iniciar um fluxo.
var launchFlowOperation = _reviewManager.LaunchReviewFlow(_playReviewInfo);
yield return launchFlowOperation;
_playReviewInfo = null; // Reset the object
if (launchFlowOperation.Error != ReviewErrorCode.NoError)
{
// Log error. For example, using requestFlowOperation.Error.ToString().
yield break;
}
// 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.