Publicando seu aplicativo na App Store da Shopify

A App Store da Shopify hospeda mais de 10.000 aplicativos competindo pela atenção do comerciante, mas conseguir que um aplicativo seja aprovado – e descoberto – é um processo que confunde até mesmo desenvolvedores experientes. A equipe de revisão do Shopify rejeita aproximadamente 40% dos primeiros envios, a maioria por motivos evitáveis, bem documentados, mas amplamente ignorados.

Este guia fornece o manual de envio completo: requisitos técnicos, padrões de design, otimização de listagem e estratégias de crescimento que movem aplicativos de zero instalações para receitas recorrentes mensais consistentes.

Principais conclusões

• O processo de revisão do Shopify leva em média de 10 a 15 dias úteis – planeje seu cronograma de lançamento de acordo
• A conformidade do sistema de design Polaris não é negociável para seções de aplicativos incorporados
• A qualidade da listagem de aplicativos impacta diretamente a conversão dos resultados de pesquisa em instalações – invista nisso
• A qualidade do fluxo de integração é um critério de revisão – a experiência inicial deve ser intuitiva sem a ajuda da equipe do Shopify
• Requisitos de transparência de preços: todas as cobranças devem usar a API Shopify Billing, sem pagamentos fora da plataforma
• A documentação de conformidade com privacidade (GDPR, CCPA) deve ser precisa e completa
• Uma classificação de avaliação de 4,0+ nos primeiros 6 meses é crítica para a visibilidade sustentada da App Store
• A análise do Painel de Parceiros revela exatamente onde os comerciantes abandonam seu funil de instalação

---

Conta de parceiro e pré-requisitos de configuração do aplicativo

Antes de enviar, sua conta de parceiro da Shopify e a configuração do aplicativo devem ser concluídas.

Requisitos da conta do parceiro:

1. Conta de parceiro Shopify verificada em partners.shopify.com
2. Conta bancária conectada para pagamentos de receitas
3. Autenticação de dois fatores habilitada
4. Contrato de parceria aceito (incluindo divisão de receita: Shopify cobra 20% das taxas de assinatura, 0% em aplicativos gratuitos para sempre ou acima de US$ 1 milhão de receita anual sob a reestruturação de divisão de receita)

Configuração do aplicativo no Painel do Parceiro:

Navegue até Aplicativos > Criar aplicativo. Configurar:

• Nome do aplicativo: exclusivo, descritivo, sem "Shopify" no nome (política de marca registrada)
• URL do aplicativo: o URL do seu aplicativo de produção (deve usar HTTPS)
• URLs de redirecionamento permitidos: inclua todos os URLs de retorno de chamada usados no seu fluxo OAuth
• Escopos: solicite apenas os escopos mínimos necessários — solicitações de escopo excessivas acionam a rejeição da revisão
• Proxy de aplicativo (se aplicável): configure o caminho do URL e o URL de destino

webhooks de conformidade com GDPR (obrigatório para todos os aplicativos):

# shopify.app.toml
[[webhooks.subscriptions]]
topics = ["customers/data_request"]
uri = "/webhooks/gdpr/customers-data-request"

[[webhooks.subscriptions]]
topics = ["customers/redact"]
uri = "/webhooks/gdpr/customers-redact"

[[webhooks.subscriptions]]
topics = ["shop/redact"]
uri = "/webhooks/gdpr/shop-redact"

Esses três endpoints devem retornar 200 em 5 segundos e realmente processar as solicitações de exclusão/exportação de dados. A equipe de revisão testa esses endpoints. Retornar 200 sem implementar a funcionalidade causa remoção pós-aprovação.

---

Requisitos de revisão técnica

A equipe de revisão do Shopify realiza verificações técnicas manuais e automatizadas. Passe em tudo isso antes de enviar.

Autenticação e segurança:

Requisitos de uso da API:

• Nunca use versões de API obsoletas — sempre use uma versão dos últimos 12 meses
• Lidar com a limitação de taxa de API normalmente (429 respostas devem acionar novas tentativas, não erros mostrados aos comerciantes)
• Nunca faça chamadas de API em nome de comerciantes após a desinstalação
• Limpe todos os dados do comerciante dentro de 48 horas após receber um webhook shop/redact

Referências de desempenho de aplicativos:

• Carregamento inicial do aplicativo incorporado: menos de 3 segundos em média no hardware do comerciante
• Sem erros de JavaScript no console do navegador durante o uso normal
• Todas as páginas são renderizadas corretamente no Chrome, Firefox, Safari e Edge
• Responsivo a dispositivos móveis se seu aplicativo tiver algum componente voltado para o cliente

Revisão do fluxo de integração:

A equipe de revisão instala seu aplicativo e avalia a experiência de primeira execução sem documentação. Sua integração deve:

