> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.hoppyapps.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 🧪 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. 🌍