A API Google Play In-App Review permite solicitar que os usuários enviem avaliações e resenhas da Play Store sem o precisar sair do app ou jogo.
Geralmente, o fluxo de avaliação no app (figura 1) pode ser acionado a qualquer momento durante a jornada do usuário no app. Durante o fluxo, o usuário pode classificar seu app usando o sistema de 1 a 5 estrelas e adicionar um comentário opcional. Após terminada, a avaliação é enviada para a Play Store e exibida.
Para proteger a privacidade do usuário e evitar o uso indevido da API, há diretrizes rígidas que o app precisa seguir sobre quando solicitar avaliações no app e sobre o design da solicitação de avaliação.
Figura 1. Fluxo de avaliação no app para um usuário
Requisitos do dispositivo
As avaliações no app funcionam apenas nos seguintes dispositivos:
- Dispositivos Android (smartphones e tablets) com o Android 5.0 (nível 21 da API) ou mais recente e com a Google Play Store instalada.
- Dispositivos Chrome OS com a Google Play Store instalada.
Requisitos da biblioteca Play Core
Para integrar avaliações no app, seu app precisa usar a versão 1.8.0 ou mais recente da biblioteca Play Core.
Quando solicitar uma avaliação no app
Siga estas diretrizes para decidir quando solicitar avaliações dos usuários no app:
- Acione o fluxo de avaliação no app depois que um usuário tiver tido experimentado o suficiente para fornecer um feedback útil.
- Não solicite excessivamente que o usuário realize uma avaliação. Essa abordagem ajuda a minimizar a frustração do usuário e limitar o uso da API (consulte a seção sobre cotas).
- Seu app não pode fazer perguntas ao usuário antes ou ao apresentar o botão ou card de avaliação, incluindo perguntas sobre a opinião deles (como "Você gosta do app?") ou perguntas preditivas (como "Você avaliaria esse app com 5 estrelas?").
Diretrizes de design
Siga estas diretrizes ao determinar como integrar avaliações no app:
- Mostre o card no estado em que ele se encontra, sem adulterar ou modificar o design existente de qualquer maneira, incluindo tamanho, opacidade, forma ou outras propriedades.
- Não adicione nenhuma sobreposição na parte superior do card ou ao redor dele.
- O card e o plano de fundo dele precisam estar na camada superior. Depois que o card for exibido, não o remova de forma programática. O card será removido automaticamente com base na ação explícita do usuário ou em um mecanismo interno da Play Store.
Cotas
Para oferecer uma ótima experiência do usuário, o Google Play aplica uma cota de tempo limitado
na frequência com que um usuário pode ver a caixa de diálogo de avaliação. Devido a essa cota, chamar o método launchReviewFlow
mais de uma vez durante um curto período de tempo (por exemplo, menos de um mês) nem sempre pode exibir uma caixa de diálogo.
Como a cota está sujeita a alterações, é importante aplicar sua própria lógica e segmentar o melhor momento possível para solicitar uma avaliação. Por exemplo, não disponibilize uma opção de call-to-action (como um botão) para acionar a API, porque talvez o usuário já tenha atingido a cota, e o fluxo não será exibido, o que representa uma experiência corrompida para o usuário. Nesse caso de uso, redirecione o usuário para a Play Store.
Integrar avaliações no app
Aprenda a integrar avaliações no app, dependendo do ambiente para desenvolvedores: