> ## 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 executar ofertas de Upsell específicas da região

> ℹ️ **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.

Quer mostrar diferentes ofertas de upsell para clientes em diferentes países? 🌎

Isso é exatamente o que **Objectivo da geolocalização** em Hoppy Upsell & Cross Sell foi concebido para o efeito.

Com este recurso, você pode:

*   🎯 Mostrar um upsell apenas para clientes que navegam de países específicos
*   🎁 Executar ofertas relevantes para a localização, como um presente gratuito apenas para os clientes dos EUA
*   🚫 Ocultar ofertas em regiões onde não fazem sentido (limites de embarque, preços locais, promoções regionais)

Isso ajuda a manter suas ofertas relevantes — os clientes só veem acordos que realmente se aplicam a eles, o que significa melhores conversões e menos momentos confusos no checkout ✨

---

# **📍 Como Funciona a Meta de Geolocalização**

Cada configuração upsell inclui uma **Objectivo da geolocalização** opção dentro da **Colocação** tabulação com duas opções:

*   **Todo o mundo** → O upsell mostra para todos, em todos os lugares (este é o padrão)
*   **Países específicos** → O upsell só mostra para os compradores que navegam nos países que você seleciona

Na frente da loja, o aplicativo detecta o país do visitante usando ShopifyA detecção integrada do país e verifica-o com a sua lista selecionada antes de mostrar o upsell.

ℹ️ O alvo trabalha no **nível de país**. A seleção de estados, províncias ou cidades individuais dentro de um país não é apoiada.

---

# **🛠️ Configuração de Exemplo Usada nesta Documentação**

Neste guia, vamos configurar a seguinte campanha:

*   🎁 A **oferta de presente gratuita** (um produto presente de $0) mostrado no **Página do Carrinho**
*   🇺🇸 Visível **apenas para os clientes que navegam dos Estados Unidos**

Os mesmos passos funcionam para qualquer tipo de colocação (Página do Produto, Página do Carrinho, Gaveta de Carrinhos ou Posição Personalizada) e para qualquer oferta — basta trocar em seus próprios produtos e países ⚙️

---

# **✅ Antes de começar**

Certifique-se de que o seguinte está pronto:

*   A **Upsell Cross-Sell Slider** app embed está habilitado no seu tema (**Shopify Admin → Loja online → Temas → Editar tema → App Incorpora → Alternar para ON → Salvar**)
*   O produto que você deseja oferecer já existe em sua loja (para um presente gratuito, crie um produto com preço **$0** e certifique-se de que está em estoque)

💡 Se você já criou o upsell que você quer restringir, você pode pular diretamente para **Passo 3** e apenas atualizar o seu alvo Geolocalização.

---

# **⚙️ Passo 1 — Criar uma Nova Upsell**

Abrir o **Hoppy Upsell & Cross Sell** app.

Depois:

→ Clique **Criar um novo upsell**

→ Selecione a colocação onde a oferta deve aparecer — neste exemplo, **Página do Carrinho**

Uma vez selecionada, a página de configuração abre automaticamente com três abas: **Conteúdo**, **Desenho**, e **Colocação**.

---

# **🎯 Passo 2 — Crie a Oferta na Página Conteúdo**

Dentro da **Conteúdo** tab, configure o que os clientes irão realmente ver:

*   **Upsell Name** → Um nome interno só você pode ver, por exemplo. `US Free Gift – Cart Page` 💡 Nomeação clara torna as campanhas específicas da região muito mais fáceis de gerenciar quando você executa várias delas.
*   **Selecione produtos upsell** → Escolha **Upsell Produtos Específicos**, então clique **Selecionar produtos** e escolher o seu produto de presente
*   **Upsell Title** → Os clientes do título ver, por exemplo. `You've unlocked a free gift! 🎁`
*   **Texto do Botão (Antes de adicionar ao carrinho)** → Algo orientado para a ação como `Claim Free Gift`

Você pode ajustar o olhar e sentir no **Desenho** tab se quiser — consulte Design & Styling para mais detalhes. Os padrões funcionam bem para começar.

---

# **🌍 Etapa 3 — Restrinja a oferta a países específicos**

Agora a parte importante. Abrir o **Colocação** aba e rolagem para o **Objectivo da geolocalização** Cartão.

