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

# 🎯 Oferta de Pacotes - Opções de Meta Avançadas

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

Nem toda oferta deve ser mostrada a cada visitante, o tempo todo. Às vezes você quer um pacote de negócio que é _Apenas..._ para seus clientes VIP, uma venda flash que funciona apenas neste fim de semana, ou um desconto que só é visível para os compradores em certos países 🌍

Isso é exatamente o que o **& Colocação de Destino** tab in **Hoppy Bundles** é para.

Com as configurações nesta aba, você pode controlar:

*   👤 **Quem?** vê sua oferta (todos os visitantes, clientes logados, etiquetas de clientes específicas ou clientes acima de uma vida útil)
*   🌎 **Onde no mundo** a oferta é mostrada (todos os países ou específicos)
*   □ **Quando** a oferta vai ao vivo e quando pára (data de início/fim & agendamento de hora)
*   📍 **Onde na página** a oferta aparece (posição padrão ou uma posição personalizada)

Este guia percorre todas as opções de segmentação, o que ele faz e como ele muda o que os clientes veem em sua loja ✨

---

# **⚠️ Antes de começar**

Para configurar o alvo:

→ Abra uma Oferta de Pacotes existente → Ou crie uma nova oferta primeiro (Bundle, Volume Discount, BYOB, etc.)

Então abra o **& Colocação de Destino** aba (é a terceira aba, ao lado de _Geral_ e _Desenho_).

ℹ️ As configurações de destino são salvas **por oferta**, para que diferentes ofertas possam ter regras completamente diferentes de segmentação.

---

# **🧠 Entender Como Funciona o Alvo**

Antes de mergulhar em cada configuração, ajuda a saber como Hoppy Bundles decide se deve mostrar uma oferta a um visitante.

Quando uma página de produto carrega em sua frente de loja, o aplicativo executa uma série de verificações **nesta ordem** para cada oferta ativa:

1.  ✅ **Verificação dos produtos** – Esta oferta destina-se ao produto a ser visto?
2.  🌍 **Verificação da geolocalização** - O país do visitante é permitido?
3.  👤 **Verificação do cliente** – O visitante passa as regras de login/tag/spend?
4.  □ **Verificação de agendamento** – A hora atual está dentro da janela de início/fim?

Se **qualquer** check fails → a oferta simplesmente não renderiza na página. O resto da sua página não foi afectado.

💡 Pense em regras de alvo como **filtros empilhados em cima uns dos outros**Um visitante deve passar _cada_ filtro ativo para ver a oferta. Não existe o modo "compatibilizar qualquer regra" — todas as regras habilitadas devem passar juntas.

---

# **📍 Colocação**

*   **O que faz:** Controla onde na página do produto seu widget de oferta aparece.
*   **Opções:**
    *   **Abaixo Adicionar ao Botão do Carrinho (Padrão)** – Hoppy Bundles Coloca automaticamente a oferta sob o botão Adicionar ao Carrinho do seu tema. Não é necessário.
    *   **Personalizado (somente na página do produto)** – Você escolhe a posição exata, usando o **Hoppy Bundles bloco de aplicativos** no editor de tema ou um pequeno trecho de código colocado em qualquer lugar em seu tema.

Quando **Personalizado** é selecionado, aparecem dois itens extras (após salvar a oferta):

*   **Hoppy bundles ID** – o ID único desta oferta, usado pelo bloco de aplicativos no editor do tema.
*   **Hoppy bundles excerto de código** – um excerto pronto para colar como `<div class="futureblink-bundle-block" id=...></div>` que torna a oferta onde quer que a cole.

⚠️ A colocação personalizada só funciona em **páginas do produto** — o trecho não renderiza a oferta em outros tipos de páginas.

💡 Este documento resume apenas a colocação. Para uma caminhada passo a passo completa, consulte o guia dedicado: **Como definir a Oferta de Pacotes para colocação personalizada?**

---

# **👤 Alvo do Cliente**

Esta carta permite- lhe mostrar (ou ocultar) a oferta baseada em **quem é o visitante** - se eles estão logados, quais etiquetas de clientes eles têm, e quanto eles gastaram em sua loja ao longo de sua vida.

## **🔐 Visibilidade (Status de login do cliente)**

*   **O que faz:** Decide se os visitantes precisam de uma conta de cliente para ver a oferta.
*   **Opções:**
    *   **Mostrar a todos os clientes** – Todos vêem a oferta, incluindo hóspedes que não estão conectados.
    *   **Mostrar apenas para clientes logados** - Os hóspedes não vêem nada. A oferta só aparece uma vez que um visitante loga em sua conta de cliente.
*   **Porquê usá- lo:** Perfeito para negócios somente para membros, vantagens de lealdade ou preços de estilo grossista que você não quer que o público em geral veja.

⚠️ Se um visitante não estiver ligado, Hoppy Bundles não pode ler as suas tags ou o tempo de vida gasto — então as regras de tag/spend abaixo só podem ser totalmente avaliadas para **Clientes registados**. Se você confiar em tag ou gastar o alvo, emparelhá-lo com _Mostrar apenas para clientes logados_ dá os resultados mais previsíveis.

