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

# Quantity upsells

> 구매 후 페이지에서 하나의 상품을 여러 수량 티어로 제공하고, 높은 티어일수록 더 큰 할인, 무료 수량 또는 무료 사은품을 제공해요.

Quantity upsell은 구매 후 페이지에서 하나의 상품을 2\~5개의 수량 티어로 보여줘요. 티어마다 자체 할인이 적용되므로, 구매자가 더 많이 담을수록 단위당 가격이 낮아져요. 구매자는 티어를 고르고 클릭 한 번으로 수락하며, 해당 수량은 방금 완료한 주문에 추가돼요.

<Note>
  Quantity upsells는 단일 상품을 제공해요. 구매자가 여러 다른 상품을 하나의 주문으로 구성하도록 하려면 대신 [Build a box](/ko/aftersell/build-a-box)를 사용하세요.
</Note>

<div id="how-a-quantity-upsell-works">
  ## Quantity upsell의 작동 방식
</div>

1. 구매자가 결제를 완료하고 구매 후 페이지로 이동해요.
2. 오퍼에는 상품이 한 번 표시되고, 구성한 각 수량마다 티어 카드가 표시돼요.
3. 하나의 티어가 처음부터 선택된 상태로 시작해요. 어떤 티어로 할지 직접 정할 수 있고, 다른 티어를 추천 티어로 표시할 수도 있어요.
4. 구매자는 티어를 바꾸고, 허용된 경우 옵션(variant)을 고른 뒤 수락해요.
5. Aftersell이 해당 티어의 수량을 티어 할인가로 원래 주문에 추가해요.

수량이 기존 주문에 추가되므로, 구매자는 배송비를 다시 내지 않고 카드 정보도 다시 입력하지 않아요.

<div id="starter-templates">
  ## 스타터 템플릿
</div>

오퍼를 만들 때 템플릿을 선택하세요. 각 템플릿은 서로 다른 판매 패턴에 맞게 티어, 문구, 카드 스타일을 설정해 주며, 이후에 무엇이든 변경할 수 있어요.

| 템플릿                               | 설정 내용                                                          |
| --------------------------------- | -------------------------------------------------------------- |
| **Quantity upsells**              | 티어 카드가 행으로 쌓이고, 각 티어에 퍼센트 할인이 적용돼요. 범용적인 시작점이에요.               |
| **Side-by-side quantity upsells** | 같은 티어가 넓은 화면에서는 열로 배치되고, 휴대폰에서는 다시 행으로 쌓여요.                    |
| **Buy X, get Y free**             | 유료 수량에 더해 무료 수량을 추가하는 티어로, 최상위 티어가 "Buy 2, get 1 free"처럼 표시돼요. |
| **Free gift unlock**              | 구매자가 선택하면 별도의 무료 사은품 상품이 잠금 해제되는 티어예요.                         |

<div id="create-a-quantity-upsell">
  ## Quantity upsell 만들기
</div>

1. 오퍼를 추가할 퍼널을 여세요.
2. **Add offer**를 선택한 다음, 메뉴에서 수량 옵션을 고르세요.
3. 네 가지 스타터 템플릿 중 하나를 선택하세요.
4. **Product selection**에서 상품 소스를 선택하세요.
5. **Quantity tiers**에서 각 티어의 수량과 할인을 설정하세요.
6. **Card style**에서 레이아웃, 너비, 색상을 조정하세요.
7. 저장하고 퍼널을 미리 보세요.

<Tip>
  현재 에디터에서는 오퍼 메뉴 항목이 여전히 이 기능의 이전 이름인 **Quantity breaks**로 표시돼요. 에디터의 다른 모든 곳에서는 **Quantity upsells**로 표시돼요. 둘 다 같은 오퍼 유형을 가리켜요.
</Tip>

<div id="product-selection">
  ## 상품 선택
</div>

Quantity upsell은 정확히 하나의 상품을 제공하므로, 상품 소스도 하나만 선택해요. 둘 이상을 선택하면 퍼널이 저장되지 않아요.

다음 소스 중 어느 것이든 사용할 수 있어요:

* **Specific product.** 모든 구매자에게 보여줄 상품을 직접 고르세요.
* **Automatic upsell (AI).** Shopify의 Recommendation API가 구매자의 주문을 바탕으로 보완 상품을 골라요.
* **Most expensive in cart** 또는 **Least expensive in cart.** 구매자가 방금 구매한 상품 중 가장 비싸거나 가장 저렴한 상품을 다시 제안해요.
* **Collection.** Aftersell이 선택한 Shopify 컬렉션에서 하나의 상품을 결정해요.
* **Strategy.** [Strategy](/ko/aftersell/implementing_strategies_post_purchase_upsells)가 오퍼가 표시될 때마다 여러분의 규칙에 따라 상품을 결정해요.

