> ## 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).

# O PopUp não está a aparecer na minha loja [Resolvido]

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

O PopUp geralmente começa a funcionar imediatamente após a configuração — mas às vezes uma pequena configuração, regra de visibilidade ou configuração relacionada ao tema podem impedir que ele apareça na frente do store.

A boa notícia é que estas questões são geralmente muito rápidas para corrigir 🚀

Este guia percorre as razões mais comuns pelas quais o PopUp pode não aparecer e como resolver cada passo a passo.

Na maioria dos casos, a questão está relacionada a um dos seguintes:

*   A App Inbed está desabilitada
*   A configuração não foi salva
*   A configuração não foi publicada
*   Configurações de agendamento
*   Restrições de orientação geográfica
*   Restrições de orientação UTM
*   Restrições de direcionamento de clientes
*   Condições de página ou gatilho não satisfeitas
*   Desvio de visibilidade do dispositivo
*   Mostrar limites de frequência
*   Navegador ou cache de armazenamento

Vamos passar por eles um por um 👇

---

# **✅ Passo 1: Verifique se a incorporação da aplicação está habilitada**

Para que o PopUp apareça em seu storefront, o aplicativo embed deve ser ativado dentro de seu Shopify tema.

Ir para:

**Shopify Admin → Canais de Vendas → Loja online → Temas → Editar Tema → App Incorpora**

Depois:

*   Procurar **Hoppy Popups**
*   Alternar **ON**
*   Clique **Gravar**

Dica:  
Se ele já estava habilitado, tente fechar o Editor de Tema e reabri-lo, em seguida, habilite o App Incorporar e clique em Salvar novamente.

---

# **✅ Passo 2: Salvar a Configuração**

Mesmo que seu PopUp pareça totalmente configurado, as alterações não salvas não terão efeito.

Abra sua configuração PopUp → Clique **Gravar**

---

# **✅ Passo 3: Publicar a Configuração**

Os clientes não verão o PopUp até que a configuração seja publicada.

Abra sua configuração PopUp → Clique **Publicar**

Ambas as acções são necessárias.

⚠️ **Salvar sozinho não faz o PopUp viver.**

---

# **✅ Passo 4: Verificar configurações de agendamento**

Às vezes, o PopUp está configurado para aparecer mais tarde ou pode já ter expirado.

Abra sua configuração PopUp → **Colocação/Targeting** tab → **Agendamento**

Em seguida, verifique:

*   **Data de início**
*   **Data de Fim**

Exemplo:  
Se a data de início for amanhã, o PopUp não aparecerá hoje.  
Se a Data de Fim já passou, o PopUp para automaticamente de aparecer.

---

# **✅ Passo 5: Verificar a Meta de Geolocalização**

Se a Meta de Geolocalização for definida para países específicos, o PopUp só aparecerá para visitantes desses locais.

Abra sua configuração PopUp → **Colocação/Targeting** tab → **Meta de Geolocalização**

Em seguida, verifique se o seu país está incluído na lista permitida.

Exemplo:  
Se apenas os Estados Unidos estiverem selecionados e você estiver visitando a Índia, o PopUp não estará visível a menos que você use uma VPN ou ShopifyO recurso de Antevisão.

---

# **✅ Passo 6: Verificar as Fontes UTM permitidas**

O PopUp pode ser configurado para aparecer apenas para visitantes provenientes de fontes de tráfego específicas.

Isso funciona usando parâmetros UTM de plataformas como Facebook, Instagram, Google, TikTok, etc.

Abra sua configuração PopUp → **Colocação/Targeting** tab → **Fontes UTM permitidas**

Em seguida, verifique se existem restrições específicas da fonte.

Exemplo:  
Se apenas o Facebook estiver selecionado, o PopUp aparecerá apenas quando os visitantes chegarem através de links UTM do Facebook. Os visitantes que vêm directamente não o verão.

---

# **👥 Passo 7: Verifique as configurações de destino do cliente**

Se **Alvo do Cliente** está configurado incorretamente, o PopUp pode permanecer oculto para certos visitantes.

Para verificar isto:

→ Abra a configuração PopUp  
→ Navegar para o **Colocação/Targeting** aba  
→ Rolar para o **Alvo do Cliente** secção

Verifique se a configuração está configurada para mostrar o PopUp apenas para:

*   Clientes registados
*   Clientes com etiquetas específicas
*   Clientes com uma vida útil específica

Também verifique se o cliente atual realmente corresponde às condições de segmentação configuradas.

⚠️ Exemplo: Se o PopUp estiver configurado para mostrar apenas para clientes marcados como "VIP", então clientes regulares sem a tag VIP não verão o PopUp.

💡 Para fins de teste, recomenda-se selecionar temporariamente:

→ **Mostrar a todos os clientes**

Isso ajuda a confirmar se as configurações de Alvo do Cliente estão causando o problema de visibilidade.

---

