API Google Play In-App Review

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.

Fluxo de trabalho de avaliação no app para um usuário

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: