Suporte

Requisitos

• Um Mac com macOS 12 ou posterior.
• O app está disponível em inglês, chinês simplificado, chinês tradicional, japonês, coreano, alemão, francês, espanhol e português do Brasil. Ele acompanha o idioma do Mac; para mudar, abra “Ajustes → Geral”.
• Para publicar na App Store: uma assinatura do Apple Developer Program e uma chave de API do App Store Connect com acesso de Gerente de apps.
• Opcional: uma conta do Apple Ads (para consultar a popularidade das buscas) e sua própria chave de modelo de IA (para os recursos de IA).

Como criar uma chave de API do App Store Connect

A primeira configuração leva cerca de dois minutos.

1. Abra App Store Connect → Usuários e acesso → Integrações → API do App Store Connect → Chaves de equipe.
2. Clique em + para gerar uma chave. Dê a ela um nome, como Ranvia, e escolha a função de acesso Gerente de apps. Apenas o titular da conta ou um administrador pode gerar chaves.
3. Baixe AuthKey_XXXXXXXXXX.p8. A Apple permite baixar o arquivo apenas uma vez, então guarde uma cópia de backup.
4. Copie o Issuer ID no topo da página e o Key ID da chave (os 10 caracteres no nome do arquivo).
5. Em Apps → seu app → Informações do app, copie o Apple ID (um número). Esse é o App ID.
6. Em Ranvia, use o guia de configuração inicial ou o cartão App Store Connect em Visão geral: clique em “Importar chave de API…”, escolha o arquivo .p8 e informe os três IDs. O app usa a chave para consultar seu app na Apple uma vez e confirmar que os dados correspondem antes de salvar.

Para ativar os relatórios de Análise de apps (conversão na loja em Status na App Store), é necessária uma chave com a função de Administrador.

O que funciona sem uma chave

• Pesquisa de palavras-chave: sugestões de busca, resultados públicos, dificuldade de posicionamento, concorrentes frequentes, registros de concorrentes e posições diárias, tudo a partir dos dados públicos da Apple.
• Textos da loja, Estúdio de capturas de tela, Prévias do app e Preparação do lançamento, além da exportação de pacotes de conteúdo e capturas de tela.

A publicação, as páginas de produto personalizadas, o Status na App Store e as Classificações e avaliações precisam da chave, pois leem e gravam dados do seu app no App Store Connect. A popularidade no Apple Ads exige um usuário da API do Apple Ads; os recursos de IA exigem sua própria chave de modelo.

Onde os dados ficam e como fazer backup

Todos os projetos ficam armazenados no seu Mac. “Ajustes → Geral → Arquivos do projeto → Mostrar no Finder” abre a pasta de dados.

Para fazer backup ou mudar de Mac: clique em “Exportar pacote de conteúdo…” em Visão geral ou Preparação do lançamento. O pacote contém os textos da loja de todos os idiomas, um CSV de palavras-chave e suas fontes, o projeto com seus recursos originais, uma pasta de metadados para ASC CLI / fastlane e rascunhos das informações de versão, categoria e análise. No outro Mac, abra Ranvia e clique em “Restaurar pacote de conteúdo…”.

Estes itens não fazem parte do pacote e precisam ser preparados novamente no novo Mac:

• Chaves e senha da conta de demonstração: são criptografadas no Mac original e precisam ser importadas novamente.
• Capturas de tela em PNG: exporte pelo estúdio de capturas de tela.
• Gravações de tela das prévias do app: importe novamente.

Assinatura

Pesquisa, edição e exportação são sempre grátis. A gravação no App Store Connect (publicar textos, enviar capturas de tela e responder a avaliações), o assistente de redação com IA, os rascunhos de resposta a avaliações e os fundos com IA exigem Ranvia Pro, uma assinatura mensal ou anual adquirida pela Apple, com teste grátis.

Restaurar compras

Após reinstalar o app ou em outro Mac, inicie sessão na App Store com a mesma Conta Apple e clique em “Restaurar compras” em “Ajustes → Assinatura”.

Cancelar

A Apple gerencia a assinatura. Ela é renovada automaticamente e pode ser cancelada a qualquer momento. Se cancelar durante o teste grátis, não haverá cobrança. No Mac, abra a App Store, clique no seu nome no canto inferior esquerdo, abra Ajustes da Conta e clique em Gerenciar ao lado de Assinaturas, ou acesse apps.apple.com/account/subscriptions. Enquanto a assinatura estiver ativa, “Ajustes → Assinatura” em Ranvia também oferece “Gerenciar assinatura”.

A Apple cuida dos pagamentos e reembolsos. Para solicitar um reembolso, acesse reportaproblem.apple.com.

Contato

Escreva para support@ranvia.app. Para ajudar a entender o problema mais rápido, inclua:

• a versão do macOS e a versão de Ranvia (Ajustes → Geral → Versão);
• o que estava fazendo e o que aconteceu, de preferência com uma captura de tela.

Nunca envie uma chave privada .p8, uma chave de API ou uma senha por e-mail. Nunca pediremos esses dados.

Endereço desta página: https://ranvia.app/pt-br/support