> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aftersell.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Upsells de quantidade

> Ofereça um produto em vários níveis de quantidade na página pós-compra, com um desconto maior, uma unidade grátis ou um brinde nos níveis mais altos.

Um upsell de quantidade mostra um produto em dois a cinco níveis de quantidade na página pós-compra. Cada nível tem seu próprio desconto, então o comprador paga menos por unidade quanto mais unidades levar. O comprador escolhe um nível e aceita com um clique, e as unidades são adicionadas ao pedido que ele acabou de fazer.

<Note>
  Os upsells de quantidade oferecem um único produto. Para permitir que o comprador reúna vários produtos diferentes em um só pedido, use o [Build a Box](/pt/aftersell/build-a-box).
</Note>

<div id="how-a-quantity-upsell-works">
  ## Como funciona um upsell de quantidade
</div>

1. O comprador conclui o checkout e chega à página pós-compra.
2. A oferta mostra o produto uma vez, com um card de nível para cada quantidade que você configurou.
3. Um nível começa selecionado. Você escolhe qual e pode marcar um nível diferente como recomendado.
4. O comprador troca de nível, escolhe variantes se você permitir, e aceita.
5. A Aftersell adiciona as unidades do nível ao pedido original, com o desconto do nível.

Como as unidades entram no pedido existente, o comprador não paga um segundo frete nem precisa informar os dados do cartão novamente.

<div id="starter-templates">
  ## Modelos iniciais
</div>

Escolha um modelo ao criar a oferta. Cada um configura os níveis, os textos e o estilo dos cards para um padrão de venda diferente, e você pode alterar qualquer coisa depois.

| Modelo                            | O que configura                                                                                                   |
| --------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| **Quantity upsells**              | Cards de nível empilhados em linhas, com um desconto percentual em cada nível. O ponto de partida de uso geral.   |
| **Side-by-side quantity upsells** | Os mesmos níveis dispostos em colunas em telas largas, voltando a ser linhas no celular.                          |
| **Buy X, get Y free**             | Níveis que adicionam unidades grátis além das pagas, de modo que o nível mais alto diz "Compre 2, leve 1 grátis". |
| **Free gift unlock**              | Níveis que desbloqueiam um produto de brinde separado quando o comprador os seleciona.                            |

<div id="create-a-quantity-upsell">
  ## Criar um upsell de quantidade
</div>

1. Abra o funil ao qual você quer adicionar a oferta.
2. Selecione **Add offer** e escolha a opção de quantidade no menu.
3. Escolha um dos quatro modelos iniciais.
4. Em **Product selection**, escolha a origem do produto.
5. Em **Quantity tiers**, defina a quantidade e o desconto de cada nível.
6. Em **Card style**, ajuste o layout, a largura e as cores.
7. Salve e pré-visualize o funil.

<Tip>
  No editor atual, a entrada do menu de ofertas ainda aparece como **Quantity breaks**, que é o nome antigo do recurso. Em todos os outros lugares do editor, ela aparece como **Quantity upsells**. Ambos se referem ao mesmo tipo de oferta.
</Tip>

<div id="product-selection">
  ## Seleção de produto
</div>

Um upsell de quantidade oferece exatamente um produto, então você seleciona uma única origem de produto. Se você selecionar mais de uma, o funil não será salvo.

Você pode usar qualquer uma destas origens:

* **Specific product.** Escolha manualmente o produto que todo comprador vê.
* **Automatic upsell (AI).** A Recommendation API da Shopify escolhe um produto complementar a partir do pedido do comprador.
* **Most expensive in cart** ou **Least expensive in cart.** Oferece novamente o item de maior ou menor preço que o comprador acabou de comprar.
* **Collection.** A Aftersell resolve um produto a partir da coleção da Shopify que você escolher.
* **Strategy.** Uma [Strategy](/pt/aftersell/implementing_strategies_post_purchase_upsells) resolve o produto de acordo com suas regras sempre que a oferta é exibida.