1. Explique claramente o que o aplicativo faz na primeira tela
2. Oriente novos usuários nas etapas de configuração necessárias
3. Não é necessário entrar em contato com o suporte para concluir a configuração inicial
4. Use os componentes Polaris CalloutCard ou Banner para prompts de integração

---

Padrões de design e UX

Os requisitos de design do Shopify são aplicados estritamente porque a consistência da experiência do comerciante em todo o administrador é um valor central da plataforma.

Uso obrigatório do Polaris:

Todos os elementos da UI no aplicativo incorporado (renderizados no iframe de administração da Shopify) devem usar componentes Polaris. Especificamente proibido:

• Componentes de botão personalizados que não correspondem aos estilos Polaris Button
• Entradas de formulário personalizadas que não correspondem aos estilos Polaris TextField, Select, Checkbox
• Esquemas de cores personalizados que diferem dos tokens de design Polaris
• Estados de carregamento personalizados que não usam Polaris Spinner ou SkeletonPage

Navegação no App Bridge:

Os aplicativos incorporados devem usar o App Bridge para ações de navegação. Usar tags window.location.href ou <a> para navegação dentro do contexto incorporado prejudica a experiência do comerciante. Usar:

import { useNavigate } from "@remix-run/react";

// For in-app navigation
const navigate = useNavigate();
navigate("/app/settings");

// For external links (opens in new tab, respecting embedded context)
import { useAppBridge } from "@shopify/app-bridge-react";
const app = useAppBridge();
// Use Redirect action for external URLs

Estados de erro:

A equipe de revisão testa especificamente as condições de erro. Cada formulário deve lidar com:

• Erros de rede (mostre Banner com mensagem de erro, não uma página em branco)
• Erros de validação (inline, próximo ao campo relevante)
• Estados vazios (use o componente Polaris EmptyState com uma ação)
• Carregando estados (use SkeletonPage para carregamentos iniciais, Spinner para ações)

Requisitos de acessibilidade:

• Todas as imagens devem ter texto alternativo descritivo
• Os elementos interativos devem ser navegáveis pelo teclado
• O contraste de cores deve atender aos padrões WCAG AA (manuseados pela Polaris se usados corretamente)
• Etiquetas de leitor de tela em todos os botões somente de ícones

---

Otimização de listagem para descoberta na App Store

A listagem do seu aplicativo é uma página de vendas. Os comerciantes que encontram seu aplicativo por meio de pesquisa ou navegação por categoria tomam decisões de instalação com base na qualidade da sua listagem em segundos.

Otimização do nome do aplicativo:

O nome do seu aplicativo aparece nos resultados da pesquisa e deve comunicar o benefício principal. “Email Marketing Automation” tem melhor classificação para pesquisas relevantes do que “MailBooster Pro”. Mantenha os nomes com menos de 30 caracteres para uma exibição limpa nos resultados da pesquisa.

Slogan do aplicativo:

Uma frase, no máximo 60 caracteres. Lidere com o benefício, não com o recurso. “Recuperar 15% mais carrinhos abandonados” supera “E-mails automatizados de recuperação de carrinho”.

Estrutura de descrição do aplicativo:

Paragraph 1 (above the fold): Core value proposition and primary use case.
What problem does your app solve? For whom? What is the primary outcome?

Paragraph 2: Key features and how they deliver the benefit.

Paragraph 3: Social proof — merchants using the app, notable results, reviews.

Feature list (bullet points): 5-8 specific features with brief descriptions.

Paragraph 4: Integration information, compatibility notes.

Paragraph 5: Support and documentation resources.

Requisitos de captura de tela:

• Mínimo 3 capturas de tela, máximo 8
• Resolução: mínimo de 1600x900 pixels
• Mostre seu aplicativo em uso, sem gráficos de marketing ou diagramas de recursos
• A primeira captura de tela é a mais importante — ela aparece nos resultados da pesquisa
• Anote capturas de tela para destacar os principais recursos
• Inclui um vídeo passo a passo (30 a 90 segundos) — aplicativos com conversão de vídeo 40% melhor

Seleção de categoria e palavra-chave:

Escolha a categoria mais específica que descreve seu aplicativo com precisão. Aplicativos mal categorizados são penalizados na classificação de pesquisa. Para palavras-chave: inclua sinônimos, descrições de casos de uso e declarações de problemas que os comerciantes realmente procuram. Não coloque palavras-chave em sua descrição - o algoritmo do Shopify é sofisticado e penaliza a densidade não natural.

---

Estratégia da página de preços

A arquitetura de preços impacta significativamente as taxas de conversão de instalações e a rotatividade.

Desempenho do modelo Freemium:

Aplicativos com nível gratuito têm taxas de instalação de 3 a 5 vezes mais altas do que aplicativos somente pagos. Os níveis gratuitos criam um funil de conversão: instalações gratuitas do comerciante → valor das experiências → atualizações para recursos avançados. Projete seu nível gratuito para ser genuinamente útil, mas limitado de uma forma que torne a atualização natural (limites de uso, portas de recursos, limites de contagem de comerciantes).

Práticas recomendadas para páginas de preços:

• Mostre todos os planos com uma tabela clara de comparação de recursos
• Destaque o plano recomendado (a maioria dos aplicativos torna a camada intermediária "Popular")
• Incluir uma garantia de devolução do dinheiro se oferecer planos pagos
• Use o preço mensal como exibição principal, mesmo que o anual esteja disponível
• Nunca exiba preços que sejam diferentes daqueles cobrados pela API Billing — a rejeição da revisão é automática

Implementação da API Shopify Billing:

Todas as cobranças devem passar pela API Billing da Shopify. Links de pagamento fora da plataforma (Stripe, PayPal) são proibidos para recursos do aplicativo. Você pode ter pagamentos fora da plataforma para serviços profissionais, mas os recursos do aplicativo devem ser restritos aos planos da API de faturamento.

// billing configuration example for tiered pricing
billing: {
  "Starter": {
    amount: 9.99,
    currencyCode: "USD",
    interval: BillingInterval.Every30Days,
    trialDays: 14,
  },
  "Professional": {
    amount: 29.99,
    currencyCode: "USD",
    interval: BillingInterval.Every30Days,
    trialDays: 14,
  },
  "Enterprise": {
    amount: 99.99,
    currencyCode: "USD",
    interval: BillingInterval.Every30Days,
  }
}

---

O processo de envio de revisão

Lista de verificação de pré-envio:

• [] O aplicativo é instalado de forma limpa em uma nova loja de desenvolvimento
• [] O fluxo OAuth é concluído sem erros
• [] Todos os webhooks do GDPR retornam 200 e processam corretamente
• [] O aplicativo é desinstalado de forma limpa (sessão excluída, sem dados órfãos)
• [] O fluxo de integração orienta novos usuários durante a configuração sem ajuda externa
• [] Todos os componentes Polaris usados para UI incorporada
• [] O aplicativo carrega em menos de 3 segundos em uma conexão acelerada
• [] O URL da política de privacidade está ativo e preciso
• [] As capturas de tela da lista de aplicativos mostram a interface real do aplicativo
• A página de preços está completa e corresponde à configuração da API Billing
• [] Nenhum erro de console durante a operação normal do aplicativo
• [] Limitação de taxa tratada normalmente
• [] Teste em vários navegadores (Chrome, Firefox, Safari, Edge)

Enviando para revisão:

No Painel do Parceiro, navegue até seu aplicativo > Distribuição > Enviar para revisão. Fornecer:

1. Instruções de teste: etapas exatas para a equipe de revisão instalar e usar cada recurso
2. Teste credenciais: detalhes de login para quaisquer integrações de terceiros às quais seu aplicativo se conecta
3. Vídeo passo a passo (opcional, mas recomendado para aplicativos complexos): demonstração de 2 a 5 minutos
4. Notas do changelog (para atualizações): o que mudou e por quê

Após envio:

• A revisão começa dentro de 3 dias úteis após o envio
• O feedback da revisão inicial normalmente chega dentro de 10 a 15 dias úteis
• Se rejeitado, você receberá feedback específico – resolva todos os pontos antes de reenviar
• A fila de reenvio é mais rápida (normalmente de 5 a 7 dias úteis)

---

Estratégias de crescimento pós-lançamento

A aprovação é o primeiro dia, não a linha de chegada. O crescimento sustentado da App Store requer gerenciamento ativo.

Geração de comentários:

Aplicativos com menos de 10 avaliações têm taxas de conversão significativamente mais baixas do que aplicativos com mais de 50 avaliações. Implemente uma solicitação de revisão no aplicativo depois que um comerciante atingir um marco significativo (primeiros 100 e-mails enviados, primeiro carrinho recuperado, primeiro pedido sincronizado). Use o fluxo de solicitação de revisão nativo do Shopify:

// Trigger in-app review prompt via App Bridge
import { Modal, TitleBar } from "@shopify/app-bridge/actions";

// Display after user achieves milestone
const modal = Modal.create(app, {
  title: "Leave a review",
  url: `https://apps.shopify.com/your-app/reviews`,
});
modal.dispatch(Modal.Action.OPEN);

Cadência de lançamento de recursos:

Os aplicativos que lançam atualizações frequentemente têm classificação mais elevada no filtro "Novos e atualizados" do Shopify e demonstram manutenção ativa - um sinal de compra importante para os comerciantes. Procure fazer pelo menos uma atualização significativa a cada 4-6 semanas.

