> ## 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 a quebra de quantidade da categoria > ℹ️ **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 os clientes por comprar mais — mesmo quando se misturam **produtos diferentes** num maço? 🛍️ Isso é exatamente o que o **Intervalo de Quantidade da Categoria** oferta em Hoppy Bundles foi concebido para o efeito. Com este tipo de oferta, você pode criar níveis de desconto baseados em pacotes, como: * 🛒 1 Pacote → Preço Padrão * 💸 2 Embalagem → 10% OFF * 💰 Embalagem → 20% OFF —onde cada embalagem é preenchida com o produto que o cliente está vendo **mais produtos extras que eles escolhem de uma lista que você cura**. Os clientes simplesmente selecionam um pacote, escolhem seus produtos extras e o desconto é aplicado automaticamente no checkout ✨ ℹ️ À procura de descontos de quantidade em **um único produto** Em vez disso? Esse é o **Quebra de Quantidades** oferta — tem seu próprio guia dedicado. --- # **📍 Onde aparece o elemento de quebra de quantidade da categoria** O widget Categoria Quantity Break 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 widget mostra seus pacotes como níveis puros e selecionáveis por rádio — o cliente toca em um pacote, escolhe os produtos extras para ele e aperta o botão Adicionar ao Carrinho 👇 --- # **🛠️ Configuração de Exemplo Usada nesta Documentação** Nesta documentação, vamos configurar a seguinte estrutura do pacote: * 🛒 1 Pacote → Preço padrão (sem desconto) * 💸 2 Pack → 10% OFF — cliente escolhe 1 produto extra * 💰 3 Pack → 20% OFF — cliente escolhe 2 produtos extras 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 de quebra de quantidade da categoria apareça em sua frente da loja, o aplicativo 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 categoria de oferta de quebra de quantidade** 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 **Intervalo de Quantidade da Categoria** carta (subtítulo: **(Produtos diferentes)**) e click **Criar uma quebra de quantidade de categoria**. O editor de configuração abre imediatamente — não é necessário escolher um modelo. Sua oferta começa com 3 níveis de embalagem pré-cheia, e uma visualização ao vivo do widget fica no lado direito da tela 👀 --- # **⚙️ Passo 2 — Conheça o Editor** O editor está organizado em 3 abas: * **Geral** → oferecer nome, níveis de embalagem, e configurações de comportamento * **Desenho** → fontes, cores e bordas * **& Colocação de Destino** → quem vê a oferta e onde aparece Este guia foca nas configurações que você precisa para obter a oferta ao vivo. Vamos passar pelo **Geral** secção por secção. --- ## **✏️ Nome da Oferta** No topo da página Geral você pode ver o seu **Nome da Oferta** (ele começa como "Category QB Oferta"). Este campo é utilizado apenas para fins internos — os clientes nunca verão este nome. Clique na **ícone lápis** Ao lado dele para renomeá-lo a qualquer hora. Você pode usar qualquer nome reconhecível como: * Pacotes de cuidados de pele de verão * Misture e combine a oferta do lanche * Pacotes de sexta-feira preto 💡 Usar nomes internos adequados torna mais fácil identificar configurações mais tarde, especialmente se sua loja executar várias ofertas. --- # **🎁 Passo 3 — Configurar seus níveis de embalagem (Editar oferta)** Este é o coração da configuração ❤️ Cada nível de embalagem vive na sua própria aba (**Oferta 1**, **Oferta 2**, **Oferta 3**Clique em uma aba para editar esse nível. Para nossa configuração de exemplo: * **Oferta 1** → Quantidade `1`, Tipo de desconto `No Discount` * **Oferta 2** → Quantidade `2`, Tipo de desconto `% Discount`, Desconto `10` * **Oferta 3** → Quantidade `3`, Tipo de desconto `% Discount`, Desconto `20` --- ## **💸 Tipo de Desconto** Este dropdown controla que tipo de negócio o pacote oferece: Tipo de Desconto O que ele faz Sem desconto Preço padrão — útil como nível de base “1 Pack” % de desconto (por exemplo, 25% de desconto) Percentagem da embalagem Desconto plano (por exemplo, $29.00 de desconto) Quantidade fixa fora da embalagem Em cada unidade de desconto plano Montante fixo desligado **cada unidade** na embalagem Preço específico (por exemplo, $29.00) Os clientes pagam exatamente este preço pelo pacote BOGO (Compre um Obter um) Comprar X itens, obter Y itens grátis Comprar X Obter Y Grátis Comprar X itens, obter um **produto diferente** desconto/livre Dependendo do tipo de desconto, campos extras aparecem automaticamente: * **% / Plano / Por unidade / Preço Específico** → a **Desconto** campo de entrada para o valor (desactivado para **Sem desconto**) * **BOGO** → **Comprar** e **Vai-te embora.** campos (A compra está bloqueada para a quantidade da embalagem) * **Comprar X Obter Y Grátis** → **Comprar** e **Vai-te embora.** campos (A compra está bloqueada para a quantidade da embalagem), mais **Selecionar produto Y** botão para escolher qual produto o cliente recebe ⚠️ **Por favor note**: Para **Comprar X Obter Y Grátis**, certifique-se de que você realmente selecionar um produto “Y” – sem um, a embalagem não tem nada para dar. ℹ️ Pela **BOGO** e **Comprar X Obter Y** níveis, o **Comprar** condição segue automaticamente a quantidade da embalagem. --- ## **🔢 Quantidade** O número total de itens na embalagem — incluindo o produto que o cliente está vendo. Então, um nível com Quantidade `3` significa: o produto actual **\+ 2 produtos adicionais** O cliente escolhe. ⚠️ Quantidade deve ser maior que 0 — você verá um erro inline se não for. --- ## **🏷️ Título da Oferta** O texto principal mostrado no nível da embalagem, por exemplo: * 1 Embalagem * Embalagem * Embalagem --- ## **📦 Produtos nesta embalagem** ℹ️ Esta secção só aparece nos níveis em que **Quantidade superior a 1** — um nível “1 Pack” não tem produtos adicionais para adicionar. Aqui você cura os produtos os clientes podem encher o pacote com: * Clique **Adicionar produtos a este nível** para abrir o seu Shopify catador de produtos e escolha um ou mais produtos * Cada produto adicionado aparece na lista com sua imagem e título * Clique na **✕** junto a um produto para o remover da embalagem 💡 Você também pode gerenciar os produtos do pacote diretamente da visualização ao vivo à direita — use o **Escolher** botão em um espaço vazio para preenchê-lo, ou o **✕** num espaço cheio para o limpar. Ambos atualizam sua configuração instantaneamente. --- ## **🏷️ Rótulo e etiqueta de desconto** Cada nível tem duas decorações de texto opcionais: * **Rótulo de Desconto** → o texto do acordo mostrado no pacote, por exemplo “10% OFF” * **Marca** → um pequeno crachá, por exemplo “Mais Popular” Ambos os campos têm **ícone do olho** 👁️ do lado direito — clique nele para mostrar ou esconder esse elemento na frente da loja. 💡 Adicionar uma etiqueta “Mais Popular” ao seu pacote médio é uma maneira simples de empurrar os clientes para ele. --- ## **➕ Adicionar / 🗑️ Apagar os Níveis** Abaixo das abas da oferta você encontrará: * **Adicionar Nível** → adiciona uma nova aba de nível do pacote (máximo **6 níveis**) * **Apagar o Nível** → remove o nível atualmente selecionado (pelo menos **1 nível** deve permanecer) Se atingires um destes limites, uma pequena mensagem de brinde vai avisar-te. --- # **🛠️ Passo 4 — Configurar Configurações** Role para baixo na guia Geral para encontrar as configurações abaixo dos níveis do seu pacote. --- ## **🖱️ Texto do Botão CTA** O texto mostrado no botão Adicionar ao Carrinho do widget (placeholder padrão: "Adicionar pacote ao Carrinho"). 💡 Combine isto com a sua língua de embalagem — por exemplo, “Adicionar embalagem ao carrinho” ou “Construir a minha embalagem”. --- ## **🔄 Habilitar combinação de descontos** Estas opções permitem que o desconto de intervalo de quantidade da categoria combine com outros tipos de desconto no checkout: * **Descontos de encomendas** * **Descontos de envio** ℹ️ A combinação de desconto de produto está sempre ligada. Também note que devido a Shopify restrições, esta configuração aplica-se globalmente a todas as novas ofertas de quebra de quantidade. --- ## **🌍 Mercados Múltiplos & Tradução** Abaixo Configurações que você também vai encontrar: * **Mercados múltiplos** → definir o preço do pacote específico do mercado para a oferta * **Tradução** → traduzir textos widget para idiomas adicionais da sua loja ℹ️ Estes são opcionais e não são necessários para obter sua oferta ao vivo — eles estão cobertos em seus próprios guias dedicados. --- # **🎯 Etapa 5 — 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)** → o widget é colocado automaticamente na página do produto — recomendado para a maioria das lojas * **Personalizado (somente na página do produto)** → coloque o widget em qualquer lugar que você gosta na página do produto Se você escolher **Personalizado**, o aplicativo dá-lhe duas coisas **após a gravação**: * **Hoppy bundles ID** → usá-lo para adicionar / reposicionar o Hoppy Bundles bloco de aplicativo em seu editor de tema * **Hoppy bundles excerto de código** → um pequeno `
` você pode colar em qualquer lugar em seu código de tema ℹ️ Até que a oferta seja salva uma vez, você verá “Salve para ver Hoppy bundles ID e trecho de código”. --- ## **👤 Alvo do Cliente & 🌍 Meta de Geolocalização** Estas secções opcionais permitem-lhe: * Mostrar a oferta apenas para **Clientes registados** * Mostrar ou ocultar a oferta com base em **etiquetas de clientes** ou **vida útil** * 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 — ú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: * **Família de fontes** → escolher uma fonte, ou ficar com **Usar fontes de tema** * **Tipografia & Cor** → tamanhos de texto, pesos e cores para cada elemento * **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. ℹ️ Os padrões já estão ótimos 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 preços do pacote 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. Sua oferta de quebra de quantidade categoria agora está ao vivo 🚀 --- # **🎉 Resultado Final** Uma vez configurado com sucesso: ✅ Os clientes veem seus níveis de embalagem diretamente na página do produto ✅ Eles escolhem um pacote, escolhem os produtos extras, e adicionam tudo em um clique ✅ Descontos se aplicam automaticamente no checkout ✅ Níveis, tags e etiquetas atualizados instantaneamente do aplicativo ✅ O elemento corresponde ao seu tema com as fontes e cores que escolheu Veja como o widget acabado fica na frente da loja — pacotes limpos, economias claras e seleção de um clique ✨ --- 💡 Quer descontos de volume em um **produto único** Em vez de pacotes mistos? Criar um **Quebra de Quantidades** a oferta da página do tipo de oferta — utiliza preços em camadas para múltiplos do mesmo item.