PromptSurge

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

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

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

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