각 동적 소스는 티어 가격이 책정되고 승인되기 전에 하나의 상품으로 결정되므로, 티어 할인은 항상 구매자에게 실제로 표시되는 상품에 적용돼요.

<Warning>
  상품 소스를 변경하면 티어에 저장된 옵션 선택이 모두 지워져요. 해당 옵션은 이전 상품에 속한 것이기 때문이에요. 소스를 바꾼 후에는 각 티어의 **Variant selection** 설정을 다시 확인하세요.
</Warning>

<div id="quantity-tiers">
  ## 수량 티어
</div>

각 오퍼에는 2\~5개의 티어가 있어요. 모든 티어는 수량과 할인의 조합이 서로 달라야 하며, 그렇지 않으면 퍼널이 저장되지 않아요.

| 설정                                                        | 제어하는 내용                                                           |
| --------------------------------------------------------- | ----------------------------------------------------------------- |
| **Quantity**                                              | 이 티어가 주문에 추가하는 유료 수량이에요.                                          |
| **Free quantity**                                         | 유료 수량에 더해 100% 할인으로 추가되는 수량이에요. 이것이 "buy X, get Y free" 티어를 만들어요. |
| **Discount type**                                         | 퍼센트(0\~100) 또는 고정 금액 할인이에요.                                       |
| **Card title**                                            | 티어 카드의 헤드라인이에요. `{quantity}`를 지원해요.                               |
| **Subtext**, **chip text**, **price text**, **band text** | 카드의 보조 문구예요. 아래의 글자 수 제한을 참고하세요.                                  |
| **Purchase options**                                      | 이 티어가 일회성 구매인지, 구독인지, 구매자가 선택할 수 있는지를 정해요.                        |
| **Variant selection**                                     | 구매자가 옵션을 고르는지, 몇 개를 고르는지를 정해요.                                    |
| **Free gift**                                             | 이 티어로 잠금 해제되는 선택적 사은품 상품이에요.                                      |

어떤 티어가 처음부터 선택될지, 어떤 티어에 추천 배지를 달지도 설정할 수 있어요. 같은 티어여도 되고 서로 다른 두 티어여도 돼요.

<div id="copy-limits">
  ### 문구 제한
</div>

| 필드         | 최대 글자 수 |
| ---------- | ------- |
| Card title | 80      |
| Subtext    | 100     |
| Chip text  | 40      |
| Price text | 40      |
| Band text  | 60      |

<div id="text-variables">
  ### 텍스트 변수
</div>

티어 문구에 `{quantity}`를 사용하면 해당 티어의 팩 크기가 표시돼요. 구독 티어는 `{subscription-price}`, `{subscription-percent}`, `{cadence}`도 지원해요.

<div id="purchase-options">
  ## 구매 옵션
</div>

각 티어는 자체 구매 모드를 설정해요:

* **One-time.** 수량이 일반 일회성 구매로 추가돼요.
* **Subscription.** 수량이 판매 플랜(selling plan)으로 추가돼요. 구매자가 선택할 수 있는 상품의 판매 플랜을 제한할 수 있어요.
* **Both.** 구매자가 카드에서 일회성 구매나 구독을 고르며, 어떤 옵션이 처음부터 선택될지 설정할 수 있어요.

Subscription과 Both를 사용하려면 상품에 판매 플랜이 있어야 해요. 판매 플랜이 없는 상품은 일회성 티어만 사용할 수 있어요.

<div id="variant-selection">
  ## 옵션 선택
</div>

티어는 다음 세 가지 방식 중 하나로 옵션을 처리해요:

* **Buyer selects.** 카드에 선택기가 하나 있으며, 티어의 모든 수량에 적용돼요.
* **Locked.** 여러분이 옵션을 고르고, 구매자는 변경할 수 없어요.
* **Per unit.** 수량마다 선택기가 하나씩 있어서, 3개를 구매하는 구매자는 서로 다른 옵션 3개를 고를 수 있어요. 일회성 티어에서 최대 20개까지 사용할 수 있어요. 각 슬롯에 라벨을 붙이고 기본 옵션을 설정할 수 있어요.

오퍼 수준에서는 **Variant preselection**이 처음부터 선택될 옵션을 결정해요:

| 옵션                                   | 동작                                              |
| ------------------------------------ | ----------------------------------------------- |
| **Best match from initial purchase** | 구매자가 이미 구매한 옵션과 일치시켜요. 기본값이에요.                  |
| **First available**                  | 재고가 있는 첫 번째 옵션이에요.                              |
| **Highest price**                    | 가장 비싼 옵션이에요.                                    |
| **Require user selection**           | 아무것도 선택되지 않은 상태로 시작하며, 구매자가 수락하기 전에 직접 선택해야 해요. |