---

## **👀 Mostrar a barra para:**

Esta é a tua **inclusão** regra — define que clientes a oferta deve ser apresentada _para_.

### **👥 Todos os Clientes**

*   **O que faz:** Sem filtragem — a oferta mostra a todos (sujeito às outras regras desta página).
*   **Como utilizar:** Deixe isso selecionado, a menos que você queira restringir especificamente o seu público.

### **🏷️ Alvo clientes com base na etiqueta do cliente**

*   **O que faz:** A oferta é mostrada **Apenas** para clientes logados que carregam pelo menos uma das etiquetas que você lista.
*   **Como utilizar:** Digite uma ou mais marcas de clientes, separadas por vírgulas.
    *   Exemplo: `elite, plus` → qualquer cliente marcado `elite` _ou_ `plus` vê a oferta.
*   **Porquê usá- lo:** Execute ofertas exclusivas para VIPs, membros de lealdade, compradores por atacado ou assinantes de lista de e-mail — basta marcar esses clientes Shopify Primeiro.

ℹ️ As etiquetas devem corresponder às etiquetas no perfil do cliente Shopify. Mantenha-os consistentes (por exemplo, sempre minúsculas) para que nada escape devido a um erro de digitação.

### **💰 Clientes-alvo com base na vida útil passada**

*   **O que faz:** A oferta é mostrada **Apenas** para clientes logados cuja **tempo de vida** na sua loja está **maior ou igual a** a quantidade que você entra.
*   **Como utilizar:** Digite um número na **Vida útil** campo (por exemplo: `5000`).
*   **Porquê usá- lo:** Recompense seus maiores gastadores com um melhor pacote de negócio, ou desbloqueie uma oferta "grande gastador" automaticamente uma vez que um cliente cruza um limiar.

---

## **🚫 Ocultar barra de:**

Esta é a tua **exclusão** regra — define que clientes a oferta deve ser escondida _de_, mesmo que tenham passado a regra "Show bar to" acima.

### **🙌 Ninguém - use as configurações de cima**

*   **O que faz:** Sem exclusões. Apenas a regra "Mostrar barra para" decide a visibilidade.

### **🏷️ Alvo clientes com base na etiqueta do cliente**

*   **O que faz:** A oferta é **oculto** de clientes logados que carregam pelo menos uma das etiquetas que você lista.
*   **Como utilizar:** Digite as etiquetas separadas por vírgulas — por exemplo, ocultar a oferta de `staff, influencer` assim as contas internas nunca vêem (ou usam) o negócio.

### **💰 Clientes-alvo com base na vida útil passada**

*   **O que faz:** A oferta é **oculto** de clientes cuja vida útil é **maior ou igual a** O montante indicado.
*   **Porquê usá- lo:** Ótimo para _aquisição_ ofertas — por exemplo, mostrar um primeiro pacote de compras apenas para clientes mais novos/baixo gasto e escondê-lo automaticamente de clientes que já gastaram muito.

⚠️ **Ocultar regras ganha.** Se um cliente corresponder _ambos_ uma regra de "Mostrar barra para" e uma regra de "Esconder barra de", a oferta é **oculto**. Usar isto de propósito — por exemplo, mostrar `wholesale` tag, mas esconder de `wholesale-blocked` Tag.

---

# **🌍 Meta de Geolocalização**

Esta carta permite- lhe controlar qual **países** Posso ver a oferta.

## **🌐 Todo o mundo**

*   **O que faz:** A oferta mostra aos visitantes de todos os países. Este é o padrão.
*   **Como utilizar:** Deixe selecionado a menos que você queira campanhas específicas do país.

## **🗺️ Países específicos**

*   **O que faz:** A oferta mostra **Apenas** para visitantes que navegam dos países que você seleciona. Toda a gente não vê nada.
    
*   **Como utilizar:**
    
    1.  Selecionar **Países específicos**.
    2.  Clique na **Seleccionar Países** botão para abrir o catador de país.
    3.  Procure países pelo nome, marque os países que deseja (ou use **Selecionar Tudo**), e confirmar com **Selecionar**.
*   O catador de país mostra uma contagem ao vivo de quantos países você selecionou, e seus países escolhidos estão listados no cartão para que você possa revê-los rapidamente.
    
*   A voltar para **Todo o mundo** limpa sua lista de países selecionados.
    

ℹ️ **Como o país é detectado:** Hoppy Bundles usos Shopifyos próprios dados de navegação- contexto/localização (o mesmo mecanismo Shopify usa para mercados), e caches do país detectado na sessão do visitante para verificações rápidas em cada carga de página.

💡 **Porquê usá- lo:** Execute promoções específicas para regiões (por exemplo, um pacote bancário de férias apenas para o Reino Unido), evite mostrar ofertas em países para os quais não envia ou crie ofertas separadas por região com descontos diferentes.

---

# **Programação**

