🧪 Como testar a conversão de moeda em sua loja
ℹ️ Note: Este artigo foi traduzido automaticamente utilizando IA e pode conter imprecisões. Se algo parecer errado, entre em contato com nossa equipe de suporte.
Após a instalação Hoppy Currency Converter, é importante verificar que tudo está funcionando corretamente em sua loja.
Testes ajudam a confirmar que:
- O seletor de moeda é visível.
- A mudança de moeda manual funciona corretamente.
- Preços atualizados em toda a loja.
- Auto detecção de moeda comporta-se como esperado.
- Visitantes de diferentes países vêem as moedas corretas.
Este guia percorre o processo de teste recomendado desde a verificação inicial da configuração até o teste de storefront do mundo real.
✅ Antes de começar
Antes de testar, certifique-se de que os seguintes requisitos de configuração já foram completados:
- Hoppy Currency Converter está instalado.
- Status da aplicação está habilitado.
- A Aplicativo Incorporar está habilitado.
- Pelo menos uma moeda foi adicionada.
- Shopify Formato do dinheiro foi configurado corretamente.
⚠️ Se algum destes requisitos estão faltando, o conversor de moeda pode não aparecer na frente da loja.
👀 Passo 1 — Verificar a Visualização In-App
A maneira mais rápida de confirmar sua configuração está funcionando é revisando a pré-visualização dentro do aplicativo.
Como Verificar
➡️ Abrir Hoppy Currency Converter.
➡️ Navegar para Configuração.
➡️ Reveja as pré-visualizações do Desktop e Mobile.
Resultado esperado
O seletor de moeda deve aparecer na posição configurada.
Se o seletor estiver visível na antevisão:
✅ As configurações de design são aplicadas corretamente.
✅ As configurações de colocação estão configuradas corretamente.
Se nada aparecer:
➡️ Verificar Status da aplicação está habilitado.
➡️ Confirmar que pelo menos uma moeda foi selecionada.
🔌 Passo 2 — Verificar se a incorporação da aplicação está habilitada
O Conversor de Moedas não pode aparecer no storefront a menos que o App Inbed esteja habilitado.
Como Verificar
➡️ Abrir Hoppy Currency Converter.
➡️ Localizar o Status da aplicação secção.
➡️ Clique no link Editor de Temas.
Em seguida, navegue para:
Shopify Admin → Loja online → Temas → Personalizar → App Incorpora
Localização: Conversor de moeda
Verificar se a opção está activa.
➡️ Clique Gravar.
Resultado esperado
O Conversor de Moedas fica disponível na frente da loja.
💡 Se a incorporação já estiver ativada, tente desativá-la, salvando, então habilitando-a novamente e salvando novamente.
🛍️ Passo 3 — Verificar o seletor de moeda na frente da loja
Uma vez que o App Embed estiver habilitado, teste o storefront ao vivo.
Como Verificar
➡️ Abre a tua loja.
➡️ Visite uma página com preços visíveis do produto.
Exemplos:
- Páginas de Produtos
- Páginas de Colecção
- Página Pessoal
- Página do Carrinho
Resultado esperado
O seletor de moeda deve aparecer na posição configurada dentro da aplicação.
Se não aparecer imediatamente:
➡️ Realize uma atualização dura.
Janelas
Ctrl + Shift + R
Mac
Cmd + Shift + R
Isso força o navegador a carregar os ativos mais recentes do storefront.
💱 Passo 4 — Comutador de moeda manual de teste
A mudança de moeda manual é a maneira mais rápida de verificar que a conversão de preços está funcionando corretamente.
Como testar
➡️ Clique no seletor de moeda.
➡️ Escolha uma moeda diferente.
➡️ Reveja os preços da loja.
Resultado esperado
Devias ver:
✅ Actualização dos símbolos monetários.
✅ Actualização dos códigos monetários.
✅ Actualização dos preços dos produtos.
✅ Actualização dos preços de recolha.
✅ Actualização dos preços do carrinho.
💡 Teste várias moedas para garantir que as conversões estão se comportando de forma consistente em toda a loja.
🌍 Passo 5 — Teste Auto Detecção de Moeda
Se Interruptor de Moeda Automático está habilitado, o aplicativo tenta detectar a localização do visitante automaticamente.
Existem várias maneiras de testar essa funcionalidade.
Opção A — Usar uma Janela Incógnita
Abra sua frente de loja usando uma nova janela Incognito ou Private Browsing.
Isso cria uma nova sessão sem preferências de moeda salva.
Resultado esperado
O aplicativo deve detectar automaticamente o local do visitante e aplicar a moeda apropriada.
Opção B — Usar uma VPN
Uma VPN permite simular visitantes de diferentes países.
Exemplo
Localização VPN → Alemanha → Moeda Detectada → EUR
Se o EUR existir na sua lista de moedas seleccionadas, os preços devem mudar automaticamente para Euros.
Opção C — Usar o GeoPeeker
GeoPeeker pode ajudar a visualizar como sua loja aparece de diferentes países.
Como testar
➡️ Abre o GeoPeeker.
➡️ Digite seu URL storefront.
➡️ Selecione um país.
➡️ Reveja a moeda exibida.
Resultado esperado
O storefront deve exibir a moeda associada ao país selecionado.
💡 Isso é útil se você não tiver acesso a uma VPN.
🧹 Passo 6 — Limpar os dados da sessão e voltar a testar
O Conversor de Moedas lembra moedas manualmente selecionadas durante a sessão de navegação.
Por causa disso, a detecção automática não pode ser executada novamente até que a sessão seja reiniciada.
Como reiniciar
➡️ Abrir ferramentas de desenvolvimento de navegador.
➡️ Navegar até o Aplicação ou Armazenamento tab.
➡️ Localizar Armazenamento de Sessão.
➡️ Limpar os dados da sessão armazenada.
➡️ Refresque a loja.
Método alternativo
Abra uma nova janela Incognito ou Private Browsing.
Isto cria uma sessão de visitantes completamente nova.
Resultado esperado
A detecção automática da moeda deverá ser executada novamente desde o início.
⚠️ Notas Importantes
Importam Moedas Seleccionadas
Auto- detecção só funciona para moedas que foram adicionadas ao seu Selecionar moedas Lista.
Se a moeda do visitante não estiver disponível, o aplicativo cai de volta para a moeda da loja ou a moeda padrão configurada.
Selecção Manual Sobrepõe a Detecção Automática
Após um visitante selecionar manualmente uma moeda, essa seleção tem prioridade para o restante da sessão.
Para reteste de detecção automática:
➡️ Limpar o armazenamento da sessão.
➡️ Abra uma nova janela Incognito.
A aplicação Incorporar deve permanecer habilitada
Se o seletor desaparecer do storefront inesperadamente, verifique se o App Embed ainda está habilitado.
Esta é a causa mais comum de problemas de visibilidade storefront.
Shopify Compatibilidade dos mercados
Se Shopify Mercados está lidando com conversão de moeda local, o aplicativo ajusta automaticamente seu comportamento para evitar conflitos.
Se o preço parecer diferente do esperado, reveja o seu Shopify Configuração dos mercados também.
Cache de Navegador Pode Atrasar Alterações
Após a atualização das configurações:
➡️ Gravar as alterações.
➡️ Realize uma atualização dura.
Atualizações regulares de página podem continuar carregando ativos em cache storefront.
🎉 Resultado Final
✅ O seletor de moeda aparece corretamente no storefront.
✅ A troca de moeda manual atualiza os preços em toda a loja.
✅ A detecção automática de moeda funciona para países suportados.
✅ O App Inbed está configurado corretamente.
✅ Visitantes de diferentes locais recebem a experiência esperada.
Uma vez que estas verificações foram concluídas com sucesso, seu conversor de moeda está pronto para clientes em todo o mundo. 🌍
Actualizado em: 10/09/2026
Obrigado!