A API Google Play In-App Review permite solicitar que os usuários enviem avaliações e resenhas da Play Store sem precisar sair do app ou do 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, existem diretrizes rígidas que o app precisa seguir sobre quando solicitar avaliações no app e o design do comando de avaliação.
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 ChromeOS 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 no app dos usuários:
- Acione o fluxo de avaliação no app depois que um usuário tiver tido experiência suficiente no app ou jogo 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).
- O app não pode fazer perguntas ao usuário antes ou durante a apresentação do botão ou card de classificação, incluindo perguntas sobre a opinião dele (como "Você gosta do app?") ou perguntas preditivas (como "Você daria 5 estrelas a este app?").
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, incluindo tamanho, opacidade, forma ou outras propriedades.
- Não adicione nenhuma sobreposição na parte superior do card ou ao redor dele.
- O cartão e o plano de fundo dele precisam estar na camada mais alta. Depois que o card for exibido, não o remova de forma programática. O card é 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 vai mostrar essa 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:
Termos de Serviço e segurança dos dados
Ao acessar ou usar a Biblioteca de avaliações no app do Google Play, você concorda com os Termos de Serviço do kit de desenvolvimento de software da Play Core. Leia e entenda todos os termos e políticas aplicáveis antes de acessar a biblioteca.
Segurança dos dados
As bibliotecas Play Core são a interface de execução do app com a Google Play Store. Quando você usa a Play Core no seu app, a Play Store executa processos próprios, que incluem o processamento de dados regido pelos Termos de Serviço do Google Play. As informações a seguir descrevem como as bibliotecas da Play Core lidam com dados para processar solicitações específicas do app.
Avaliações no app
Dados de uso coletados | Dados inseridos pelo usuário (classificação e avaliação de texto sem formatação) |
Propósito da coleta de dados | Os dados coletados são usados para fazer avaliações na Play Store. |
Criptografia de dados | Os dados são criptografados. |
Compartilhamento de dados | Os dados coletados são usados em uma avaliação pública na Play Store ou, se o app está em uma faixa de teste fechado, os dados coletados são compartilhados de modo privado com o desenvolvedor do app. |
Exclusão de dados | Os usuários podem excluir avaliações na conta do Google Play Store ou na Conta do Google. |
Nosso objetivo é oferecer o máximo de transparência possível, mas você é o único responsável por decidir como responder ao formulário da seção "Segurança dos dados" do Google Play com relação à coleta, ao compartilhamento e às práticas de segurança dos dados do usuário do seu app.