📖 Guia completo

Onboarding de apps Shopify: da instalação ao primeiro valor

Um app instalado pela Shopify App Store é julgado em uma janela que não é dele, por um lojista que provavelmente está testando dois concorrentes ao mesmo tempo e que pode desfazer toda a decisão com um clique. Este guia mostra as cinco etapas entre a instalação e um resultado visível, onde os lojistas realmente desistem, os padrões de onboarding que sobrevivem dentro de um admin embutido e as métricas que dizem se a sua primeira sessão está funcionando.

📅 Atualizado em outubro de 2026 ⏱ 12 min de leitura ✍️ Por Kompassify
🌐 English Português Français Deutsch
As cinco etapas do onboarding de um app Shopify entre a instalação e o primeiro valor (aprovar, chegar, configurar, primeira ação e primeiro resultado), com as desistências concentradas na etapa de configuração

A maioria dos softwares recebe uma chance justa. O comprador agenda uma demo, reserva uma hora e chega com intenção. Um app instalado pela Shopify App Store não recebe nada disso. O lojista encontrou você em uma lista de anúncios quase idênticos, instalou três de vocês para comparar e agora está olhando para a sua primeira tela entre um pedido embalado e outro. Seja lá o que o seu app faça, ele precisa fazer algo visível antes que essa atenção acabe.

É por isso que o onboarding de um app não é simplesmente onboarding com outro logo. A interface ao redor pertence a outra pessoa, o lojista não reservou tempo para você, a loja que você está configurando pode ter dois dias ou dez anos de vida, e desinstalar custa um clique e nenhuma negociação. Cada uma dessas restrições muda o que a primeira sessão deve conter.

Este guia percorre as etapas entre a instalação e o primeiro valor, os pontos em que os lojistas realmente desistem, os padrões que funcionam em uma página embutida no admin, a janela de desinstalação que quase ninguém mede e o punhado de métricas que vai dizer se algo disso está funcionando.

Principais aprendizados

  • Instalar não é adotar. A App Store mede instalações; o seu negócio depende do número bem menor de lojistas que chegam a um resultado visível.
  • Configuração antes do valor é o principal assassino. Um lojista que ainda não viu nada não vai preencher um formulário de configurações para você.
  • Entregue um padrão que funciona. Se o seu app não consegue fazer nada sem configuração, a configuração faz parte do produto, não é um pré-requisito para ele.
  • Projete para a loja vazia. Uma primeira tela que pressupõe catálogo, tráfego ou histórico de pedidos quebra justamente para os lojistas que mais precisam de ajuda.
  • Os primeiros sete dias decidem tudo: desinstalações, avaliações e se o período de teste converte. Meça essa janela especificamente.
  • Onboarding que você não consegue mudar rápido é onboarding que você não consegue melhorar. O texto muda toda semana nos primeiros meses; as versões, não.

O que torna o onboarding de apps Shopify diferente

Onboarding de app Shopify: definição

Onboarding de app Shopify é tudo o que acontece entre o lojista aprovar a instalação do seu app e esse app produzir um resultado que ele consegue ver na loja. Normalmente acontece dentro do Shopify admin, em uma página embutida emoldurada por uma interface que você não controla, disputando atenção com o painel do próprio lojista e com os outros apps que ele instalou na mesma tarde.

Quatro restrições decorrem desse contexto, e elas moldam todo o resto deste guia.

Você herda uma plateia, não um cliente

A descoberta pela app store traz pessoas curiosas, não comprometidas. A intenção precisa ser conquistada dentro do app, e rápido.

A moldura não é sua

Seu app fica dentro do admin que o lojista já conhece. Uma orientação que briga com essa moldura parece uma intrusão; uma que combina com ela parece parte da plataforma.

O estado da loja é imprevisível

Algumas lojas chegam com milhares de produtos e anos de pedidos; outras chegam vazias. Sua primeira tela precisa funcionar para as duas, e a vazia é o caso mais difícil.

Sair não tem atrito nenhum

Sem contrato, sem call de offboarding, sem aviso prévio. Uma desinstalação é um veredito silencioso, geralmente dado na primeira semana.

Se o seu produto também atende lojistas diretamente no seu próprio domínio, vale ler este guia junto com o nosso guia de onboarding para e-commerce, que trata do outro lado do problema: levar uma loja do cadastro à primeira venda. Este guia trata do caso mais específico de um app que vive dentro do admin de outra pessoa.

