> ## 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 Comprar X Obter Y

> ℹ️ **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 recompensar clientes com um **produto diferente** Quando eles compram o suficiente de alguma coisa? 🎁

Isso é exatamente o que o **Comprar X Obter Y** oferta em Hoppy Bundles foi concebido para o efeito.

Com este tipo de oferta, você pode criar ofertas condicionais como:

*   🛒 Compre 2 T-Shirts → Obter uma tampa a 50% OFF
*   💸 Compre 3 tênis → Obtenha um par de meias grátis
*   🎁 Compre 2 grãos de café → Obter uma caneca com um desconto

—e exibi-los como puro, níveis clicáveis diretamente em sua página do produto.

Os clientes simplesmente escolher o negócio que eles gostam, adicioná-lo ao carrinho, eo desconto no produto "Y" é aplicado automaticamente no checkout ✨

---

# **📍 Onde o comprar X Obter Y Widget aparece**

O widget Comprar X Obter Y aparece em seu **Página do produto**, logo abaixo do botão Adicionar ao Carrinho (posição padrão).

Você também pode colocá-lo em qualquer outro lugar na página do produto usando o **Colocação personalizada** opção (coberto mais tarde neste guia).

ℹ️ Comprar X Get Y usa a mesma tela de configuração que **Quebra de Quantidades** — abre apenas pré-cheio com Buy X Get Y tiers, a violeta **Yay! É BOGO** tema, e um título de bloco "Compre X Get Y". Este guia foca apenas no que é diferente para Buy X Get Y; configurações compartilhadas são resumidas brevemente.

---

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

Nesta documentação, vamos configurar a seguinte estrutura de níveis:

*   🛒 1 par → Preço padrão (sem desconto)
*   🎁 Compre 2 → Obter 3 de outro produto com um desconto
*   🎁 Compre 3 → Obter 4 de outro produto com um desconto

Estes são exatamente os níveis que o aplicativo pré-preenchimento para você quando você iniciar uma oferta Buy X Get Y - você pode editar cada parte deles ⚙️

---

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

Para o widget Comprar X Obter Y aparecer em sua loja, o aplicativo embed deve ser ativado dentro de seu Shopify tema.

Ir para:

**Shopify Admin → Canais de Vendas → Loja online → Temas → Personalizar → App Inbeds**

Depois:

*   Procurar **Pacotes App Incorporar**
*   Activar
*   Clique em Salvar

⚠️ **Importante**: Sem o aplicativo incorporado habilitado, sua oferta publicada não será visível na frente do store — mesmo que tudo dentro do aplicativo esteja configurado corretamente.

---

# **🎯 Passo 1 — Criar uma Nova Oferta Comprar X Obter Y**

Abrir o **Hoppy Bundles** app a partir da sua Shopify Admin.

Depois:

→ Clique **Criar uma Nova Oferta** para abrir a página de seleção do tipo de oferta.

→ Encontrar o **Compre X Obter Y (Oferta Condicional)** cartão — _“Compre uma quantidade específica e obtenha outro produto com desconto”_ — e click **Criar Comprar X Obter Y**.

A página de configuração abre com tudo pré-enchido para um negócio Buy X Get Y:

*   🎨 Modelo → **Yay! É BOGO** (tema violeta)
*   📰 Título do bloco → **Comprar X Obter Y**
*   🎁 Níveis → **Comprar X Obter Y Grátis** tipo de desconto com Comprar / Obter condições prontas para editar

💡 A partir deste cartão salva você de construir as camadas manualmente — mas você ainda pode alterar o modelo e cada camada depois.

---

# **🧩 Passo 2 — Nomeie sua oferta e escolha onde se aplica**

A primeira tela pede o básico antes de qualquer outra coisa.

---

## **🏷️ Nome da Oferta**

Este campo é utilizado apenas para fins internos.

Os clientes nunca verão este nome.

Você pode usar qualquer nome reconhecível como:

*   Compre 2 Obter um boné
*   Sapatilhas + Venda de Meias
*   Black Friday BXGY

💡 Usar nomes internos adequados torna mais fácil identificar configurações mais tarde, especialmente se sua loja executar várias ofertas.

---

## **📦 Aplicar a Oferta**

Esta definição controla os produtos que actuam como **Produtos “X”** — os clientes devem comprar para desbloquear o negócio.

Existem 3 opções disponíveis:

*   **Todos os Produtos** → a oferta se aplica a todos os produtos da sua loja
*   **Produto** → a oferta se aplica apenas aos produtos que você seleciona
*   **Colecção** → a oferta se aplica a cada produto dentro das coleções que você selecionar

Se você escolher **Produto** ou **Colecção**, a **Selecionar produto** / **Selecionar coleção** O botão aparece. Clique nele para abrir seu Shopify Recolhedor de recursos e escolha um ou mais itens.

⚠️ **Importante**:

*   Alternando entre **Todos os Produtos**, **Produto**, e **Colecção** limpa sua seleção atual — escolha o modo certo primeiro e selecione seus itens.
*   Apenas **uma oferta publicada é permitida por produto ou coleção**Se outra oferta publicada já cobre o mesmo produto, você não será capaz de publicar este até que a oferta existente seja convertida de volta para um rascunho.

---

# **🎨 Passo 3 — confirme seu modelo**

Rolar para baixo para o **Selecione sua oferta preferida** secção.

Para comprar X Obter Y, o **Yay! É BOGO** template (violet, deal-themed) já está selecionado para você — ele corresponde perfeitamente a esta oferta.

Você ainda pode passar através e escolher um olhar diferente se preferir:

*   **Construir um do zero** → começar com um layout limpo, mínimo
*   **Agrupar & Gravar** → o olhar verde clássico multi-camada
*   **Oferta de Tempo Limitado** → laranja, tema de urgência
*   **Loucura da Venda Flash!** → rosa, tema de venda

Clique **Aplicar o modelo seleccionado** continuar.

ℹ️ A **Aplicar o modelo seleccionado** botão permanece desativado até que você tenha selecionado pelo menos um produto ou coleção (ao usar o **Produto** ou **Colecção** modo).

Uma vez aplicado, o editor de configuração completo abre - com uma visualização ao vivo do seu widget no lado direito da tela 👀

---

# **⚙️ Passo 4 — Configurar sua compra X Obter Y Tiers (Aba Geral)**

Este é o coração da configuração ❤️

Cada negócio vive em sua própria aba (**Oferta 1**, **Oferta 2**, **Oferta 3**...). Clique em uma aba para editar essa camada.

A configuração pré-cheia é assim:

*   **Oferta 1** → Quantidade `1`, Tipo de desconto `No Discount` (um nível de base de preços-padrão)
*   **Oferta 2** → Tipo de desconto `Buy X Get Y Free`, Comprar `2`, Get `3`, marcado **Mais Popular**
*   **Oferta 3** → Tipo de desconto `Buy X Get Y Free`, Comprar `3`, Get `4`

Vamos passar pelos campos que fazem um Buy X Obter Y nível de trabalho.

---

## **💸 Tipo de desconto → Comprar X Obter Y Grátis**

Definir os níveis **Tipo de desconto** dropdown para **Comprar X Obter Y Grátis**.

Uma vez selecionado, o regular **Desconto** O campo de valor é substituído por dois campos de condição:

*   **Comprar** → quantos itens do produto “X” o cliente deve comprar. Este campo é **bloqueado** — segue-se sempre ao nível **Quantidade** valor.
*   **Vai-te embora.** → quantas unidades do produto “Y” o cliente recebe. Este campo é **editável** — configurá-lo a todas as suas promessas.

### **Exemplo**

*   Comprar `2` + Obter `1` → “Compra 2, Obter 1”
*   Comprar `3` + Obter `2` → “Compra 3, Obter 2”

⚠️ **Por favor note**: Mudar o tipo de desconto de uma camada **para** `Buy X Get Y Free` redefine o **Vai-te embora.** valor a `1` e limpa o produto Y selecionado — então escolha o tipo de desconto primeiro, depois configure o resto.

ℹ️ Se você quiser clientes para obter mais do **mesmo** livre de produto em vez de um produto diferente, use o **BOGO (Compre um Obter um)** tipo de desconto em vez disso — consulte o guia dedicado BOGO.

---

## **🎁 Obter produto — Selecionar produto Y**

ℹ️ Esta secção só aparece quando o tipo de desconto é **Comprar X Obter Y Grátis**.

Aqui é onde você escolhe o **Produto “Y”** — o produto que o cliente obtém com desconto quando compra o suficiente do produto “X”.

→ Clique **Selecionar produto Y** para abrir o seu Shopify Recolhedor de recursos e escolha um único produto.

