> ## 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 Buy One Get One (BOGO)

> ℹ️ **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 executar um acordo clássico “Comprar 1 Obter 1 Grátis” — ou qualquer variação Comprar X Obter Y — sem tocar em códigos de desconto? 🎁

Isso é exatamente o que o **BOGO (Compre um Obter um)** oferta em Hoppy Bundles foi concebido para o efeito.

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

*   🛒 Comprar 1 → Preço Padrão
*   🎉 Compre 2 → Obter 1 grátis
*   🔥 Compre 3 → Obter 1 grátis

—e exibi-los como um widget puro e clicável diretamente em sua página do produto.

Os clientes simplesmente escolher o acordo que eles gostam, e o desconto item livre é aplicado automaticamente no checkout ✨

ℹ️ BOGO usa a mesma tela de configuração que um **Quebra de Quantidades** oferta – ele apenas abre pré-cheio com níveis tipo BOGO e **YAY! É BOGO** modelo, então você nunca está começando a partir de uma página em branco.

---

# **📍 Onde aparece o elemento BOGO**

O elemento BOGO aparece no 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).

ℹ️ O item gratuito é adicionado e descontado **automaticamente na saída** — os clientes não precisam adicionar o item gratuito ao carrinho ou inserir qualquer código de desconto.

---

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