# **✅ Passo 8: Verifique as configurações da página e do gatilho**

Seu PopUp pode estar mirando páginas específicas ou esperando por uma condição de gatilho que não foi cumprida.

Abra sua configuração PopUp → **Colocação/Targeting** aba

Verificar o seguinte:

**Alvo da Página**  
Verifique se o PopUp está configurado para aparecer em:

*   Cada página
*   Apenas na página inicial
*   Páginas específicas do produto ou da colecção
*   Páginas correspondentes a etiquetas de produtos específicas

Se você estiver testando em uma página que não está na lista permitida, o PopUp não aparecerá.

**Condições de desencadeamento**  
Verifique o gatilho selecionado:

*   **Atraso de tempo** — verificar se já passaram segundos suficientes após a página carregada
*   **Rolagem da página** — descer suficientemente para atingir a percentagem exigida
*   **Intenção de saída** — na área de trabalho, mova o mouse para a aba do navegador ou barra de endereço
*   **Adicionar ao carrinho** — adicionar um artigo ao carrinho, ou verificar se o valor do carrinho excede o limiar se essa opção for seleccionada

---

# **✅ Passo 9: Verificar visibilidade do dispositivo**

Seu PopUp pode ser restrito a desktop ou apenas móvel.

Abra sua configuração PopUp → **Desenho** tab → **Visibilidade**

Verificar se está definido como:

*   **Desktop e Mobile**
*   **Apenas área de trabalho**
*   **Apenas Móvel**

Exemplo:  
Se o PopUp estiver configurado para **Apenas área de trabalho**, não aparecerá quando você testar em um dispositivo móvel.

---

# **✅ Passo 10: Verificar frequência de exibição**

Se o PopUp estiver configurado para mostrar apenas uma vez por visita ou tiver um limite de frequência, você pode já tê-lo acionado.

Abra sua configuração PopUp → **Colocação/Targeting** tab → **Configuração da Visualização**

Verificar se está definido como:

*   **Mostrar todas as vezes**
*   **Uma vez de cada vez que alguém visita**
*   **Frequência limite** — com arrefecimento em dias

Se estiver definido para **Uma vez de cada vez que alguém visita**, o PopUp não irá reaparecer até que o visitante abra uma nova sessão de navegação.  
Se estiver definido para **Frequência limite**, o PopUp ficará escondido até o período de resfriamento passar.

💡 O PopUp também pára de mostrar automaticamente após um visitante enviar o formulário.

---

# **✅ Passo 11: Atualizar Difícil Sua Página**

Às vezes Shopify ou seu navegador armazena temporariamente os ativos do storefront.

Uma atualização dura geralmente corrige isso instantaneamente.

### **Janelas**

`Ctrl + Shift + R`

### **Mac**

`Cmd + Shift + R`

Isso força o navegador a recarregar os ativos mais recentes do storefront em vez de usar versões em cache.

---

# **✅ Passo 12: Verificar na Janela Incógnita**

Certas condições de visibilidade podem se comportar de forma diferente para os visitantes que retornam.

Por exemplo:

*   Cache temporário existente
*   Conflitos de sessão de navegador

pode impedir que o PopUp apareça novamente.

Tente:

*   Abrindo sua loja em **Modo Incógnito**
*   Usando outro navegador
*   Ensaio noutro dispositivo

Isso ajuda a confirmar se o problema está relacionado com cache ou sessão.

---

# **✅ Passo 13: Verifique se o tema Styling conflitos**

Em alguns casos, o PopUp está realmente carregando corretamente — mas o estilo do tema pode estar escondendo visualmente.

Isto geralmente acontece devido a:

*   CSS personalizado de outros aplicativos
*   Substituição do tema
*   conflitos de índice z
*   Estilo agressivo de construtores de páginas ou aplicativos de animação

Abrir o **Desenho** aba dentro do aplicativo e alterar temporariamente:

*   Cor de fundo
*   Cor do texto
*   Estilo de borda

Em seguida, salve as alterações e atualize o storefront.

Se as mudanças de estilo ainda não aparecem, seu tema CSS pode estar sobrepondo os estilos PopUp.

Nesse caso, você pode precisar de ajuda de:

*   Seu desenvolvedor
*   Equipe de suporte ao tema

---

# **Ainda não apareceu?**

Se você tentou todos os passos acima e o PopUp ainda não está visível:

1.  Gravar novamente a configuração
2.  Publicar novamente
3.  Ativar a incorporação da aplicação
4.  Teste em uma página de produto ao vivo
5.  Teste em Modo Incógnito

Se o problema continuar, não hesite em contactar-nos diretamente de dentro do Hoppy PopUps app.

Para nos ajudar a solucionar problemas mais rápido, por favor inclua:

*   Guardar o URL
*   Tipo de contexto
*   Imagem da sua configuração
*   URL da página onde o PopUp deverá aparecer
*   Nome do tema

Ficaremos felizes em ajudar 🙌

---