Google Play Avaliação no app e atualizações no app em 2026
Dois recursos do Play Core decidem, sem alarde, se o seu app continua melhorando sozinho na ficha do app na loja. A API de avaliação dentro do app permite que o usuário avalie e comente seu app sem sair dele. As atualizações dentro do app permitem pedir a um usuário ativo que migre para uma compilação mais recente sem passar pela Play Store. Bem usados, elevam as avaliações e reduzem a fatia de usuários presos em uma versão antiga. Usados sem cuidado, irritam as pessoas, consomem uma cota que você não enxerga e geram tickets de suporte em vez de sinal.
Este tutorial percorre as duas APIs na ordem em que você realmente as implementa: requisitos, momento da solicitação, limites de design, o caminho do código e, por fim, testes em hardware real. Tudo abaixo segue o comportamento documentado do Play Core do Google, e duas regras enquadram o conjunto — você não pode forçar o aparecimento de um diálogo de avaliação e não pode prometer que uma atualização será instalada no seu prazo. O Play decide as duas coisas. Seu papel é solicitar no momento certo, com o tipo de fluxo certo, e manter o app funcionando quando a resposta é não.
1. O que cada API faz — e o que ela deliberadamente não faz
O fluxo de avaliação dentro do app permite que seu app apresente um cartão de avaliação da Play Store. O usuário pode deixar de 1 a 5 estrelas e um comentário opcional, e a avaliação é enviada à Play Store e eventualmente exibida. O que você não recebe é feedback sobre a sua própria solicitação: a API não indica se o usuário avaliou, nem sequer se o diálogo foi exibido. Não há valor para ramificar, nem contagem de estrelas para ler, nem forma de reexibir o cartão sob demanda.
As atualizações dentro do app incentivam os usuários ativos a instalar uma versão mais nova. Não é um interruptor de controle remoto: as instalações nunca são silenciosas, as reinicializações nunca são forçadas e as atualizações só avançam para um código de versão superior. O que você controla é o tipo de fluxo — flexível ou imediato — e o quanto o recomenda, por meio da prioridade de atualização vinculada à versão. Todo o resto é decisão do Play.
Mais um detalhe que vale saber antes de projetar a interface: se o seu app está em uma faixa de teste fechado, a avaliação e o comentário coletados pelo fluxo de avaliação são compartilhados de forma privada com você, como desenvolvedor, em vez de serem publicados. Útil para ensaiar, mas não são os mesmos dados das avaliações públicas.
2. Requisitos a verificar antes de qualquer código
- Avaliações dentro do app funcionam em dispositivos Android (celulares, tablets e TVs com Google TV) com Android 5.0 (nível de API 21) ou superior que tenham a Google Play Store instalada, e em dispositivos ChromeOS que tenham a Play Store instalada.
- A integração de avaliação precisa da versão 1.8.0 ou superior da biblioteca Play Core; o guia de integração atual usa
com.google.android.play:review:2.0.2, além decom.google.android.play:review-ktx:2.0.2para Kotlin. - As atualizações dentro do app são compatíveis com o Android 5.0 (nível de API 21) ou superior, e apenas em celulares Android, tablets Android e ChromeOS. Elas não são compatíveis com apps que usam arquivos de expansão APK (
.obb). - A integração de atualização usa
com.google.android.play:app-update:2.1.0, além decom.google.android.play:app-update-ktx:2.1.0para Kotlin.
Duas consequências decorrem disso. Se o seu app distribui arquivos de expansão, atualizações dentro do app ficam fora de questão e você solicita atualizações pela ficha do app na loja. E em um dispositivo sem a Play Store, ambas as APIs simplesmente não fazem nada — falham em silêncio. Portanto, condicione sua interface ao resultado da sua própria chamada de solicitação em vez de presumir que o recurso está disponível.
3. Avaliação no app: os momentos em que você pode solicitar
A orientação do Google é curta e rígida. Acione o fluxo depois que o usuário tiver vivenciado o suficiente do app ou jogo para dar um feedback útil — uma fase concluída, uma exportação finalizada, uma primeira sessão bem-sucedida. Não solicite em excesso; cada solicitação desnecessária consome a cota descrita abaixo e frustra a pessoa que ela deveria agradar.
A proibição rígida é sobre questionar antes. Seu app não pode perguntar nada ao usuário antes ou durante a apresentação do botão ou cartão de avaliação, incluindo perguntas de opinião como "Você gosta do app?" e preditivas como "Você avaliaria este app com 5 estrelas?". Filtrar primeiro os usuários insatisfeitos é exatamente o que a regra existe para impedir. Se quiser seu próprio ponto de entrada, direcione-o para a ficha do app na Play Store — um link simples que sempre funciona — e reserve a API para momentos que você controla.
4. Avaliação dentro do app: as regras de design que você não pode flexibilizar
O cartão pertence ao Play, não ao seu design system. Exiba-o como está: sem alterações de tamanho, opacidade, forma ou qualquer outra propriedade. Não coloque uma sobreposição em cima ou ao redor do cartão, e mantenha o cartão e o fundo dele na camada mais alta. Depois que o cartão aparecer, nunca o remova programaticamente — ele é dispensado pela ação explícita do usuário ou por um mecanismo interno da Play Store.
No código, aguarde o fluxo de revisão terminar antes de o app seguir seu caminho normal, por exemplo, antes de avançar para a próxima fase. Se ocorrer um erro durante o fluxo, não avise o usuário e não altere seu fluxo: continue normalmente assim que o callback de conclusão for disparado.
5. Cotas: por que launchReviewFlow não é um botão
O Play aplica uma cota de tempo sobre a frequência com que um usuário pode ver o diálogo de avaliação, e é por isso que chamar launchReviewFlow mais de uma vez em um curto período — o próprio exemplo da Google é menos de um mês — pode simplesmente não exibir nada. O valor exato é um detalhe de implementação e pode mudar sem aviso.
Como a cota muda, você não pode criar uma interface que pressuponha sucesso. Um botão de chamada para ação dedicado que dispara a API é o antipadrão que o Google aponta explicitamente: o usuário pode ter atingido a cota, o fluxo nunca aparece e seu botão parece quebrado. Para um clique deliberado de "avalie-nos", redirecione para a Play Store. Reserve a API para os momentos em que a solicitação é esperada e a ausência de um diálogo é imperceptível.
6. Avaliação no app: o caminho do código, passo a passo
Três ligações, nesta ordem.
- Crie o gerenciador.
ReviewManagerFactory.create(context)fornece oReviewManagerque inicia o fluxo. - Pré-carregue as informações. Chame
requestReviewFlow(). Em caso de sucesso, você recebe o objetoReviewInfonecessário para o lançamento; em caso de falha, leia oReviewErrorCodedaReviewExceptione registre no log. O objetoReviewInfoé válido por tempo limitado, então solicite-o com antecedência, mas só quando tiver certeza de que o fluxo será lançado. - Lançamento.
launchReviewFlow(activity, reviewInfo)exibe o cartão. O callback de conclusão informa que o fluxo terminou — nada mais. Continue o fluxo do seu app independentemente do resultado.
7. Atualizações no app: flexíveis ou imediatas
Existem dois fluxos, e eles respondem a perguntas de produto diferentes. As atualizações flexíveis são baixadas em segundo plano com monitoramento de estado transparente, então o usuário continua trabalhando enquanto a atualização chega — a escolha certa quando a nova versão adiciona recursos ou melhorias de desempenho que podem esperar alguns minutos. As atualizações imediatas são um fluxo em tela cheia que exige que o usuário atualize e reinicie antes de continuar, para atualizações críticas para a funcionalidade principal; depois que o usuário aceita, o Play cuida tanto da instalação quanto da reinicialização do app.
Escolha o menor fluxo que resolve o problema real. A escalada é legítima — você pode notificar de forma suave primeiro e eventualmente exigir a atualização — mas ela pertence à sua lógica de prioridade e obsolescência, não a uma decisão tomada uma única vez no momento da implementação.
8. Dias de defasagem e prioridade de atualização: como "quão grave" é expresso
Dois sinais informam ao seu app o quão atrasada está uma atualização.
clientVersionStalenessDays()retorna o número de dias desde que a atualização ficou disponível na Play Store. Este é o relógio natural de escalonamento: espere alguns dias antes de um aviso flexível, mais alguns antes de exigir um imediato.updatePriority()retorna a prioridade que você atribuiu à versão — um número inteiro entre 0 (o padrão) e 5 (o mais alto). Ela é definida pelo campoinAppUpdatePriorityemEdits.tracks.releasesna API do Google Play Developer. Todas as versões recém-adicionadas em uma release compartilham a prioridade da release, e a prioridade só pode ser definida durante o lançamento gradual de uma nova release — não pode ser alterada depois, então o valor precisa ser decidido antes de você publicar.
Um detalhe sutil pega muita gente: a prioridade que seu app vê considera todos os códigos de versão entre a versão instalada e a mais recente disponível, independentemente da faixa em que cada um foi lançado. Lance a versão 1 em produção sem prioridade, a versão 2 em uma faixa de teste interno com prioridade 5 e depois a versão 3 em produção sem prioridade — os usuários de produção que atualizam da 1 para a 3 ainda recebem prioridade 5, porque a versão 2 está no meio.
Anote também o limite: inAppUpdatePriority não é compatível quando você envia um build para o compartilhamento interno de apps, então comportamentos dependentes de prioridade não podem ser ensaiados dessa forma.
9. Iniciar o fluxo de atualização e ler o resultado
Verifique a disponibilidade primeiro. Crie um AppUpdateManager com AppUpdateManagerFactory.create(context), leia appUpdateInfo, confirme que updateAvailability() retorna UPDATE_AVAILABLE e confirme que o tipo de fluxo que você pretende usar é permitido com isUpdateTypeAllowed(). Só então chame startUpdateFlowForResult() com um launcher de resultado de atividade registrado para o contrato embutido StartIntentSenderForResult.
Cada instância de AppUpdateInfo pode iniciar uma atualização apenas uma vez. Se a atualização falhar e você quiser tentar de novo, solicite um novo AppUpdateInfo e verifique novamente a disponibilidade e a permissão. O callback retorna RESULT_OK (aceito), RESULT_CANCELED (recusado) ou RESULT_IN_APP_UPDATE_FAILED (algo mais bloqueou o consentimento ou a atualização). Com atualizações imediatas, você pode nunca ver RESULT_OK, porque a atualização geralmente termina antes que o controle volte ao seu app.
O AppUpdateOptions também carrega uma flag AllowAssetPackDeletion, falsa por padrão, que permite a uma atualização limpar pacotes de assets quando o armazenamento do dispositivo está apertado. Defina-a deliberadamente: primeiro verifique se a atualização funciona com a flag em falso, e só então opte por ativá-la, porque a flag existe justamente para excluir assets.
10. Atualizações flexíveis: monitore, baixe e depois reinicie
Registre um InstallStateUpdatedListener antes de iniciar o fluxo e cancele o registro quando não precisar mais de atualizações. Enquanto o estado for DOWNLOADING, você pode ler bytesDownloaded() e totalBytesToDownload() para mostrar o progresso real. Quando o estado chegar a DOWNLOADED, o Play não reinicia o app para você — esse é o ponto de um fluxo flexível. Mostre uma notificação ou um snackbar, deixe o usuário confirmar e chame completeUpdate() quando ele confirmar.
Onde essa chamada acontece muda a experiência. Em primeiro plano, a plataforma mostra uma interface em tela cheia e reinicia o app em segundo plano; em segundo plano, a atualização é instalada silenciosamente. De qualquer forma, verifique em cada ponto de entrada do app — onResume() costuma ser o lugar — se uma atualização ainda está no estado DOWNLOADED e solicite novamente se estiver. Caso contrário, os bytes baixados continuam ocupando o armazenamento do usuário sem nunca serem instalados.
11. Atualizações imediatas: retomar um fluxo travado
Assim que o usuário aceita uma atualização imediata, o Play exibe o progresso sobre a sua interface durante toda a duração e, se o usuário fechar ou encerrar o app, o download e a instalação continuam em segundo plano. Isso é conveniente para a atualização e complicado para o seu código: seu app pode voltar ao primeiro plano num estado em que o fluxo nunca foi concluído formalmente.
Trate isso no onResume(). Se updateAvailability() retornar DEVELOPER_TRIGGERED_UPDATE_IN_PROGRESS, chame startUpdateFlowForResult() novamente para retomar. Quando o usuário recusa ou cancela, a interface do Play fecha e seu app precisa escolher: se ele consegue rodar sem a atualização, deixe o usuário continuar e pergunte de novo mais tarde; se realmente não consegue, diga isso em linguagem clara antes de reiniciar o fluxo, para que o reinício seja compreendido em vez de sentido como um ciclo de falhas.
12. Testando as duas APIs em dispositivos reais
A maioria das integrações "quebradas" são artefatos de teste. Para atualizações dentro do app, o compartilhamento interno de apps é o caminho padrão: garanta que o dispositivo de teste tenha uma build compatível com atualizações dentro do app instalada a partir de uma URL de compartilhamento interno de apps, envie uma versão com código de versão maior, abra o link de compartilhamento da nova versão no dispositivo sem instalar pela página do Play que aparece, depois inicie o app pelo launcher — a atualização agora deve ser oferecida ao seu app.
Se ainda não estiver, verifique as quatro causas habituais: a conta precisa ser proprietária do app, ou seja, ter baixado seu app do Play pelo menos uma vez; a build de teste precisa compartilhar o ID do aplicativo e a chave de assinatura com a versão do Play; o código de versão instalado precisa ser menor que o da atualização; e o inAppUpdatePriority não é compatível com o compartilhamento interno de apps, então fluxos baseados em prioridade funcionam de forma diferente ali.
Para avaliações, a diferença prática está no que o testador vê. Em uma faixa de teste fechado, a nota e o comentário coletados vão de forma privada para o desenvolvedor em vez de aparecerem publicamente — bom para verificar sua integração e o momento, não um substituto para a variação real da nota.
13. O que monitorar quando ambos estiverem no ar
Os prompts de avaliação devem mover o volume de avaliações de forma gradual e nunca em um pico que coincida com um lançamento: um pico é um efeito de timing, não uma mudança de qualidade, e a causa habitual é um prompt colocado cedo demais na sessão. Para atualizações, acompanhe semana a semana a parcela de usuários ativos na versão mais recente do código de versão — uma atualização flexível deve aumentar esse número sem mexer na sua média de avaliação, e deve reduzir o número de relatos de bugs que você recebe de builds antigas.
Se os prompts se correlacionam com desinstalações, ou com comentários raivosos de uma estrela, a resposta não é exibir prompts com mais frequência ou mais cedo no ciclo de instalação. Mova o gatilho para mais adiante na jornada do usuário, onde o valor do app já foi demonstrado.
Gerencia contas de desenvolvedor em escala? Cuidamos do lado operacional.
Recebemos sua mensagem e responderemos em até 24 horas.
← Voltar para editar