Qualidade de suporte:

Os monitores do Shopify oferecem suporte a tempos de resposta e taxas de resolução. Aplicativos com tempos de resposta de suporte superiores a 48 horas apresentam degradação na pontuação da avaliação. Use a caixa de entrada de suporte integrada da Shopify (acessível no Painel do Parceiro) para suporte de nível 1, com escalonamento para e-mail/Slack para problemas complexos.

Otimização da App Store (ASO):

Acompanhe mensalmente suas classificações de palavras-chave na pesquisa da App Store. Use a análise do Partner Dashboard para identificar quais termos de pesquisa geram impressões e instalações. Faça testes A/B no título e slogan da listagem de seu aplicativo – até mesmo pequenas melhorias na taxa de conversão aumentam significativamente em escala.

---

Perguntas frequentes

Quanto tempo leva a análise da App Store da Shopify?

As revisões iniciais normalmente levam de 10 a 15 dias úteis (2 a 3 semanas). Os reenvios após abordar o feedback de rejeição levam de 5 a 7 dias úteis. Aplicativos complexos com integrações de terceiros ou escopos de permissão incomuns podem levar mais tempo, pois os revisores precisam de mais tempo para verificar a funcionalidade. Planeje seu cronograma de lançamento com um intervalo de 8 semanas desde o envio até a disponibilidade pública: 2 semanas para a primeira revisão, 2 semanas para abordar feedback, 1 semana para revisão de reenvio e 3 semanas de intervalo para problemas inesperados.

Quais são os motivos mais comuns para rejeição da App Store?

Os cinco motivos de rejeição mais comuns são: (1) Padrões de design Polaris não seguidos em seções incorporadas, (2) webhooks GDPR não implementados corretamente, (3) Solicitações excessivas de escopo de API não justificadas pela funcionalidade do aplicativo, (4) O fluxo de integração requer documentação externa para ser concluído, (5) A estrutura de preços inclui opções de pagamento fora da plataforma para recursos no aplicativo. Aborde todos os cinco de forma proativa antes de enviar para reduzir significativamente a probabilidade de rejeição.

Posso listar meu aplicativo como gratuito e adicionar planos pagos posteriormente?

Sim, e esta é uma estratégia recomendada. Lance gratuitamente para aumentar o volume inicial de instalações e análises e, em seguida, introduza planos pagos quando tiver mais de 50 comerciantes ativos e uma classificação de mais de 4 estrelas. Use os recursos de direitos adquiridos da API Billing da Shopify para permitir que os usuários existentes mantenham acesso gratuito, se desejarem. Um lançamento gratuito gera avaliações e provas sociais que melhoram significativamente as taxas de conversão quando planos pagos são lançados.

O que acontece se meu aplicativo violar as políticas após a aprovação?

A Shopify monitora os apps publicados quanto à conformidade com as políticas. As violações podem resultar em: aviso com prazo de correção necessário, suspensão da App Store (as instalações existentes continuam, mas nenhuma instalação nova) ou remoção da App Store (todas as instalações perdem o acesso). Violações comuns pós-aprovação incluem: codificação de credenciais de API descoberta por meio de auditorias de segurança, links de pagamento fora da plataforma encontrados na interface do usuário do aplicativo e violações de retenção de dados (armazenamento de dados do comerciante após a desinstalação).

Qual ​​é a importância da classificação do aplicativo em termos de capacidade de descoberta?

A classificação é um dos fatores mais importantes no algoritmo de classificação da App Store da Shopify. Aplicativos abaixo de 4.0 são significativamente suprimidos nos resultados de pesquisa e na navegação por categoria. Aplicativos com classificações de 4,7+ aparecem nas seções selecionadas de "Principais escolhas". Monitore ativamente suas avaliações, responda às avaliações negativas de maneira profissional e com soluções e implemente um fluxo sistemático de solicitação de revisão para manter uma classificação saudável ao longo do tempo.

---

Próximas etapas

Construir um aplicativo que passe na revisão do Shopify e cresça para um MRR sustentável requer experiência nos padrões técnicos do Shopify, otimização de listagem da App Store e estratégia de aquisição de comerciantes.

Os serviços de desenvolvimento de aplicativos Shopify da ECOSIRE cobrem a jornada completa desde a arquitetura até a aprovação da App Store: desenvolvimento técnico, preparação de revisão, otimização de listagem e suporte de crescimento pós-lançamento. Nossos aplicativos têm uma taxa de aprovação de 92% no primeiro envio.

Comece a construir seu aplicativo Shopify com ECOSIRE — fale com nossa equipe de desenvolvimento sobre o conceito de seu aplicativo.