Este cartão permite- lhe automatizar **quando** a oferta é ao vivo — perfeita para vendas em flash, promoções de fim de semana e campanhas de férias que devem começar e parar por conta própria.

## **🟢 Iniciar**

*   **Agora** – A oferta é ao vivo imediatamente após você salvar (sem atraso inicial).
*   **Data específica** – A oferta permanece escondida até a data e hora exatas que você escolher. Escolher:
    *   📅 Uma data do calendário
    *   🕐 Tempo (hora, minuto, AM/PM)

## **🔴 Fim**

*   **Nunca** – A oferta funciona indefinidamente uma vez ao vivo.
*   **Data específica** – A oferta pára automaticamente de mostrar na data e hora exatas que você escolher.

⚠️ Se o tempo final já passou, a oferta não renderizará nada — mesmo que tudo o mais esteja configurado corretamente. Se uma oferta "de repente desapareceu", verifique a data final primeiro.

ℹ️ **Comportamento do fuso horário:** A data/hora que você escolher é salva como um ponto absoluto no tempo baseado no fuso horário do seu navegador, e é comparada com o tempo atual do visitante na frente da loja. Assim, "termina sexta-feira 11:59 PM" termina naquele exato momento para todos, em toda parte — nenhuma matemática manual do fuso horário necessária.

💡 O cronograma também é usado para alimentar o comportamento do estilo de contagem regressiva em ofertas que mostram o tempo restante — o tempo final é o que a contagem regressiva conta para baixo.

---

# **📌 Notas e Dicas Importantes**

*   **🧱 Pilha de regras (E lógica).** País ✔️ + Cliente ✔️ + calendário ✔️ — o visitante deve passar _tudo_ deles para ver a oferta. Exemplo: uma oferta VIP-tag agendada para este fim de semana, dirigida aos EUA, mostra apenas para os clientes VIP-tagged baseados nos EUA durante essa janela.
*   **🚫 Ocultar batidas Show.** Se um cliente corresponder tanto a uma regra de show quanto a uma regra de esconde, a oferta está escondida.
*   **👻 Hóspedes e tags/spend.** As etiquetas de clientes e o tempo de vida útil só são legíveis quando um visitante é **logado**. Os hóspedes não podem combinar as regras de tag/spend — combinar essas regras com _Mostrar apenas para clientes logados_ para resultados limpos.
*   **🧪 Teste como um cliente de verdade.** Use uma conta de cliente de teste com as etiquetas/pastas certas para verificar suas regras. Um erro fácil é testar enquanto faz login como você mesmo (uma conta de equipe marcada) e concluir a oferta é "quebrou".
*   **🕵️ Teste as regras geo cuidadosamente.** Como a detecção do país é baseada na localização do visitante, você pode precisar de uma VPN ou um amigo no país-alvo para verificar ofertas específicas do país.
*   **💾 Salve antes de julgar.** As mudanças de alvo só têm efeito na frente da loja depois de clicar **Gravar** na oferta.

---

# **💡 Exemplos de Casos de Utilização🌟 Negociação do pacote somente VIP** → Visibilidade: _Mostrar apenas para clientes logados_ → Mostrar barra para: _Alvo clientes com base na etiqueta do cliente_ → `VIP` → Resultado: apenas clientes registrados `VIP` Vê o pacote.

**🎉 Oferta de boas-vindas ao cliente novo** → Mostrar barra para: _Todos os Clientes_ → Ocultar barra de: _Clientes-alvo com base na vida útil passada_ → `1` → Resultado: a oferta esconde-se silenciosamente de quem já gastou dinheiro em sua loja.

**⚡ Venda flash de 48 horas** → Início: _Data específica_ → Sexta-feira 12:00 → Fim: _Data específica_ → Domingo 11:59 → Resultado: a oferta liga e desliga automaticamente — sem trabalho manual noturno.

**🇬🇧 Promoção exclusiva do Reino Unido** → Geolocalização: _Países específicos_ → Reino Unido → Resultado: visitantes que navegam do Reino Unido ver a oferta; todos os outros não.

**🌍 Comércio grossista regional** → Visibilidade: _Mostrar apenas para clientes logados_ → Mostrar barra para: tag → `wholesale` → Geolocalização: _Países específicos_ → seus mercados grossistas → Resultado: apenas marcou contas grossistas nesses países ver o negócio.

---

# **🚀 Resultado Final**

Assim que o alvo estiver configurado, Hoppy Bundles silenciosamente faz a filtragem para você em cada carga de página ✨

Com o alvo montado corretamente:

✅ Os clientes certos vêem as ofertas certas — e ninguém mais vê ✅ VIPs, compradores por atacado, e grandes gastadores obter seus acordos exclusivos automaticamente ✅ Promoções específicas por país ficam limitadas aos países que você escolheu ✅ Oferece iniciar e parar exatamente no horário, com zero esforço manual ✅ Sua loja fica limpa para visitantes que não devem ver um determinado acordo

Combine essas regras cuidadosamente, e você pode executar promoções altamente personalizadas e totalmente automatizadas — tudo a partir de uma aba 🎯