As cinco etapas entre a instalação e o valor

Todo lojista que acaba amando o seu app passa por cinco etapas, e cada etapa descarta uma parte deles. Dar nome a elas é o que transforma um vago "nossa ativação está baixa" em um passo específico e corrigível.

Cinco etapas. É na terceira que os lojistas vão embora. ETAPA 1 Aprovar permissões parecem proporcionais ao que você prometeu ETAPA 2 Chegar a primeira tela responde "e agora?" em um só olhar ETAPA 3 · O ABISMO Configurar ajustes, conexões, escolha de plano: tudo pedido antes do retorno ETAPA 4 Primeira ação o lojista faz aquilo para que o seu app realmente existe ETAPA 5 Resultado algo visível mudou na loja O que o lojista se pergunta em cada etapa "isso é seguro?" "onde estou?" "já vale a pena?" "funcionou?" "fico com ele?" tela de permissões primeira tela o ponto de abandono ação principal avaliar ou desinstalar LEVE A ETAPA 3 PARA DEPOIS DA ETAPA 5 SEMPRE QUE PUDER entregue um padrão que funciona, mostre o resultado e só então ofereça os ajustes que o melhoram

Pedir configuração antes de entregar valor é a maior lacuna na maioria dos funis de apps.

Onde os lojistas realmente desistem

Quatro padrões de falha explicam a maior parte da perda entre a instalação e o primeiro resultado. Os quatro são decisões de design, não problemas dos lojistas, e essa é a boa notícia.

A comparação que você não vê. Lojistas costumam instalar vários apps da mesma categoria de uma vez e ficar com o que produziu um resultado primeiro. Isso significa que o seu onboarding não está sendo comparado com a sua própria versão anterior; está sendo comparado com o concorrente que conseguiu mostrar algo na tela em noventa segundos. Aqui, a velocidade até um resultado visível não é um detalhe; é o critério de seleção.

Como projetar a primeira tela depois da instalação

A tela em que o lojista chega depois de aprovar a instalação trabalha mais do que qualquer outra página do seu produto. Quatro coisas pertencem a ela, e muitas outras não.

Orientar Uma frase sobre o que vem a seguir

Não uma mensagem de boas-vindas sobre a sua missão. Uma descrição simples do que este app está prestes a fazer na loja.

Sequenciar Um checklist de configuração curto

De três a cinco passos concretos, o primeiro já marcado porque a instalação conta. Progresso visível é progresso que as pessoas terminam.

Provar Os dados deles, não dados de exemplo

Puxe um produto real, um pedido real, o nome real do tema. Reconhecimento faz mais pela confiança do que qualquer texto de onboarding.

O padrão de checklist merece seu lugar aqui porque sobrevive a interrupções, que são a condição normal da atenção de um lojista. Quem sai no meio volta e encontra o que falta, visível, em vez de uma página em branco e uma lembrança vaga. Os detalhes de construção (quantidade de passos, ordem, o que fazer com o último passo) estão em como criar um checklist de onboarding de usuários, com exemplos reais de interface em exemplos de checklist de onboarding.

O que não pertence à primeira tela: um tour de funcionalidades por cada item do menu, um vídeo, uma comparação de planos, um pedido de avaliação ou um modal perguntando como a pessoa conheceu você. Cada um deles é um imposto cobrado antes de qualquer valor ser entregue. O guia de telas de boas-vindas mostra o que uma primeira tela pode razoavelmente pedir.

Como construir o onboarding de um app Shopify em 7 passos

A ordem importa. A maioria destes passos é barata; o primeiro é o que os times pulam e aquele do qual todo o resto depende.

  1. Defina o primeiro resultado visível
  2. Faça o app funcionar com zero configuração
  3. Monte o checklist de configuração em torno do resultado, não das funcionalidades
  4. Projete de propósito o caminho da loja vazia
  5. Coloque a ajuda ao lado do passo que precisa dela
  6. Planeje a visita de retorno
  7. Meça os primeiros sete dias

1. Defina o primeiro resultado visível

