PromptSurge

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

Sua imagem de cabeçalho

Um pequeno favor

Trabalhamos muito na sincronização offline. Uma avaliação curta ajuda outras pessoas a descobrirem o app.

Agora nãoDeixar uma avaliação

2 · A tela de nota nativa

App Store ou Google Play

A tela da própria Apple ou do Google, exibida sem alterações

Agora não fecha o diálogo e não mostra mais nada.

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.

Ver documentação de integração →

No celular

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.

  1. 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.

  2. Um pequeno favor

    Trabalhamos muito nos mapas offline. Uma avaliação curta ajuda outros viajantes a encontrar este app.

    Agora nãoClaro

    Passo 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.

  3. 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

  1. Mais avaliações dos mesmos usuários

    O pedido chega em um momento que você escolheu, com um motivo para responder.

  2. Mais avaliações escritas

    Uma mensagem sobre um recurso convida a escrever, não só a dar estrelas.

  3. Suas palavras-chave nas palavras deles

    Avaliações que citam o que seu app faz mostram ao próximo visitante para quem ele é.

  4. 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

  1. 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.

  2. 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.

  3. 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.

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