Depois:

→ Selecione o **Países específicos** botão de rádio

→ Clique **Selecionar países** para abrir a janela de seleção do país

Dentro do popup você pode:

*   🔍 **Procurar** para um país por nome
*   ☑️ **Verificar** os países que você deseja – cada um está listado como código de país + nome, então para este exemplo selecione **Estados Unidos**
*   Utilização **Selecionar Tudo** para verificar ou desmarcar rapidamente toda a lista

Clique **Selecionar** no fundo do popup (ao lado do **Seleccionado: N** Contador) para confirmar e fechar. Seus países escolhidos agora aparecem como uma lista dentro do **Objectivo da geolocalização** cartão, assim você pode verificar novamente de uma olhada.

⚠️ Se você escolher **Países específicos** mas não selecione pelo menos um país, você verá um **“Selecionar pelo menos um país.”** erro ao gravar. Certifique-se sempre de que pelo menos um país é verificado.

---

# **💾 Passo 4 — Salvar e Publicar**

Quando tudo parece bem.

→ Clique **Gravar** na barra de gravação no topo da página

→ Clique **Publicar** para fazer o upsell viver em sua loja

Sua oferta específica de região agora está ativa 🎉

---

# **🧪 Testando sua oferta específica da região**

A geolocalização se comporta de forma diferente da maioria das configurações, portanto, tenha em mente esses pontos ao testar:

*   **A pré-visualização no aplicativo não reflete a localização.** A visualização Desktop/Mobile ao lado da página de configuração mostra seu design e conteúdo, mas não simula a detecção de país. Não se preocupe se a oferta aparecer lá, independentemente do seu alvo.
*   **Teste na loja ao vivo.** Abra sua loja como um cliente faria e verifique se o upsell aparece com base em sua localização.
*   **Use uma VPN para testar outros países.** Uma vez que o aplicativo detecta o país do visitante automaticamente, um conjunto VPN para os Estados Unidos permite que você veja a oferta exatamente como um cliente dos EUA faria. Mude a VPN para outro país para confirmar que a oferta permanece escondida lá.
*   **A detecção está em cache por sessão do navegador.** O país detectado é lembrado durante a sessão de tabulação do navegador. Se você mudar os locais VPN durante o teste, feche a aba (ou abra uma nova janela incógnita) para que o país seja detectado novamente.
*   **Shopify a antevisão do tema funciona normalmente.** Você pode testar com segurança dentro do modo de pré-visualização do editor do tema — a detecção de país é feita da mesma forma que na frente da loja ao vivo.

---

# **📌 Notas Importantes**

*   **Geolocalização empilha com suas outras regras de direcionamento.** O upsell só aparece quando _tudo_ Condições de passagem — regras de página, condições do cliente, programação, _e_ Localização. Para uma análise completa das restantes opções na aba Colocação (a página inclui/exclui regras, condições de exibição do cliente, tempo no local e muito mais), consulte 🎯 Opções de Alvo Avançadas para Upsell & Cross Sell.
*   **Mudar de volta para todo o mundo limpa sua lista de país.** Se você mudar a configuração de **Países específicos** voltar para **Todo o mundo**, os países selecionados são removidos. Você precisará selecioná-los novamente se você reativar o direcionamento específico.
*   **Executando a mesma oferta em várias regiões?** Criar um upsell separado para cada região (por exemplo, um para os EUA, um para o Canadá) e dar a cada um um um nome interno claro. Isso também permite que você personalize o título, produtos e mensagens por região.
*   **Se seu upsell não está mostrando em tudo,** O alvo de localização é apenas uma das várias causas possíveis – ver Upsell & Cross Sell não está a mostrar na minha loja para uma lista completa.

---

# **🎉 Resultado Final**

Sua loja mostra agora uma oferta relevante para localização exatamente onde importa:

*   🇺🇸 Os compradores que navegam a partir do **Estados Unidos** ver a oferta de presente grátis na página do carrinho
*   🌐 Os compradores de todos os outros países não o vêem — nenhuma confusão, nenhuma oferta irrelevante

Upsells específicos da região são uma maneira simples de fazer suas ofertas se sentirem pessoais, respeitar as diferenças de preços e de transporte entre os mercados, e manter cada campanha focada nos clientes que foi construído para 🚀