Uma vez selecionado, o produto aparece dentro da camada com sua imagem e título. Até lá, você verá **“Nenhum produto selecionado”**.

⚠️ **Importante**: Não pule este passo — sem um produto Y selecionado, a camada não tem nada para dar. Verifique sempre se cada nível Compre X Obter Y tem seu próprio produto Y antes de publicar.

💡 Você pode usar um **Produto Y diferente por nível** — por exemplo, um pequeno freebie na categoria “Compra 2” e um prémio na categoria “Compra 3”.

---

## **🔢 Quantidade**

O número de itens “X” que o cliente deve comprar para desbloquear esta camada.

Para comprar X Obter Y níveis, o **Comprar** condição segue automaticamente esta quantidade — alterar a quantidade e o valor Buy atualiza com ela.

⚠️ Quantidade deve ser maior que 0 — você verá um erro inline se não for.

---

## **🏷️ Título da oferta, rótulo de desconto e etiqueta**

Cada camada tem três elementos de texto que você pode personalizar:

*   **Título da Oferta** → o texto principal na camada, por exemplo “Compre 2 Obter 3”
*   **Rótulo de Desconto** → o texto do negócio mostrado na camada, por exemplo, “Compre 2 Obter 3 em 50% OFF”
*   **Marca** → um pequeno crachá, por exemplo “Mais Popular”

A **Rótulo de Desconto** e **Marca** campos cada um tem um **ícone do olho** 👁️ do lado direito — clique nele para mostrar ou esconder esse elemento na frente da loja.

💡 As camadas pré-cheias já vêm com títulos e rótulos de estilo “Buy 2 Get 3” — basta ajustar a redação para corresponder ao seu negócio real, então os clientes não estão confusos sobre o que eles estão recebendo.

---

## **➕ Adicionar / 🗑️ Apagar os Níveis**

Abaixo das abas da oferta você encontrará:

*   **Adicionar Oferta** → adiciona uma nova aba de nível (máximo **6 níveis**). Novos níveis começam como uma planície `No Discount` Nível — mude o tipo de desconto para **Comprar X Obter Y Grátis** e configure você mesmo o produto Comprar / Obter / Y.
*   **Apagar** → remove o nível atualmente selecionado (mínimo **2 níveis** requerido)

Se atingires um destes limites, uma pequena mensagem de brinde vai avisar-te.

---

## **📰 Texto de & Rodapé do Título do Bloco**

Estes controlam o texto acima e abaixo do widget:

*   **Título do Bloco** → pré-cheia com “Compre X Get Y” — mude-o para algo mais punchier como “Bundle & Save” ou “Compre mais, obtenha mais 🎁“
*   **Texto do Rodapé** → Por exemplo, “Envio Livre”

Ambos os campos vêm com um **ícone do olho** para escondê-los completamente, se preferir um olhar mais limpo.

---

# **🛠️ Passo 5 — Configurar as Configurações**

Rolar para baixo para o **Configuração** Cartão. Estas caixas de seleção funcionam exatamente como elas fazem para as ofertas Quantity Break — aqui está a versão rápida:

**👀 Aparência e aparência**

*   **Mostrar o preço unitário** / **Mostrar o preço total** → exibir preços por unidade e por nível dentro da oferta
*   **Ocultar linhas de cabeçalho e rodapé** → widget limpo sem as linhas divisor
*   **Usar texto personalizado para Fora de stock** → mostrar sua própria mensagem quando um produto está fora de estoque (permitindo que ele revela um campo de texto)

**⚙️ Funcionalidade**

*   **Deixe os clientes escolher diferentes variantes para cada item** → os clientes podem escolher uma variante diferente para cada unidade na camada
*   **Mostrar o elemento abaixo adicionar ao botão do carrinho** → renderiza o widget diretamente abaixo do botão Adicionar ao Carrinho
*   **Saltar o carrinho diretamente para checkout** → clientes vão direto para checkout depois de adicionar uma camada
*   **Mostrar comparar ao preço** → exibe o strikethrough comparado-a preço (que permite que ele revela **Preço de comparação personalizado** e um somente leitura **Shopify preço de comparação do produto** campo)

**🔄 Habilitar combinação de descontos**

*   **Descontos de encomendas** / **Descontos de envio** → deixe o desconto desta oferta combinar com o nível de ordem e descontos de envio no checkout

