SDK Unity
Um prompt de avaliação Unity para iOS e Android em uma chamada C#
O PromptSurge para Unity é um pacote UPM que exibe um pre-prompt curto, com a sua marca, no seu jogo e depois abre a tela de avaliação nativa: StoreKit no iOS, Google Play In-App Review no Android. Chame RequestReview() depois de uma fase; o texto, o tema, a imagem de cabeçalho e os idiomas vêm do servidor.
Plano grátis · Unity 2022.3 LTS+ · iOS e Android
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 Unity faz por você
As duas lojas, uma chamada
PromptSurge.RequestReview() abre o SKStoreReviewController no iOS e o In-App Review do Play no Android por meio de pequenos shims nativos. A dependência do Play é resolvida automaticamente com o External Dependency Manager, ou com uma linha de Gradle sem ele.
Feito para interfaces de jogos
O diálogo é um overlay UGUI construído em código, com suas cores e sua imagem de cabeçalho. Ele cria um EventSystem se a sua cena não tiver um, fecha com um toque fora do card ou com o botão voltar do Android e fica oculto até estar pronto, então uma imagem lenta nunca bloqueia a entrada.
Silencioso no Editor
Toda chamada é, de propósito, um no-op no Play Mode: nenhum diálogo, nenhuma tela nativa, nenhum evento cobrado e nada gravado em PlayerPrefs. Gere um build para um dispositivo para ver.
Pronto para IL2CPP
O pacote inclui link.xml e atributos [Preserve], para que o managed code stripping em Medium ou High não remova o que o SDK precisa.
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, a tela nativa abre mesmo assim, para que o momento não seja perdido.
A integração
Adicione o pacote em Window > Package Manager > + > Add package from git URL, usando a URL com versão fixada que está na documentação. Depois, inicialize uma vez e chame RequestReview() no seu momento.
GameManager.cs
using PromptSurgeSDK;
public class GameManager : MonoBehaviour {
void Start() {
PromptSurge.Initialize("ps_live_your_key_here");
PromptSurge.Prefetch(); // warms the cache in the background
}
}LevelManager.cs
using PromptSurgeSDK;
public class LevelManager : MonoBehaviour {
void OnLevelComplete() {
PromptSurge.RequestReview();
}
}No Android, a biblioteca de avaliação do Play chega automaticamente pelo EDM4U; sem o EDM4U, adicione implementation 'com.google.android.play:review:2.0.1' ao mainTemplate.gradle. PromptSurge.SetLogLevel(LogLevel.Info) imprime uma linha por decisão enquanto você integra.
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 Unity são suportadas?
Unity 2022.3 LTS ou posterior. Versões LTS mais antigas podem funcionar, mas não foram compiladas e não são suportadas. Builds Android precisam de distribuição pela Play Store e minSdkVersion 21; builds iOS precisam do iOS 14.
Por que nada acontece no Editor?
Por design. Todo ponto de entrada é um no-op no Play Mode, para que os testes nunca gerem cobrança de impressões nem preencham o PlayerPrefs. Gere um build para um dispositivo; em um app novo, conte também com o aquecimento de 50 dispositivos, que você pode desativar no painel enquanto testa.
O QA pode ver o diálogo mais de uma vez?
Sim. PromptSurge.SetRateLimitBypass(true) desativa os cooldowns naquele dispositivo. A configuração fica salva no PlayerPrefs e registra um aviso em cada verificação enquanto estiver ativa, então nunca a chame em um build que você vai publicar.
O pre-prompt é permitido nas duas lojas?
As duas lojas exigem que a nota em si seja dada na própria tela delas, e o SDK só abre essas telas: StoreKit no iOS, Play In-App Review no Android, ambas sem alterações. A diretriz 5.6.1 da Apple não permite prompts de avaliação personalizados, e o Google pede que os apps não façam nenhuma pergunta aos usuários antes do card. O pre-prompt nunca pergunta como o jogador se sente nem que nota ele daria, e um título formulado como afirmação não faz pergunta nenhuma. As duas lojas também desaconselham abrir a tela delas com o toque em um botão, porque os limites podem impedir que ela apareça; as versões atuais do SDK pulam o pre-prompt onde esse limite provavelmente já foi atingido, separadamente no iOS e no Android. A forma como cada loja analisa um jogo específico é decisão dessa loja.
O que as lojas dizem e uma nota para o App Review (documentação em inglês) →Quanto custa?
O plano Indie é grátis para sempre: um app e 500 impressões de pre-prompt por mês, sem cartão de crédito. O Startup custa € 39 por app por mês (€ 31 com faturamento anual) para 10.000 impressões por mês e uma imagem de cabeçalho personalizada. O Growth custa € 99 e o Unlimited, € 249 por app por mês. Cada app tem seu próprio plano; o plano define quantos apps sua organização pode criar. Uma impressão de prompt é um pre-prompt exibido; telas de avaliação nativas e dispositivos do grupo de controle não são contados. Preços em EUR, IVA incluído.
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.
Uma chamada depois da sua fase, o resto no painel
Plano grátis, sem cartão de crédito. Crie um jogo, copie a chave de API e gere um build para um dispositivo.
Crie sua conta grátis →Já tem uma conta? Entrar