<div id="free-gifts">
  ## 무료 사은품
</div>

어떤 티어든 무료 사은품을 잠금 해제할 수 있으며, 사은품은 100% 할인으로 주문에 추가돼요. **Free gift unlock** 템플릿을 사용하면 이 설정이 미리 구성된 상태로 시작해요.

사은품마다 다음을 설정해요:

* **Gift product**와 허용할 옵션.
* **Gift quantity**, 최대 20개.
* **Gift name**, 비워 두면 상품 자체의 이름이 사용돼요. `{quantity}`를 지원해요.
* **Gift variant selection**, 사은품 전체에 하나의 옵션을 쓰거나 수량마다 하나씩 쓸 수 있어요. 수량별 선택은 사은품 수량이 1보다 커야 해요.
* **Free badge** 텍스트, 기본값은 `FREE ~~{value}~~`예요. `{value}`는 사은품의 소매가를 표시하고 `~~text~~`는 텍스트에 취소선을 그어요. `{value}`를 제거하면 가격이 숨겨져요.
* **Locked label**과 잠금 스타일, 구매자가 해당 티어를 선택하기 전에 표시돼요. "Buy {quantity} to unlock" 같은 문구를 위해 `{quantity}`를 지원해요.

**Gift behavior**는 한 티어가 아니라 오퍼 전체에 적용돼요:

* **Cumulative.** 티어를 선택하면 해당 티어의 사은품과 그 아래 모든 티어의 사은품이 제공돼요.
* **Selected tier.** 선택한 티어의 사은품만 제공돼요.

사은품 목록은 티어 아래에 **full width**로 배치하거나, 티어 열 안에 **inline**으로 배치할 수 있어요. 사은품 위에 표시되는 헤더도 최대 80자까지 설정할 수 있어요.

<div id="card-style">
  ## 카드 스타일
</div>

| 설정                    | 옵션                                                                                                       |
| --------------------- | -------------------------------------------------------------------------------------------------------- |
| **Tier layout**       | 행 또는 열이에요.                                                                                               |
| **Card width**        | 400\~800px, 50 단위예요.                                                                                     |
| **Corner radius**     | 0 이상의 모든 값이에요.                                                                                           |
| **Colors**            | 배경(surface), 테두리, 제목, 보조 문구, 가격, 비교 가격, 칩, 밴드 색상이며, 각각 6자리 hex 값으로 지정해요. 선택된 카드에는 별도의 배경 및 테두리 색상이 적용돼요. |
| **Recommended badge** | 최대 30자의 텍스트, 알약(pill)·리본·사각형 모양, 선택적 아이콘, 글꼴 크기, 배경 및 텍스트 색상이에요.                                         |

추천 배지 외에도 특정 티어를 더 돋보이게 하고 싶다면, 개별 티어에서 오퍼의 색상을 재정의할 수 있어요.

<div id="pricing-and-compare-at">
  ## 가격 및 비교 가격
</div>

**Use compare-at price**는 카드에 취소선으로 표시되는 참고 가격을 제어해요. 표시에만 영향을 주며 Aftersell이 승인하는 할인에는 포함되지 않으므로, 이를 변경해도 구매자에게 청구되는 금액은 절대 바뀌지 않아요. 비교 가격이 없는 옵션에는 대신 정가가 사용돼요.

<div id="things-to-know">
  ## 알아두어야 할 사항
</div>

* **품절된 티어는 품절로 표시돼요.** 오퍼가 준비될 때 Aftersell이 특정 티어의 재고를 확보할 수 없으면, 수락 시 조용히 실패하는 카드 대신 해당 티어가 품절로 표시돼요.
* **Shopify는 구매 후 수락 횟수를 제한해요.** 구매자는 주문당 최대 두 개의 구매 후 오퍼를 수락할 수 있어요. 이것이 더 긴 퍼널과 어떻게 상호작용하는지는 [다단계 오퍼](/ko/aftersell/how_to_create_a_multi_step_post_purchase_upsell)를 참고하세요.
* **Buy X, get Y free는 두 개의 라인을 추가해요.** 유료 수량과 무료 수량이 같은 옵션의 별도 라인으로 추가되어 합계가 정확하게 유지돼요. 두 라인 모두 같은 주문에 속해요.

<div id="related">
  ## 관련 문서
</div>

* [Build a box](/ko/aftersell/build-a-box)
* [구매 후 오퍼 유형](/ko/aftersell/post-purchase-offer-types)
* [구매 후 오퍼 설정 구성하기](/ko/aftersell/configuring_post_purchase_offer_settings)
* [구매 후 퍼널 번역하기](/ko/aftersell/translating_post_purchase_funnels)