ℹ️ A combinação de desconto de produto está sempre ligada. Devido a Shopify restrições, esta definição aplica-se globalmente a todas as novas ofertas deste tipo.

Abaixo Configurações que você também vai encontrar **Mercados múltiplos** (preços específicos do mercado) e **Tradução** (traduzir textos de widget). Ambos são opcionais e cobertos em seus próprios guias dedicados.

---

# **🎯 Etapa 6 — Segmentação e colocação (Opcional)**

Mudar para o **& Colocação de Destino** aba para controlar onde o widget aparece e quem o vê.

*   **Colocação** → **Abaixo Adicionar ao Botão do Carrinho (Padrão)** é recomendado para a maioria das lojas. Escolher **Personalizado (somente na página do produto)** se você quiser posicionar o widget você mesmo — após salvar, o aplicativo lhe dá **Hoppy bundles ID** e a **excerto de código** você pode colocar em qualquer lugar em seu tema.
*   **Alvo do Cliente** → mostrar a oferta apenas para clientes logados, ou mostrar / esconder com base em etiquetas de clientes e vida útil gasta
*   **Meta de Geolocalização** → limitar a oferta a países específicos (padrão: todos os locais)
*   **Agendamento** → definir a **início** e **fim** data/hora para a oferta — útil para vendas em flash

ℹ️ Todos estes são opcionais. Se os ignorares, a oferta mostra-se a todos, em todo o lado, imediatamente. Segmentação avançada é coberto em detalhe em seu próprio guia dedicado.

---

# **🎨 Página de Desenho (Opcional)**

A **Desenho** tab controla o estilo visual do widget — fontes, tamanhos de texto, cores, tamanho do seletor variante, e largura/rádio de borda.

💡 Cada mudança reflete instantaneamente na visualização ao vivo à direita — ambos na **desktop** e **móvel** painéis de visualização.

ℹ️ O tema violeta BOGO já parece ótimo fora da caixa, então este passo é totalmente opcional. Styling é coberto em profundidade no guia de design dedicado.

---

# **⚠️ Notas importantes antes de publicar**

*   🎁 Cada **Comprar X Obter Y Grátis** o nível precisa do seu próprio **Produto Y** seleccionado através de **Selecionar produto Y** — um nível sem um não tem nada a dar.
*   🔒 A **Comprar** valor está bloqueado para o nível **Quantidade** — editar a quantidade se necessitar de uma condição de compra diferente.
*   🔁 Mudar um nível para **Comprar X Obter Y Grátis** resets **Vai-te embora.** para `1` e limpa o produto Y — definir o tipo de desconto primeiro.
*   ✏️ Manter **Título da Oferta** e **Rótulo de Desconto** em sincronia com o seu número de compra / obter, para que o widget nunca promete algo diferente do que o desconto oferece.
*   Apenas **uma oferta publicada** é permitido por produto ou coleção.

---

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

Uma vez que tudo fica bem na pré-visualização:

1.  Clique **Gravar** na barra de gravação no topo da página
2.  Clique **Publicar** para fazer a oferta viver ⚠️ **Por favor note**:

*   A **Publicar** o botão está desativado enquanto a oferta é nova em folha — **salvar primeiro**, em seguida, publicar.
*   A publicação cria um **desconto automático** na sua **Shopify Admin → Descontos**. Isto é o que realmente aplica o desconto de produto Y no checkout — por favor, não exclua ou edite manualmente.
*   Se o aplicativo incorporado não estiver habilitado no seu tema, um banner aparecerá após salvar com um **Activar a Entrada da Aplicação** botão de atalho — clique nele, ative a inserção e salve seu tema.
*   Se a publicação falhar porque outra oferta publicada já cobre o mesmo produto ou coleção, converta essa oferta existente para um rascunho primeiro, então publique novamente.

Sua oferta de compra X Get Y está agora ao vivo 🚀

---

# **🎉 Resultado Final**

Uma vez configurado com sucesso:

✅ Clientes ver o seu Comprar X Obter Y níveis diretamente na página do produto ✅ Comprar a quantidade necessária desbloqueia automaticamente o produto com desconto “Y” ✅ O desconto aplica-se no momento da saída — não são necessários códigos de cupão ✅ Níveis, tags e etiquetas atualizados instantaneamente do aplicativo

Aqui está como o widget finalizado fica na frente do store — ofertas claras, um nível de melhor valor destacado e seleção de um clique ✨

---