API de avaliação no app do Google Play: regras e limites

A API permite que os usuários avaliem seu app sem sair dele. O Google a descreve como uma forma de "prompt users to submit Play Store ratings and reviews without the inconvenience of leaving your app or game." (pedir aos usuários que enviem classificações e avaliações da Play Store sem o incômodo de sair do seu app ou jogo.) O usuário escolhe de 1 a 5 estrelas e pode acrescentar um comentário; depois de enviada, a avaliação vai para a Play Store.

Por que o diálogo pode não aparecer

• Existe uma cota. O Google diz que ela "enforces a time-bound quota on how often a user can be shown the review dialog" (aplica uma cota com prazo sobre a frequência com que o diálogo de avaliação pode ser mostrado ao usuário). Chamar launchReviewFlow mais de uma vez em um curto período (por exemplo, menos de um mês) "might not always display a dialog" (pode nem sempre exibir um diálogo). O valor "can be changed by Google Play without any notice" (pode ser alterado pelo Google Play sem aviso).
• Você não recebe resultado. O guia Kotlin/Java diz que a API "does not indicate whether the user reviewed or not, or even whether the review dialog was shown" (não informa se o usuário avaliou ou não, nem se o diálogo foi exibido). Continue seu fluxo normal de qualquer forma e não mostre erro ao usuário se a exibição falhar.
• Requisitos. Android 5.0 (API 21) ou superior com a Play Store instalada, e Play Core 1.8.0 ou superior, segundo a página de visão geral no momento da consulta.

Regras de uso

• Acione depois que o usuário tiver usado o app o suficiente para dar um feedback útil, e não peça em excesso.
• Não faça perguntas antes nem durante a exibição do cartão, incluindo "Você gosta do app?".
• Mostre o cartão como está: sem mudar tamanho, opacidade ou formato, sem sobreposição, e não o remova programaticamente.
• Não ofereça um botão que dispare a API. Para esse caso, redirecione para a Play Store.
• Solicite o objeto ReviewInfo antecipadamente só quando tiver certeza de que vai iniciar o fluxo; ele expira.

Sobre recompensas: as páginas que li não tratam de incentivos. Avaliações recompensadas não são uma opção; veja comprar avaliações de apps para a política do Play.

Projetando em torno da cota

1. Escolha um ou dois momentos de alto valor (depois de uma tarefa concluída) e pare por aí.
2. Nunca crie lógica que dependa de o diálogo ter sido exibido.
3. Para uma entrada nas configurações, linke para a sua página no Play.
4. Colete feedback privado separadamente: pedir feedback, não avaliações.

Testes

O Google diz que você pode testar sem publicar em produção, usando uma trilha de teste interno ou o compartilhamento interno de apps. Os limites de cota não são aplicados a apps baixados da trilha de teste interno. Com o compartilhamento interno de apps, as avaliações não podem ser enviadas. As condições (conta na trilha, conta principal da Play Store, sem avaliação existente) estão na página de teste do Google. Veja também por que avaliações de testadores ficam privadas.

O Google pode mudar tudo isso. Confira as páginas acima antes de cada lançamento. Não é aconselhamento jurídico.

Comece grátis.

Relacionados: página central, por que avaliações de testadores ficam privadas, avaliações públicas de desenvolvedores, design do pedido de avaliação.