Uma frase, verificável nos seus dados, escrita como algo que o lojista perceberia: "um selo ativo aparece em uma página de produto", "a primeira mensagem de carrinho abandonado foi enviada", "o primeiro relatório traz os números reais desta loja". "Configuração concluída" não é um resultado; é o seu marco, não o deles. Tudo o que vem depois, inclusive a sua métrica de ativação, herda essa definição, então escolha a que melhor separa os lojistas que ficaram dos que foram embora. Nosso guia de ativação de usuários mostra como encontrá-la nos dados que você já tem.

2. Faça o app funcionar com zero configuração

Entregue padrões opinativos. Escolha a opção mais comum, aplique, mostre o resultado e coloque um "alterar" ao lado. Um lojista que vê algo funcionando e quer ajustar está em um estado de espírito completamente diferente de quem encara um formulário vazio. Quando uma decisão realmente não pode ter padrão (uma moeda, um mercado, uma configuração legal), peça exatamente essa e nada mais.

3. Monte o checklist de configuração em torno do resultado, não das funcionalidades

Cada passo deve aproximar o lojista do resultado visível, escrito no vocabulário dele. "Escolha onde o widget aparece" é melhor do que "Configure as regras de posicionamento". Fique entre três e cinco passos: listas mais longas são lidas como trabalho, e uma lista que não pode ser terminada de uma vez quase sempre não será terminada. Marque a própria instalação como o passo um, para que o lojista comece com progresso em vez de uma barra vazia; a psicologia por trás disso está em barras de progresso de onboarding.

4. Projete de propósito o caminho da loja vazia

Decida o que o seu app mostra para uma loja sem pedidos, sem tráfego e com oito produtos. Se a resposta honesta for "nada útil ainda", diga isso e dê ao lojista algo para fazer enquanto isso: uma prévia montada com dados de exemplo claramente identificados como exemplo, uma configuração que ele possa preparar, um aviso sobre o que vai aparecer quando o primeiro pedido chegar. Silêncio e zeros parecem um app quebrado; uma espera explicada parece um app funcionando.

5. Coloque a ajuda ao lado do passo que precisa dela

Documentação em uma aba separada é documentação que ninguém lê no meio de uma tarefa. Um tooltip curto no campo que confunde as pessoas, uma explicação de uma linha embaixo do botão que tem consequências, uma resposta direta para a pergunta que a sua caixa de suporte recebe todos os dias. Padrões e exemplos de texto estão em exemplos de tooltips de onboarding, e a versão estrutural, decidir o que responder dentro do produto e o que deixar para uma central de ajuda, está em suporte in-app.

6. Planeje a visita de retorno

Muitos lojistas saem no meio da configuração por motivos totalmente comuns. A questão é o que acontece quando eles voltam três dias depois. Um checklist que guardou seu estado, uma linha curta de "você parou aqui" e uma única próxima ação vão recuperar uma parcela relevante deles. Se o seu app pode enviar e-mail, uma mensagem com link direto para o passo inacabado rende mais do que uma sequência de nutrição genérica; gatilhos de onboarding mostra como acertar o momento sem ser insistente.

7. Meça os primeiros sete dias

Registre a instalação, cada passo do checklist, a primeira ação, o primeiro resultado e a desinstalação, cada um com data e hora. Isso basta para desenhar o funil, encontrar a etapa que vaza e ver se os lojistas que desinstalam chegaram a algum lugar antes. Sem eventos por passo, você só vai saber que a ativação está baixa, nunca qual frase causou isso.

A janela de desinstalação

As desinstalações se concentram no início. Um lojista que mantém o seu app há um mês raramente o remove por impulso; um que o tem há três dias ainda está decidindo. Isso faz da primeira semana a única janela em que uma intervenção muda alguma coisa, e a única janela sobre a qual a maioria dos times não tem dados.

Vale fazer três coisas com ela. Primeiro, meça as desinstalações precoces como uma métrica própria, em vez de misturá-las ao churn geral, e divida-as conforme o lojista tenha ou não chegado ao primeiro valor; os dois grupos pedem respostas completamente diferentes. Segundo, trate uma desinstalação que aconteceu antes do primeiro resultado como um defeito do onboarding do produto e encaminhe-a para quem é responsável pela primeira tela, não para o suporte. Terceiro, se for perguntar algo na saída, faça uma única pergunta, no momento da saída, com opções baseadas no que você já suspeita; pesquisas de saída mostra como fazer essa única pergunta valer a pena.

