> ## 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 Configurar PopUps Personalizados

> ℹ️ **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 controle total sobre onde e como seu popup aparece? 🛠️

PopUps personalizados são construídos para casos de uso avançados. Por omissão **colocação manual**, o que significa que você decide exatamente onde o popup vive em seu tema — além de ter acesso a **CSS personalizado** campo e a **botão de ação flutuante** para máxima flexibilidade.

Este guia orienta você através de toda a configuração para que você possa lançar seu primeiro PopUp personalizado em minutos.

---

# **✅ Antes de começar — habilite o aplicativo para incorporar**

Para que qualquer 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**

ℹ️ Sem este passo, seu popup não renderizará na frente da loja mesmo após a publicação.

---

# **⚙️ Passo 1 — Criar uma Nova Mensagem Personalizada**

Abrir o **Hoppy PopUps** app.

Depois:

→ Clique **Criar um Novo PopUp**

→ Selecionar **PopUp Personalizado** da lista de tipos de contexto.

A página de configuração será aberta automaticamente com **colocação manual** seleccionado por omissão.

---

# **📝 Passo 2 — Configurar o Conteúdo**

Depois de abrir a página de configuração, você vai pousar dentro do **Conteúdo** tab.

Esta seção controla o que seus visitantes veem e como eles interagem com o popup.

---

## **🏷️ Nome da janela**

Este campo é utilizado apenas para fins internos. Os clientes nunca verão este nome.

Você pode usar qualquer nome reconhecível como:

*   Anúncio Personalizado
*   Banner Temático
*   Popup Personalizado do Desenvolvedor
*   Promo Hardcoded

💡 Usar a nomenclatura interna adequada torna mais fácil identificar configurações mais tarde, especialmente se sua loja executar várias campanhas.

---

## **💬 & Descrição do Título**

Estes aparecem no topo do seu popup e devem comunicar claramente a sua mensagem.

### **Exemplo**

*   **Título:** "Anúncio Especial"
*   **Descrição:** "Confira nossa última coleção"

Você pode personalizar estes para corresponder à sua voz de campanha.

---

## **📧 Coleção de e- mail e telefone**

Escolha os campos a mostrar no seu popup:

*   **Mostrar o campo de recolha de e- mails** — captura e-mails de visitantes
*   **Mostrar campo de número de telefone** — capta números de telefone com selecção de código de país

Você pode mostrar ambos, apenas um, ou nenhum dos dois, se você estiver apenas exibindo um anúncio.

---

## **🔗 Link do Botão**

Se você não estiver coletando e-mails ou números de telefone, o popup se torna um simples botão call-to-action. Definir a **Ligação** para a página que você quer que os visitantes visitem — por exemplo, uma página de coleção, página de produto ou URL externa.

---

## **⚙️ Configuração Adicional do Cupom da Colecção**

Esta seção lhe dá controle adicional sobre como as informações do visitante são coletadas e como os descontos são apresentados dentro do popup.

---

### **📩 Substituição do Campo de Colecção de E- mail**

Personalize o texto do placeholder mostrado dentro do campo de entrada de e- mail.

### **Exemplo**

*   "Entra no teu email"
*   "O teu melhor endereço de e-mail"

Isso ajuda a orientar os visitantes sobre quais informações devem inserir.

---

### **❌ Mensagem de Erro de E- mail**

Defina a mensagem de validação mostrada quando um visitante entra em um endereço de e- mail inválido.

### **Exemplo**

*   "Introduza um endereço de e-mail válido"

Isto aparece automaticamente se o formato de e- mail introduzido estiver incorreto.

---

### **📱 Código padrão do país**

Escolha o código padrão do país para o campo de número de telefone.

### **Exemplo**

*   Estados Unidos (+1)
*   Reino Unido (+44)
*   Índia (+91)

Os visitantes ainda podem mudar o país manualmente, a menos que restrito.

---

### **📞 Número de telefone**

Personalize o texto do placeholder mostrado dentro do campo de número de telefone.

### **Exemplo**

*   "Digite o seu número de telefone"
*   Número móvel