Cada origem dinâmica é resolvida para um único produto antes de os níveis serem precificados e autorizados, então os descontos dos níveis sempre se aplicam ao produto que o comprador realmente vê.

<Warning>
  Alterar a origem do produto apaga todas as escolhas de variante salvas nos seus níveis, porque essas variantes pertencem ao produto anterior. Revise a configuração **Variant selection** de cada nível depois de trocar de origem.
</Warning>

<div id="quantity-tiers">
  ## Níveis de quantidade
</div>

Cada oferta tem entre dois e cinco níveis. Cada nível precisa de uma combinação diferente de quantidade e desconto; caso contrário, o funil não será salvo.

| Configuração                                              | O que controla                                                                                                       |
| --------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
| **Quantity**                                              | Quantas unidades pagas esse nível adiciona ao pedido.                                                                |
| **Free quantity**                                         | Unidades extras adicionadas com 100% de desconto além das pagas. É isso que cria um nível "compre X, leve Y grátis". |
| **Discount type**                                         | Percentual (0 a 100) ou um valor fixo de desconto.                                                                   |
| **Card title**                                            | O título do card do nível. Aceita `{quantity}`.                                                                      |
| **Subtext**, **chip text**, **price text**, **band text** | Os textos de apoio do card. Veja os limites de caracteres abaixo.                                                    |
| **Purchase options**                                      | Se esse nível é uma compra única, uma assinatura ou permite que o comprador escolha.                                 |
| **Variant selection**                                     | Se o comprador escolhe variantes e quantas.                                                                          |
| **Free gift**                                             | Um produto de brinde opcional desbloqueado por esse nível.                                                           |

Você também define qual nível começa selecionado e qual nível exibe o selo de recomendado. Pode ser o mesmo nível ou dois níveis diferentes.

<div id="copy-limits">
  ### Limites de texto
</div>

| Campo      | Máximo de caracteres |
| ---------- | -------------------- |
| Card title | 80                   |
| Subtext    | 100                  |
| Chip text  | 40                   |
| Price text | 40                   |
| Band text  | 60                   |

<div id="text-variables">
  ### Variáveis de texto
</div>

Use `{quantity}` nos textos do nível para exibir o tamanho do pacote desse nível. Níveis de assinatura também aceitam `{subscription-price}`, `{subscription-percent}` e `{cadence}`.

<div id="purchase-options">
  ## Opções de compra
</div>

Cada nível define seu próprio modo de compra:

* **One-time.** As unidades são adicionadas como uma compra única padrão.
* **Subscription.** As unidades são adicionadas em um plano de venda. Você pode restringir quais dos planos de venda do produto o comprador pode escolher.
* **Both.** O comprador escolhe entre compra única ou assinatura no card, e você define qual opção começa selecionada.

Subscription e Both exigem que o produto tenha planos de venda. Um produto sem planos de venda só pode usar níveis de compra única.

<div id="variant-selection">
  ## Seleção de variante
</div>

Um nível trata as variantes de uma de três formas:

* **Buyer selects.** Um único seletor no card, aplicado a todas as unidades do nível.
* **Locked.** Você escolhe a variante, e o comprador não pode alterá-la.
* **Per unit.** Um seletor para cada unidade, de modo que um comprador que leva três unidades pode escolher três variantes diferentes. Disponível em níveis de compra única, até 20 unidades. Você pode nomear os espaços e definir uma variante padrão para cada um.

No nível da oferta, **Variant preselection** decide qual variante começa selecionada:

| Opção                                | Comportamento                                                             |
| ------------------------------------ | ------------------------------------------------------------------------- |
| **Best match from initial purchase** | Corresponde à variante que o comprador já comprou. Este é o padrão.       |
| **First available**                  | A primeira variante em estoque.                                           |
| **Highest price**                    | A variante mais cara.                                                     |
| **Require user selection**           | Nada começa selecionado, e o comprador precisa escolher antes de aceitar. |