Avaliações são resultado do onboarding. As notas na app store são escritas desproporcionalmente por pessoas na primeira semana, seja encantadas porque algo funcionou de imediato, seja irritadas porque não funcionou. Melhorar a primeira sessão costuma ser um jeito mais confiável de subir a nota do que pedir que mais gente avalie. E, se for pedir, peça depois do primeiro resultado visível, nunca antes.

Métricas para um app Shopify

Os painéis da app store mostram instalações. Instalações são o número menos informativo que você tem, porque medem o seu anúncio, não o seu produto. Estas são as métricas que descrevem o onboarding.

Métrica Como ler O que um número ruim costuma significar
Taxa de instalação → ativação Parcela das instalações que chega ao primeiro resultado visível que você definiu A distância entre o que o anúncio prometeu e o que a primeira tela entrega
Tempo até o primeiro resultado Mediana de minutos ou horas entre a instalação e esse marco, mais a cauda longa Configuração na frente do valor; uma dependência que você não informou
Conclusão por passo do checklist Taxa de conclusão de cada passo, em ordem Aponta a frase ou o campo exato que perde as pessoas
Taxa de desinstalação em 7 dias Desinstalações em até uma semana, divididas conforme o primeiro valor tenha sido alcançado ou não Antes do valor: onboarding. Depois do valor: posicionamento, preço ou encaixe
Taxa de retorno à segunda sessão Parcela dos lojistas que abrem o app de novo depois da primeira sessão A primeira sessão terminou sem nada que valesse a volta
Contatos de suporte por instalação Tickets na primeira semana ÷ instalações Um passo específico não está explicado, geralmente o mesmo toda semana

Divida todas elas por perfil de loja. Uma loja com catálogo maduro e pedidos constantes atravessa sem esforço um fluxo que uma loja recém-criada não consegue concluir de jeito nenhum, e uma única média misturada esconde os dois fatos. A visão por coorte, as instalações deste mês contra as do mês passado, é o que mostra se uma mudança realmente ajudou; análise de coorte explica a mecânica.

Onboarding de apps Shopify: faça e não faça

Faça

  • Entregue um resultado visível antes de pedir configuração
  • Defina um padrão para tudo o que pode ter padrão
  • Use os dados reais da loja do lojista na primeira tela
  • Projete o caso da loja vazia de propósito
  • Mantenha o checklist de configuração entre três e cinco passos
  • Meça as desinstalações separadamente antes e depois do primeiro valor

Não faça

  • Abrir em um formulário de configurações ou em um seletor de planos
  • Fazer um tour pelo menu antes de o app ter feito qualquer coisa
  • Pressupor que existem catálogo, tráfego ou histórico de pedidos
  • Esconder uma dependência até depois da instalação
  • Pedir uma avaliação antes do primeiro resultado
  • Reportar instalações como se fossem adoção

Como mudar o onboarding sem publicar uma nova versão

Os primeiros meses após o lançamento são o período em que o seu onboarding está mais errado e em que a sua capacidade de mudá-lo mais importa. O texto de um passo, a ordem do checklist, a dica no campo que gera todos os tickets de suporte: tudo isso precisa mudar toda semana, e nada disso justifica um ciclo de deploy.

O Kompassify funciona sobre um web app existente como uma camada de orientação, e é isso que torna esse ritmo possível. Checklists de onboarding, product tours, tooltips e hotspots são criados em um editor visual e publicados sem nova versão, então a sequência de configuração pode ser reescrita à tarde e direcionada a um segmento: lojas novas contra lojas estabelecidas, lojistas que travaram no passo três contra os que terminaram. Cada guia mostra sua própria taxa de conclusão passo a passo, para que você veja qual frase perdeu as pessoas em vez de adivinhar. Anúncios in-app trazem os lojistas que voltam de novo ao passo inacabado, e pesquisas in-app fazem uma única pergunta no momento a que ela se refere.

Um checklist de onboarding guiando um lojista pelos passos de configuração de um app até o primeiro resultado visível na loja

Um checklist curto sobrevive a interrupções, a condição normal da atenção de um lojista.

Leve os lojistas a um resultado visível já na primeira sessão