Isso melhora a clareza e incentiva a formatação adequada.

---

### **⚠️ Mensagem de Erro do Número de Telefone**

Configure a mensagem exibida quando for inserido um número de telefone inválido.

### **Exemplo**

*   "Introduza um número de telefone válido"

Isso ajuda os visitantes a entender por que a submissão falhou.

---

### **🔘 Texto do Botão**

Personalize o texto do botão chamada a ação mostrado dentro da janela.

### **Exemplo**

*   "Compra Agora"
*   "Claim Discount"
*   "Desbloquear a Oferta"

Usar texto orientado para ação pode melhorar conversões.

---

### **🏷️ Mostrar o Código de Cupão**

Escolha se o código de cupom deve aparecer dentro do popup após a captura de email bem-sucedida.

Opções disponíveis:

*   **Sim.** — apresenta o código do cupão aos visitantes
*   **Não** — esconde a secção do código do cupão

Isso é útil se os descontos são aplicados automaticamente ou manipulados externamente.

ℹ️ O código do cupom só pode ser mostrado se o email estiver sendo capturado.

---

### **🎟️ Código de Cupão**

ℹ️ Este campo está disponível uma vez **Mostrar o Código de Cupão** é alternado para **SIM**.

Para exibir um código de cupom, você pode:

1.  Selecione um dos códigos de cupons em que você criou Shopify Admin → Descontos clicando em Selecionar / Mudar Desconto.
2.  Você pode criar um novo clicando em **Criar um novo desconto**.

### **Exemplo**

*   SAVE10
*   Bem-vindo20
*   COUPON123

### **💸 Aplicação de Desconto**

Esta opção controla como o desconto é aplicado. Tem duas opções:

1.  **O cliente terá que aplicar o desconto manualmente** — o cliente terá de indicar o código do cupão durante o checkout para receber o desconto.
2.  **Aplicar o Desconto automaticamente** — o desconto será aplicado automaticamente durante o check-out sem que o cliente tenha de introduzir o código do cupão.

⚠️ **Importante:**

*   Nosso aplicativo não cria ou gerencia códigos/descontos de cupom. Você deve criá-los em Shopify Admin → Descontos antes de usá-los no popup.

---

### **☑️ Adicionar uma opção de seleção**

Escolha se deve mostrar uma opção adicional dentro da janela.

Isto pode ser utilizado para:

*   Autorização de comercialização
*   Autorização SMS
*   Subscrições da Newsletter
*   Reconhecimento dos termos

Opções disponíveis:

*   **Sim.** — mostra a caixa de verificação
*   **Não** — esconde a caixa de verificação

---

### **❎ Fechar Ícone**

Activar ou desactivar o ícone de fecho mostrado na janela.

*   **Activado** — os visitantes podem fechar manualmente o popup
*   **Desactivado** — remove o ícone de perto do popup

Isso ajuda a controlar o quanto a experiência popup deve ser descartável.

---

## **✉️ Mensagens de Sucesso**

Depois de um visitante enviar seus detalhes, aparece uma mensagem de sucesso.

*   **Mensagem de Sucesso:** "Bem-vindo à nossa loja!"

Você também pode adicionar uma descrição abaixo da mensagem com os próximos passos ou instruções.

---

## **🖱️ Comportamento do Botão de Clique**

ℹ️ Esta opção só está disponível quando "Mostrar campo de e-mail" e "Mostrar campo de número de telefone" não estiverem assinalados.

Ele permite que você controle o que acontece quando um visitante clica no botão CTA dentro do popup. Trata de um dos seguintes elementos:

1.  **Fechar o Popup** — o popup fechará
2.  **Revele o Código dos Cupões** — o código do cupom será revelado ao visitante, mas você terá configurado o Código do Cupom como descrito acima na seção "Mostrar Código do Cupom".
3.  **Redirecionar para a Ligação** — selecionando isso lhe daria um campo de entrada chamado "Link" onde você pode especificar o URL para o qual o visitante será redirecionado

---

## **🔄 Botão de ação flutuante**