Nesta documentação, vamos configurar a seguinte estrutura BOGO (isso é exatamente o que Hoppy Bundles Preenchimentos para si:

*   🛒 1 par → Preço padrão (sem desconto)
*   🎉 Compre 2 Obter 1 → o 3o item é gratuito
*   🔥 Compre 3 Obter 1 → o 4o item é gratuito

A oferta será aplicada a **Produtos específicos** e exibido usando o pré-selecionado **YAY! É BOGO** modelo.

Este guia explica cada configuração que você vai tocar durante a configuração, então você sabe exatamente como cada opção se comporta ⚙️

---

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

Para que o widget BOGO 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 → 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 BOGO**

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 **BOGO (Compre um Obter um)** cartão — _“Compre um produto e obtenha outro grátis ou com desconto”_ — e click **Criar uma Oferta BOGO**.

💡 Quer que o cliente para comprar uma quantidade fixa e obter um **produto diferente** com desconto? A **Comprar X Obter Y** A carta ao lado abre a mesma configuração com camadas pré-cheias para esse fluxo (por exemplo, “Comprar 2 Obter 3”).

---

# **🧩 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:

*   Venda de BOGO de verão
*   T-shirt Compre 2 Obter 1
*   Black Friday BOGO

💡 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 aos quais se aplica o acordo BOGO.

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**Apenas: **uma oferta publicada** é permitido por produto ou coleção. Se outra oferta publicada já cobre o mesmo produto, você precisará converter essa para um rascunho antes de publicar este.

---

# **🎨 Passo 3 — Escolha um modelo**

Em seguida, você verá o **Selecione sua oferta preferida** seção com uma linha de modelos de widget prontos.

Porque começaste com o cartão BOGO, **YAY! É BOGO** modelo (o violeta 💜) já está pré-selecionado para si — pode simplesmente mantê-lo.

Você também pode escolher um ponto de partida diferente:

*   **Agrupar & Gravar** → construir um do zero
*   **Oferta de Tempo Limitado** → níveis laranja-temáticos
*   **Loucura da Venda Flash!** → níveis de cor-de-rosa
*   **YAY! É BOGO** → níveis BOGO violeta-temáticos (pré-selecionado)

Uma vez que você está feliz com a seleção, clique **Aplicar o modelo seleccionado**.

⚠️ O botão aplicar permanece desativado até que você tenha selecionado pelo menos um produto ou coleção (quando **Aplicar a Oferta** está definido como **Produto** ou **Colecção**).

Após a aplicação, o editor completo abre com um **Visualização ao vivo** à direita — ambos **desktop** e **móvel** — que actualiza instantaneamente à medida que altera as definições ✨

---

# **⚙️ Passo 4 — Configurar seus níveis de BOGO (Aba Geral)**

É aqui que o teu acordo com o BOGO toma forma. Você verá seus níveis como abas — **Oferta 1**, **Oferta 2**, **Oferta 3** — cada um um um negócio clicável no widget storefront.

---

## **✏️ Nome da Oferta & Oferta Seleccionada**

No topo da página Geral, um pequeno cartão de resumo mostra **Nome da Oferta** (clique no ✏️ ícone para renomeá- lo) e seu **Oferta Seleccionada** modelo.

---

## **📐 Disposição do Modelo**

Escolha como os níveis são exibidos:

*   **Vertical** → níveis empilhados em cima um do outro (padrão)
*   **Horizontal** → níveis lado a lado

Com o **Vertical** layout, você também tem um **Escolha um tema** opção com predefinições de cores rápidas (azul, vermelho, verde).

---

## **🎁 Editar oferta — seus níveis de BOGO**

Cada tabulação de nível tem suas próprias configurações. Aqui está o que cada um faz para uma configuração BOGO:

### **💸 Tipo de Desconto**

Esta queda é o coração do teu nível. As opções relevantes do BOGO são:

*   **Sem desconto** → os itens são vendidos a preço padrão (perfeito para o seu “1 Par” camada base)
*   **BOGO (Compre um Obter um)** → comprar a quantidade de nível, obter item(s) extra do **mesmo produto** livre
*   **Comprar X Obter Y Grátis** → comprar a quantidade de camada, obter um **produto diferente** (o produto «Y»)

Outros tipos de desconto (**% de desconto**, **Desconto plano**, **Em cada unidade de desconto plano**, **Preço específico**) também trabalhar aqui se você quiser um widget misto — por exemplo, uma camada BOGO mais uma camada “20% OFF”.

### **🔢 Quantidade + Comprar / Obter**

A **Quantidade** campo controla quantos itens o cliente adiciona quando eles escolhem este nível — e para os níveis BOGO, ele também define o **Comprar** montante automaticamente.

*   Com **BOGO (Compre um Obter um)** selecionado, você verá **Comprar** e **Vai-te embora.** caixas em vez de um valor de desconto. Ambos são apenas leitura: **Comprar** corresponde sempre à quantidade da camada, e **Vai-te embora.** é fixado em **1 ponto livre**.
*   Com **Comprar X Obter Y Grátis** seleccionado, **Comprar** segue a quantidade do nível, mas **Vai-te embora.** é **editável** — para que você possa oferecer ofertas de estilo “Buy 2, Get 3”.

💡 Quero um clássico **Compre 1 Obter 1 Grátis**? Basta definir um nível **Tipo de Desconto** para **BOGO (Compre um Obter um)** e a sua **Quantidade** para **1** - Feito.

### **🎁 Obter produto (Comprar X Obter somente Y livre)**

Quando uma camada utiliza **Comprar X Obter Y Grátis**, um extra **Obter o Produto** aparece a secção.

Clique **Selecionar produto Y** para abrir o coletor de recursos e escolher o produto gratuito que seu cliente recebe.

ℹ️ É assim que você faz “Compre um capuz, obtenha um boné grátis”. Com a planície **BOGO (Compre um Obter um)** tipo, o item livre é sempre mais do **mesmo produto**, então nenhum produto Y é necessário.

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

*   **Título da Oferta** → o texto principal da camada, por exemplo. _Comprar 2 Obter 1_
*   **Rótulo de Desconto** → o texto de poupança mostrado na camada, por exemplo. _Compre 2 obter 1_ — clique no 👁️ ícone para o esconder
*   **Marca** → um pequeno crachá de destaque, por exemplo. _Mais Popular_ — também pode ser escondido com o 👁️ ícone

💡 As camadas pré-cheias já dizem “Compre 2 Obter 1” e “Compre 3 Obter 1” — basta ajustar o texto para combinar com a voz da sua marca.

### **🎁 Presente grátis (opcional)**

Assinalar a **Presente grátis** checkbox em qualquer nível, em seguida, clique **Selecionar produtos** anexar produtos de presente extra gratuitos a essa camada — em cima do próprio item livre BOGO.

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

*   Clique **Adicionar Oferta** adicionar outro nível (máximo **6** níveis)
*   Clique **Apagar** para remover o nível atual (pelo menos **2** níveis são necessários)

---

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

*   **Título do Bloco** → o cabeçalho acima do widget. É pré-cheia com **“Oferta BOGO”** — mudá-lo para qualquer coisa que você gosta, ou escondê-lo com o 👁️ ícone
*   **Texto do Rodapé** → uma pequena linha abaixo dos níveis (padrão: _Frete grátis_), também

---

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

Ainda na **Geral** tab, o **Configuração** A carta controla como o widget se comporta.

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

*   **Mostrar o preço unitário** → exibir o preço por item dentro de cada camada
*   **Mostrar o preço total** → exibir o preço total da camada
*   **Ocultar linhas de cabeçalho e rodapé** → remove as linhas de divisor de cabeçalho / rodapé do widget
*   **Usar texto personalizado para Fora de stock** → mostra sua própria mensagem quando o produto está fora de estoque (um campo de texto aparece abaixo quando habilitado)

## **⚙️ Funcionalidade**

*   **Deixe os clientes escolher diferentes variantes para cada item** → útil para BOGO — por exemplo, comprar 2 camisas, escolher um tamanho / cor diferente para cada um, e ainda obter o livre
*   **Mostrar o elemento abaixo adicionar ao botão do carrinho** → mantém o widget ancorado sob o botão Adicionar ao Carrinho
*   **Saltar o carrinho diretamente para checkout** → envia clientes diretamente para checkout quando eles escolhem uma camada
*   **Volume desconto (Extender Max desconto para todas as quantidades)** → permite que os clientes comprem itens adicionais além do nível mais alto com a mesma taxa máxima de desconto
*   **Mostrar comparar ao preço** → mostra a comparação a preço; permitindo-lhe revelar **Preço de comparação personalizado** e **Shopify preço de comparação do produto** campos

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

*   **Descontos de encomendas** → permitir que esta oferta para combinar com descontos nível de ordem
*   **Descontos de envio** → permitir que ele combinar com descontos de transporte

ℹ️ Os descontos de produtos sempre combinam. Devido a Shopify restrições, esta definição de combinação aplica-se globalmente a todas as novas ofertas baseadas em quebra de quantidade (incluindo BOGO).

## **🌍 Mercados Múltiplos & Tradução**

Mais para baixo você vai encontrar **Mercados múltiplos** (diferentes níveis por mercado) e **Tradução** (texto widget nas outras línguas da sua loja). Ambos são opcionais e cobertos em seus próprios guias dedicados.

---

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

A **& Colocação de Destino** tab controla onde e para quem a oferta mostra.

## **📍 Colocação**

*   **Abaixo Adicionar ao Botão do Carrinho (Padrão)** → nenhum trabalho extra necessário
*   **Personalizado (somente na página do produto)** → depois de salvar, você vai ter o seu **Hoppy bundles ID** e uma cópia **excerto de código** para cair em qualquer lugar em seu tema

## **👤 Alvo do Cliente & 🌍 Meta de Geolocalização**

*   Mostrar ou ocultar a oferta com base em **status de login, etiquetas de clientes ou valor total gasto**
*   Limitar a oferta **Países específicos** (padrão: **Todo o mundo**)

Há também um **Agendamento** secção para definir a **início** e **fim** data / hora para a oferta — perfeito para um fim de semana BOGO venda 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:

*   **Tipografia & Cor** → família de fontes, tamanhos de texto, pesos e cores para cada elemento
*   **Variante** → tamanho pequeno / médio / grande para seletores variante
*   **Contorno** → largura da borda e controles de raio de canto

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

ℹ️ O pré-selecionado **YAY! É BOGO** modelo já parece ótimo fora da caixa, então este passo é totalmente opcional. Styling é coberto em profundidade no guia de design dedicado.

---

# **✅ 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 os itens livres 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 BOGO está agora ao vivo 🚀

---

# **🎉 Resultado Final**

Uma vez configurado com sucesso:

✅ Clientes veem seus níveis BOGO diretamente na página do produto ✅ Itens gratuitos são adicionados e descontados automaticamente no checkout ✅ Níveis, tags e etiquetas atualizados instantaneamente do aplicativo ✅ O elemento corresponde ao seu tema com o modelo e as cores que escolheu

Aqui está como o widget terminado fica na frente da loja — ofertas BOGO claras, seleção de um clique e itens grátis aplicados automaticamente na saída ✨

---

💡 Quer que o item livre seja um **produto diferente** Em vez de mais do mesmo? Editar uma camada, mudar a sua **Tipo de Desconto** para **Comprar X Obter Y Grátis**, e escolher o seu produto livre com **Selecionar produto Y** — não é necessário recomeçar.