O Kompassify permite que times de produto e de onboarding adicionem checklists, tours guiados, tooltips e pesquisas in-app a um app existente: sem ticket para a engenharia, com dados de conclusão em cada passo. Grátis até 100 usuários ativos mensais, planos a partir de $129/mês, em conformidade com o GDPR e hospedado na UE.

Comece grátis →

A versão em uma frase

Um app Shopify é escolhido nos minutos seguintes à instalação, e quem vence é o app concorrente que produziu algo visível primeiro; por isso, fazer onboarding significa entregar um padrão que funciona, mostrar um resultado real antes de pedir configuração e medir os primeiros sete dias de perto o bastante para saber qual passo perdeu os lojistas que foram embora.

Perguntas frequentes

O que é onboarding de app Shopify?

Onboarding de app Shopify é tudo o que acontece entre o lojista aprovar a instalação do seu app e esse app produzir um resultado que ele consegue ver na loja. Normalmente acontece dentro do Shopify admin, em uma página embutida que você não controla totalmente, ao lado do painel do próprio lojista e de todos os outros apps que ele instalou na mesma tarde. É esse contexto que o diferencia do onboarding em um produto SaaS independente: o lojista não reservou tempo para você, a interface ao redor não é sua e desistir custa a ele um clique.

Por que os lojistas instalam um app Shopify e nunca o usam?

Geralmente porque o app pediu configuração antes de mostrar qualquer coisa. Quem instala um app está comparando opções, muitas vezes com dois ou três apps concorrentes instalados ao mesmo tempo, e o primeiro a produzir um resultado visível costuma ser o que sobrevive. Apps que abrem em uma tela de configurações vazia, em um seletor de planos ou em um pedido para conectar outra coisa perdem essa comparação antes de mostrar a que vieram. A segunda causa comum é uma primeira tela que pressupõe catálogo, tráfego ou histórico de pedidos que a loja ainda não tem.

O que a primeira tela de um app Shopify deve mostrar?

O caminho mais curto até um resultado visível, expresso na linguagem do lojista e não nos nomes das suas funcionalidades. Na prática, isso significa um pequeno checklist de configuração com três a cinco passos concretos, o primeiro já concluído, dados reais da loja em vez de exemplos fictícios e uma única ação principal. Escolha de plano, configurações avançadas, integrações e tours de funcionalidades vêm depois do primeiro resultado, não antes. Se o seu app precisa de configuração para fazer qualquer coisa, entregue uma configuração padrão sensata e deixe o lojista alterá-la depois.

Como medir o onboarding de um app Shopify?

Três números concentram a maior parte do sinal: a taxa de instalação para ativação, ou seja, a parcela das instalações que chega ao primeiro valor que você definiu; o tempo entre a instalação e esse marco; e a taxa de desinstalação precoce, normalmente medida nos primeiros sete dias. Acrescente a conclusão por passo do seu checklist de configuração para ver qual passo perde pessoas e divida cada número por perfil de loja: uma loja com cinquenta produtos e pedidos constantes não se comporta em nada como uma loja que instalou o seu app no primeiro dia de existência.

Quanto tempo deve durar o onboarding de um app Shopify?

Busque um resultado visível ainda na primeira sessão e trate qualquer coisa acima de alguns minutos como um problema de design, não do lojista. Lojistas avaliam apps nos intervalos entre outras tarefas, então um fluxo que exige uma hora reservada será abandonado, e retomado com menos frequência do que você imagina. Quando o trabalho real leva mesmo mais tempo (importar um catálogo grande, esperar tráfego antes que um mecanismo de recomendação tenha algo para mostrar), divida a jornada: entregue um resultado visível parcial imediatamente e traga o lojista de volta com um aviso in-app quando o resultado completo estiver pronto.

É possível mudar o onboarding de um app sem publicar uma nova versão?

Sim, se a camada de orientação for separada do código da aplicação. Ferramentas como o Kompassify adicionam checklists de onboarding, tours, tooltips e anúncios in-app a um web app existente a partir de um editor visual, então o checklist de configuração, a dica do estado vazio e o texto de um passo podem ser alterados e direcionados a um segmento sem deploy. Isso importa mais nos primeiros meses após o lançamento, quando a forma mais rápida de descobrir o que os lojistas entendem errado é mudar o texto toda semana e observar a conclusão dos passos se mexer.