> ## 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 a detecção de moeda automática funciona > ℹ️ **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. Hoppy Currency Converter pode detectar automaticamente de onde os visitantes estão navegando e exibir preços em sua moeda local. Isso ajuda a criar uma experiência de compras mais localizada, permitindo que os clientes vejam preços familiares sem selecionar manualmente uma moeda do dropdown. A detecção automática de moeda funciona identificando o país do visitante, combinando-o com uma moeda suportada e trocando automaticamente os preços quando possível. Este guia explica como o processo de detecção funciona, quais configurações o controlam e como cada opção afeta a experiência da loja. --- # **⚙️ Antes de começar** Para configurar a detecção automática da moeda: ➡️ Abrir o **Hoppy Currency Converter** app. ➡️ Navegar para **Configurações → Geral**. Todas as configurações de detecção de moeda podem ser encontradas dentro da **Geral** secção. --- # **🔄 Interruptor de Moeda Automático** A **Interruptor de Moeda Automático** a definição controla se o aplicativo detecta e aplica automaticamente moedas locais. ### **O Que Faz** Quando habilitado, o aplicativo tenta detectar o país do visitante e mudar os preços para a moeda correspondente automaticamente. ### **Estado Padrão** ✅ Activado --- # **✅ Quando a mudança de moeda automática está habilitada** Quando o Auto Money Switch é ativado, o aplicativo segue o processo abaixo. ### **Como Funciona** 1. O país do visitante é detectado. 2. O país corresponde a uma moeda. 3. A moeda é verificada em sua lista de moedas selecionadas. 4. Se existir uma correspondência, os preços convertem-se automaticamente. 5. A moeda detectada aparece no seletor de moeda como **Localização Automática**. ### **Exemplo** Um visitante da França abre a loja: País Detectado → FR → Jogo de moeda → EUR → Preços exibidos em EUR O visitante vê imediatamente os preços em Euros sem qualquer seleção manual. --- # **🗺️ Como funciona a detecção do país** A aplicação utiliza ShopifyO sistema de detecção de contexto de navegação nativo para identificar a localização do visitante. Shopify fornece informações sobre o país do visitante através de: /browsing context suggestions.json Este é o mesmo sistema de contexto de navegação usado por Shopify Mercados e ShopifyOs recursos de geolocalização. Uma vez detectada, as informações do país são armazenadas temporariamente durante a sessão de visitantes para melhorar o desempenho. --- # **💱 Como os países são mapeados para moedas** Após identificar o país do visitante, o aplicativo determina qual moeda deve ser exibida. Há dois métodos que combinam. --- ## **Método 1 — Mapeamento por país do euro** Muitos países europeus utilizam o euro, embora os seus códigos de países sejam diferentes do código monetário. O aplicativo mapeia automaticamente esses países para **EUR**. ### **Exemplos** * França (FR) → EUR * Alemanha (DE) → EUR * Itália (IT) → EUR * Espanha (ES) → EUR * Países Baixos (NL) → EUR Isto garante que os visitantes dos países da zona euro recebam automaticamente a moeda correcta. --- ## **Método 2 — Correspondência de moeda normal** Para países não pertencentes ao euro, a aplicação compara o código do país com os códigos monetários disponíveis. ### **Exemplos** EUA → USD GB → GBP CA → CAD IN → INR Se existir uma correspondência suportada, os preços mudam automaticamente para essa moeda. Se nenhuma correspondência estiver disponível, o aplicativo cai de volta para a moeda padrão da loja. --- # **🚫 Restringir a mudança de moeda automática** A **Restringir a mudança de moeda automática** a configuração permite- lhe limitar as moedas elegíveis para comutação automática. ### **O Que Faz** Quando ativado: * A troca automática só funciona para moedas incluídas na sua lista de moedas seleccionadas. * Visitantes não suportados vêem a moeda padrão da loja. * A **Localização Automática** a opção está escondida do seletor de moeda. ### **Por que usá - lo?** Esta configuração é útil quando: * Você só apoia regiões específicas. * Você quer um controle mais apertado sobre o qual os visitantes recebem conversão monetária automática. * Você quer que as regiões não suportadas permaneçam na moeda da loja. --- # **🔒 Quando o interruptor de moeda automática é desativado** Quando o Auto Money Switch é desligado, o aplicativo para de detectar locais de visitantes inteiramente. Em vez disso, depende do **Moeda de Conversão Predefinida** Preparar. --- ## **Moeda de Conversão Predefinida** Esta configuração só fica disponível quando o Auto Money Switch estiver desativado. ### **O Que Faz** Obriga todos os visitantes a ver os preços em uma moeda específica, independentemente da localização. ### **Opções Disponíveis** * Nenhum (Utiliza a Moeda da Loja) * Qualquer moeda suportada ### **Exemplo** Se você selecionar: Moeda de conversão padrão → EUR Cada visitante vê os preços em euros, independentemente do país. Isto é útil quando se vende principalmente dentro de uma região e se mantém um preço consistente. --- # **👤 O que os visitantes vêem na frente da loja** A experiência do cliente muda dependendo se o Auto Money Switch está habilitado. --- ## **Quando a mudança de moeda automática está habilitada** Os visitantes verão: * Preços convertidos automaticamente com base na localização. * An **Localização Automática** opção de moeda no seletor. * A capacidade de mudar manualmente as moedas, se desejar. ### **Exemplo** Localização do visitante → Canadá → Moeda exibida → CAD --- ## **Quando o interruptor de moeda automática é desativado** Os visitantes verão: * A Moeda de Conversão Padrão. * A moeda de armazenamento se nenhuma moeda padrão estiver configurada. * Seleção de moeda manual através do dropdown. ### **Exemplo** Interruptor de moeda automática → OFF → Moeda padrão → EUR → Preços exibidos → EUR --- # **⚠️ Notas Importantes** ### **Importam Moedas Seleccionadas** Auto-detecção só funciona para moedas incluídas no seu **Selecionar moedas** Lista. Se a moeda detectada não estiver disponível, o aplicativo cai de volta para a moeda de armazenamento ou a moeda padrão configurada. --- ### **Memória da Sessão** Se um visitante selecionar manualmente uma moeda, o aplicativo se lembra dessa preferência pela duração da sessão de navegação. Páginas subsequentes continuam exibindo a moeda selecionada até que seja alterada novamente. --- ### **Shopify Compatibilidade dos mercados** Se Shopify Mercados já está gerenciando conversão de moeda, o aplicativo ajusta automaticamente seu comportamento para evitar conflitos com ShopifyÉ o tratamento da moeda nativa. --- ### **Precisão de detecção** Detecção do país depende ShopifyDados de contexto de navegação. Em situações raras, VPNs, serviços proxy, ferramentas de privacidade ou configurações de rede incomuns podem afetar o local detectado. --- # **🛠️ Casos de Uso Comum** ## **Loja global com preços localizados** Habilitar: Interruptor de moeda automática → Ligado Selecione todas as moedas suportadas. Os visitantes vêem automaticamente os preços em sua moeda local. --- ## **Loja regional com suporte limitado** Habilitar: Auto câmbio interruptor → ON → Restrição Auto câmbio interruptor → ON Apenas as regiões apoiadas recebem comutação automática de moeda. Todos os outros visitantes permanecem na moeda da loja. --- ## **Loja de Moeda Única** Configurar: Troca de moeda automática → OFF → Moeda de conversão padrão → Moeda desejada Todos os visitantes vêem a mesma moeda, independentemente da localização. --- # **🎉 Resultado Final** ✅ Os visitantes podem ver automaticamente os preços em sua moeda local. ✅ A troca de moeda permanece disponível através do seletor quando necessário. ✅ Configurações de restrição fornecem controle sobre quais regiões recebem conversão automática. ✅ A lógica de retrocesso garante que os preços permaneçam estáveis quando uma moeda não pode ser encontrada. ✅ Clientes internacionais recebem uma experiência de loja mais localizada e familiar. Compreender como funciona a detecção automática de moeda faz com que seja mais fácil escolher entre troca automática de moeda, localização restrita ou uma estratégia de armazenamento de moeda única.