Mesmo com colocação manual, você pode adicionar um **Botão de ação flutuante** que permanece visível na página para que os visitantes possam reabrir o popup após fechá-lo.

Escolha uma posição:

*   **Inferior direito**
*   **Fundo esquerdo**
*   **Ecrã à direita**
*   **Tela à esquerda**

Em seguida, digite o **Texto do Botão** — por exemplo, "Oferta aberta", "Get Discount" ou "Learn More".

Para desativar completamente o botão flutuante, selecione **Desactivar o botão de acção flutuante**.

---

# **🎨 Etapa 3 — Aplicar CSS personalizado (Opcional)**

Mudar para o **Desenho** aba para acessar o **CSS Personalizado** secção.

Aqui é onde o PopUps Personalizado realmente brilha. Você pode escrever seu próprio CSS para substituir qualquer estilo padrão.

---

## **📝 Modelo CSS**

O aplicativo fornece um modelo pronto com seletores comuns:

.futureblink-popup {  
/\* Recipiente de contexto principal \*/  
}  
.futureblink-popup . title {  
/\* Título da janela \*/  
}  
.futureblink-popup.mobile  
/\* Substituição do título móvel \*/  
}  
.futureblink-popup .description {  
/\* Descrição instantânea \*/  
}  
.futureblink-popup.mobile .description {  
/\* Sobreposição da descrição móvel \*/  
}  
.futureblink-popup .cta-botton {  
/\* Botão de chamada à acção \*/  
}  
.futureblink-popup.mobile .cta-button {  
/\* Sobreposição do botão móvel \*/  
}  
.futureblink-popup .close-btn {  
/\* Fechar ícone \*/  
}  
.futureblink-popup.mobile .close-btn {  
/\* Ativação do ícone de fechamento móvel \*/  
}

Colar seu CSS personalizado no campo e clique **Aplicar**.

---

## **⚠️ Notas Importantes**

*   CSS personalizado substitui todas as outras configurações de design - usá-lo quando você precisa de controle perfeito de pixels
*   Selectores móveis específicos permitem que você estilo diferente para usuários de telefone
*   Clique **Reiniciar** para restaurar o modelo CSS padrão a qualquer momento

---

# **🖱️ Passo 4 — Definir as regras de desencadeamento e exibição**

Mover para o **Colocação/Targeting** aba para controlar quando e onde seu PopUp Personalizado aparece.

Como PopUps personalizados usam a colocação manual, a maioria das configurações de gatilho padrão não se aplicam da mesma forma. No entanto, você ainda pode configurar:

*   **Frequência de exibição** — Mostrar sempre, uma vez por visita, ou limitar com uma refrigeração
*   **Alvo do Cliente** — Status de login, etiquetas de cliente, vida útil
*   **Geolocalização** — Todos os países mundiais ou específicos
*   **Agendamento** — Datas de início e de termo facultativas

Para explicações profundas de cada opção de segmentação, consulte a documentação de Segmentação Avançada dedicada.

---

# **✅ Passo 5 — Salvar e Publicar**

Depois de tudo parecer bom:

1.  Clique **Gravar** para guardar a sua configuração
2.  Clique **Publicar** para fazer o popup ao vivo em sua loja

⚠️ **Salvar sozinho não torna o popup visível para os clientes.** Tem de publicá-lo.

⚠️ **Para colocação manual:** Lembre-se também de adicionar o trecho de código ao seu tema — publicar sozinho não colocará o popup automaticamente.

Se o aplicativo incorporado ainda não está habilitado, um banner irá lembrá-lo de ativá-lo em seu Shopify Editor de temas.

---

# **🎉 Resultado Final**

Uma vez configurado com sucesso:

✅ Seu popup aparece exatamente onde você o colocou em seu tema  
✅ CSS personalizado dá-lhe controle visual completo  
✅ Um botão de ação flutuante mantém o popup acessível (se ativado)  
✅ Seu popup respeita regras de segmentação, agendamento e configurações do dispositivo  
✅ Os visitantes interagem com uma experiência totalmente personalizada

Seu PopUp personalizado é agora ao vivo e exclusivamente seu 🚀

---