SDK Android
Avaliação in-app no Android com a API In-App Review do Google Play
O PromptSurge para Android é uma biblioteca Kotlin que exibe um pre-prompt curto, com a sua marca, e depois inicia o fluxo In-App Review do Google Play quando o usuário confirma. Duas chamadas no seu código; o texto, o tema, a imagem de cabeçalho e os idiomas vêm do servidor.
Plano grátis · minSdk 24 · JitPack
1 · Seu pre-prompt
Um pequeno favor
Trabalhamos muito na sincronização offline. Uma avaliação curta ajuda outras pessoas a descobrirem o app.
2 · A tela de nota nativa
App Store ou Google Play
A tela da própria Apple ou do Google, exibida sem alterações
O que o SDK Android faz por você
O card de avaliação do próprio Play
Ao confirmar, o SDK executa requestReviewFlow() e launchReviewFlow() do ReviewManager. O card é do Google, exibido como é; o pre-prompt já fechou, e a própria cota do Play decide se o card aparece.
Combina com qualquer tema do app
O diálogo é Material 3. Em um tema Material, ele herda o visual do seu app; em temas AppCompat, da plataforma ou temas personalizados de jogos, ele usa o próprio tema embutido em vez de travar. As cores do painel são aplicadas por cima.
Seguro em apps em produção
minSdk 24, nenhuma permissão em tempo de execução, nada adicionado ao seu manifest, regras do R8 incluídas no AAR. requestReview() não faz nada se a activity estiver sendo finalizada, se o estado dela já tiver sido salvo ou se o diálogo já estiver aberto.
Todas as verificações de elegibilidade incluídas
Opt-out, um cooldown de 90 dias por dispositivo, o grupo de controle de 10%, o aquecimento de 50 dispositivos e o limite mensal do seu plano são verificados primeiro. Quando o pre-prompt é retido pelo aquecimento, pelo grupo de controle ou por um limite atingido, o fluxo de avaliação do Play é iniciado mesmo assim, para que o momento não seja perdido.
Respostas de Data Safety incluídas
O único identificador é o SHA-256 do ANDROID_ID mais o nome do seu pacote, nunca o ID bruto, e nenhum ID de publicidade é usado. O README lista exatamente o que declarar no formulário Data Safety do Play.
A integração
Adicione o JitPack e uma dependência Gradle (as coordenadas e a versão atual estão na documentação), inicialize na sua Application e depois chame requestReview() no seu momento.
Application.onCreate()
import com.promptsurge.sdk.PromptSurge
class MyApp : Application() {
override fun onCreate() {
super.onCreate()
PromptSurge.initialize(this, "ps_live_your_key_here")
}
}No seu momento
// In an Activity (AppCompatActivity works)
PromptSurge.requestReview(this)
// Or from a Fragment
PromptSurge.requestReview(requireActivity())Durante a integração, PromptSurge.setLogLevel(PromptSurge.LogLevel.INFO) imprime uma linha por decisão. O card do Play é limitado por cota e muitas vezes não mostra nada em um build de debug, então um card invisível ali é normal.
O que seu usuário vê, em três passos
Os mesmos usuários, o mesmo momento. A diferença é que primeiro eles recebem um pedido, com palavras sobre o seu app.
Viagem salva
Disponível offline
requestReview()
Passo 1
Seu código escolhe o momento
Chame requestReview() logo depois de algo que deu certo, como uma viagem salva ou uma fase concluída.
Um pequeno favor
Trabalhamos muito nos mapas offline. Uma avaliação curta ajuda outros viajantes a encontrar este app.
Agora nãoClaroPasso 2
O pre-prompt pede com as suas palavras
Uma mensagem curta que cita o que seu app faz. Agora não fecha a mensagem e nada mais acontece.
Avaliar este app
Toque em uma estrela para avaliar
Uma avaliação que cita o recurso
Os mapas offline salvaram minha viagem. Funciona sem sinal.
Passo 3
A janela de avaliação da loja
Um sim abre a janela da loja, sem alterações. A mensagem que acabaram de ler dá algo específico sobre o que escrever.
Para que ele foi feito
Mais avaliações dos mesmos usuários
O pedido chega em um momento que você escolheu, com um motivo para responder.
Mais avaliações escritas
Uma mensagem sobre um recurso convida a escrever, não só a dar estrelas.
Suas palavras-chave nas palavras deles
Avaliações que citam o que seu app faz mostram ao próximo visitante para quem ele é.
Um sinal que as lojas leem
Apple e Google dizem que notas e avaliações influenciam a posição dos apps na busca.
Seu painel mostra o que mudou para o seu app: avaliações escritas por dia, estrelas e menções de palavras-chave, antes do pre-prompt e com ele.
Fontes: Apple: busca na App Store · Google Play: descoberta e classificação de apps
Como funciona
Adicione o SDK
Instale o pacote iOS, Android ou Unity e chame initialize() uma vez na inicialização. Depois chame requestReview() em um momento que você escolher, como uma fase concluída, um projeto salvo ou um pedido finalizado.
Deixe o pre-prompt com a sua cara
No painel, escreva o título, a mensagem e os rótulos dos dois botões, ou deixe a IA integrada criar rascunhos a partir das suas próprias avaliações. Escolha um tema, adicione uma imagem de cabeçalho a partir do Startup e aceite: o texto é traduzido para 10 idiomas e chega aos dispositivos sem atualizar o app.
Compare com o grupo de controle
10% dos dispositivos nunca veem o pre-prompt e recebem a tela nativa diretamente, nos mesmos momentos. O painel coloca os dois grupos lado a lado e registra todos os dias a nota e o número de notas da sua loja.
Medido contra um grupo de controle, não suposto
Todo app tem um grupo de controle. 10% dos dispositivos são atribuídos a ele para sempre e nunca veem o pre-prompt: quando chegam ao momento que você escolheu, a tela nativa é disparada diretamente, como seria sem o PromptSurge. Um app novo também começa com um aquecimento de 50 dispositivos usando apenas a tela nativa, para que exista uma linha de base antes de o primeiro pre-prompt ser exibido.
O painel compara os dois grupos considerando todos os dispositivos que chegaram ao seu momento de avaliação: quantos viram o pre-prompt, quantos tocaram para continuar, quantas telas nativas foram solicitadas. Ele não dá um veredito até que cada lado tenha pelo menos 50 dispositivos.
Um limite honesto: a Apple e o Google nunca informam a um app se um usuário deu nota ou o que escreveu. Por isso, ao lado do funil, o PromptSurge registra uma vez por dia a nota e o número de notas da sua loja e mostra a variação. É um total da loja, não atribuído a nenhum prompt específico, e o painel deixa isso claro.
Grupo de controle de 10%
Atribuído por dispositivo, para sempre. A tela nativa é disparada diretamente nos mesmos momentos.
Aquecimento de 50 dispositivos
Um app novo começa só com a tela nativa, para que a linha de base venha primeiro.
Registro diário da loja
Sua nota média e seu número de notas em cada loja, uma vez por dia, para apps com link da loja.
Perguntas frequentes
Quais versões do Android são suportadas?
minSdk 24 (Android 7.0) ou posterior, Kotlin 1.9 ou posterior, distribuído pelo JitPack. O diálogo precisa de androidx.fragment, que o appcompat já inclui.
Como o pre-prompt se relaciona com as diretrizes de avaliação in-app do Google Play?
O Google pede que os apps exibam o card de avaliação dele sem alterações, sem nada por cima, e que não façam nenhuma pergunta ao usuário antes ou durante a exibição, citando perguntas de opinião ('Você gosta do app?') e preditivas ('Você daria 5 estrelas a este app?'). O PromptSurge nunca altera nem sobrepõe o card do Google Play, o diálogo dele já está fechado quando o card abre, e o texto padrão e o texto gerado são afirmações que pedem uma avaliação, nunca uma pergunta. O guia do Google também diz que os apps não devem oferecer um botão de call-to-action que acione o fluxo de avaliação, porque a cota pode impedir que o card apareça; o botão de confirmação de um pre-prompt é um botão desse tipo, então pondere essa orientação para o seu app. Nas versões atuais do SDK, o PromptSurge pula o pre-prompt em um dispositivo nos 30 dias seguintes à última solicitação do card do Google Play, o que reduz esse risco mas não consegue eliminá-lo, porque o Google não divulga a cota. Se você escrever seu próprio texto, formule o título como uma afirmação, como o exemplo desta página; o painel avisa sobre qualquer pergunta.
O que as lojas dizem e uma nota para o App Review (documentação em inglês) →Tocar em Agora não gasta a cota do Play?
Não. Com Agora não, nenhum fluxo de avaliação é iniciado. Só uma confirmação, ou os caminhos somente nativos do aquecimento, do grupo de controle e de um limite do plano atingido, chamam a API In-App Review.
Por que nada aparece no meu dispositivo de teste?
Geralmente é o aquecimento: um app novo fica só com o card do Play até 50 dispositivos distintos chegarem ao momento de avaliação. Desative-o para o app no painel enquanto testa. O próprio card do Play também é limitado por cota e muitas vezes fica oculto em builds de debug.
O que declaro em Data Safety?
Device or other IDs e App activity > App interactions: coletados, não compartilhados, para Analytics, não vinculados ao usuário, além do que o resto do seu app coleta. O README explica cada resposta.
Relacionados
Comece grátis
O plano Indie é grátis para sempre: um app, 500 impressões de pre-prompt por mês, sem cartão de crédito. Imagens de cabeçalho personalizadas começam no Startup, a € 39 por app por mês. Preços em EUR, IVA incluído.
Duas chamadas no seu app Android, o resto no painel
Plano grátis, sem cartão de crédito. Crie um app, copie a chave de API e publique.
Crie sua conta grátis →Já tem uma conta? Entrar