API Google Play In-App Reviews

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, 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 usado 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, 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 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 do Google Play são a interface do ambiente de execução do seu app na Google Play Store. Assim, quando você usa a Play Core no seu app, a Play Store executa processos próprios, que incluem o processamento de dados regidos pelos Termos de Serviço do Google Play. As informações abaixo descrevem como as bibliotecas da Play Core lidam com os 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 estiver 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 a coleta, compartilhamento e práticas de segurança dos dados do usuário do seu app.