<div id="free-gifts">
  ## Brindes
</div>

Qualquer nível pode desbloquear um brinde, adicionado ao pedido com 100% de desconto. O modelo **Free gift unlock** já começa com isso configurado.

Para cada brinde, você define:

* **Gift product** e quais de suas variantes são permitidas.
* **Gift quantity**, até 20 unidades.
* **Gift name**, que recorre ao nome do próprio produto. Aceita `{quantity}`.
* **Gift variant selection**, seja uma variante para o brinde inteiro ou uma por unidade. A seleção por unidade exige uma quantidade de brinde maior que 1.
* Texto do **Free badge**, cujo padrão é `FREE ~~{value}~~`. `{value}` exibe o preço de varejo do brinde e `~~text~~` risca o texto. Remover `{value}` oculta o preço.
* **Locked label** e estilo de bloqueado, exibidos antes de o comprador selecionar aquele nível. Aceita `{quantity}`, para textos como "Compre {quantity} para desbloquear".

**Gift behavior** se aplica à oferta inteira, não a um único nível:

* **Cumulative.** Selecionar um nível concede o brinde dele e todos os brindes abaixo.
* **Selected tier.** Apenas o brinde do nível selecionado é concedido.

A escada de brindes pode ficar em **full width** abaixo dos níveis ou **inline** dentro da coluna dos níveis. Você também pode definir o cabeçalho exibido acima dos brindes, com até 80 caracteres.

<div id="card-style">
  ## Estilo do card
</div>

| Configuração          | Opções                                                                                                                                                                                              |
| --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Tier layout**       | Linhas ou colunas.                                                                                                                                                                                  |
| **Card width**        | De 400 a 800 px, em passos de 50.                                                                                                                                                                   |
| **Corner radius**     | Qualquer valor a partir de 0.                                                                                                                                                                       |
| **Colors**            | Cores de superfície, borda, título, subtexto, preço, preço comparativo, chip e faixa, cada uma como um valor hex de seis dígitos. Cards selecionados têm suas próprias cores de superfície e borda. |
| **Recommended badge** | Texto de até 30 caracteres, formato de pílula, fita ou retângulo, um ícone opcional, um tamanho de fonte e cores de fundo e de texto.                                                               |

Níveis individuais podem substituir as cores da oferta se você quiser que um nível se destaque além do selo de recomendado.

<div id="pricing-and-compare-at">
  ## Preço e preço comparativo
</div>

**Use compare-at price** controla o preço de referência riscado no card. Ele afeta apenas a exibição e não faz parte do desconto que a Aftersell autoriza, então alterá-lo nunca muda o valor cobrado do comprador. Em variantes sem preço comparativo, o preço de tabela é usado no lugar.

<div id="things-to-know">
  ## O que saber
</div>

* **Níveis esgotados aparecem como esgotados.** Se a Aftersell não conseguir garantir estoque para um nível quando a oferta é preparada, esse nível é exibido como esgotado, em vez de um card que falha silenciosamente ao ser aceito.
* **A Shopify limita as aceitações pós-compra.** Um comprador pode aceitar até duas ofertas pós-compra por pedido. Veja [ofertas de várias etapas](/pt/aftersell/how_to_create_a_multi_step_post_purchase_upsell) para entender como isso interage com funis mais longos.
* **Buy X, get Y free adiciona duas linhas.** As unidades pagas e as unidades grátis são adicionadas como linhas separadas da mesma variante, o que mantém os totais exatos. Ambas as linhas pertencem ao mesmo pedido.

<div id="related">
  ## Relacionados
</div>

* [Build a Box](/pt/aftersell/build-a-box)
* [Tipos de oferta pós-compra](/pt/aftersell/post-purchase-offer-types)
* [Configurando as opções de oferta pós-compra](/pt/aftersell/configuring_post_purchase_offer_settings)
* [Traduzindo funis pós-compra](/pt/aftersell/translating_post_purchase_funnels)