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

# 계층형 리워드 모듈 - 일반 설정

> 리워드 모듈의 디자인 및 기능 설정 구성하기

리워드 모듈은 Upcart의 핵심 기능으로, 카트 드로어에 시각적인 진행률 바를 표시하여 고객이 무료 배송, 할인, 사은품 같은 리워드를 향한 진행 상황을 확인하며 더 많이 구매하도록 유도해요.

이 문서는 리워드 설정을 다루는 세 가지 가이드 중 첫 번째예요:

* **일반 설정** (이 문서)
* **[리워드 설정](/ko/upcart/tiered_rewards_module_rewards_settings)**
* **[고급 설정](/ko/upcart/tiered_rewards_module_advanced_settings)**

<img src="https://mintcdn.com/aftersell/uVGuDiyXpd6WOLO4/images/upcart/tiered-rewards-general-progress-bar-free-shipping.png?fit=max&auto=format&n=uVGuDiyXpd6WOLO4&q=85&s=3065be916fd829d905d4c2dc91755668" alt="무료 배송 및 상품 마일스톤 아이콘이 있는 Upcart 리워드 진행률 바" width="1134" height="354" data-path="images/upcart/tiered-rewards-general-progress-bar-free-shipping.png" />

⚠️ *이 모듈은 순수하게 시각적인 요소이며 할인이나 배송 로직을 적용하지 않아요. 리워드가 실제로 작동하게 하려면 [리워드 설정](/ko/upcart/tiered_rewards_module_rewards_settings) 문서를 참고하세요.*

<div id="general-settings">
  # 일반 설정
</div>

<div id="show-rewards-on-empty-cart">
  ## 빈 장바구니에 리워드 표시
</div>

이 옵션을 활성화하면 장바구니가 비어 있을 때도 리워드 바가 표시돼요.

<div id="colors">
  ## 색상
</div>

바의 시각적 모양을 사용자 지정할 수 있어요:

* **바 배경 색상**: 아직 달성하지 못한 부분을 나타내요
* **바 전경 색상**: 리워드를 향한 진행 상황을 나타내요
* **완료된 리워드 단계 아이콘 색상**: 고객이 이미 잠금 해제한 단계 아이콘이에요. **Version 2 전용.**
* **미완료 리워드 단계 아이콘 색상**: 아직 잠금 해제하지 않은 단계 아이콘이에요. **Version 2 전용.**

<img src="https://mintcdn.com/aftersell/uVGuDiyXpd6WOLO4/images/upcart/tiered-rewards-general-bar-preview-colors.png?fit=max&auto=format&n=uVGuDiyXpd6WOLO4&q=85&s=61991e26fa74b74d0146ecb91b8bc1cd" alt="바 배경 및 전경 색상 필드 위에 표시된 리워드 바 미리보기" width="1136" height="646" data-path="images/upcart/tiered-rewards-general-bar-preview-colors.png" />

<div id="text-after-completing-full-rewards-bar">
  ## 리워드 바를 모두 완료한 후 표시할 텍스트
</div>

모든 리워드 단계를 달성했을 때 표시되는 사용자 지정 메시지를 추가하세요. 서식 도구(굵게, 기울임, 밑줄, 색상)를 사용해 메시지 스타일을 원하는 대로 꾸밀 수 있어요.

<img src="https://mintcdn.com/aftersell/uVGuDiyXpd6WOLO4/images/upcart/tiered-rewards-general-completion-message-editor-formatting.png?fit=max&auto=format&n=uVGuDiyXpd6WOLO4&q=85&s=f09c117f9c5d93924d4f33162c37e3a2" alt="서식 툴바와 잠금 해제 샘플 텍스트가 있는 리워드 완료 메시지 편집기" width="1082" height="400" data-path="images/upcart/tiered-rewards-general-completion-message-editor-formatting.png" />

***

<div id="rewards-calculation">
  ## 리워드 계산
</div>

이 항목은 **General settings** 아래에 별도의 카드로 표시돼요. 진행률 계산 방식을 선택하세요:

* **장바구니 합계 (\$)**\
  장바구니 총액을 기준으로 추적해요(예: \$100에서 리워드 제공).
* **장바구니 수량 (#)**\
  상품 개수를 기준으로 추적해요(예: 5개 상품에서 리워드 제공).

  * 선택한 기준은 리워드 바 전체에 적용되며 단계별로 다르게 설정할 수 없어요.

<div id="use-pre-discounted-prices-for-cart-total">
  ## 장바구니 합계에 할인 전 가격 사용
</div>

같은 **Rewards calculation** 카드에 있으며, 기준이 \*\*장바구니 합계 (\$)\*\*일 때만 표시돼요. 활성화하면 할인이 적용되기 전의 장바구니 합계를 기준으로 리워드가 계산돼요. 이렇게 하면 고객이 본인의 쿠폰 때문에 리워드 대상에서 제외되는 것을 방지할 수 있어요. [리워드 목표에서 할인을 제외하는 방법](/ko/upcart/how_to_exclude_discounts_in_reward_goal)을 참고하세요.

***

<div id="filter-which-products-count-toward-rewards">
  ## 리워드에 포함될 상품 필터링하기
</div>

**상품 필터**를 사용하면 장바구니의 어떤 상품이 리워드 진행에 기여할 수 있는지 제어할 수 있어요. 기프트 카드를 제외하거나 특정 상품 그룹만 대상으로 하는 등 더욱 정밀하고 유연한 활용이 가능해요.

<Note>
  이 필터는 **Version 2** 리워드 모듈이 필요해요. Version 1에서는 필터 섹션이 아예 표시되지 않아요.
</Note>

**상품**, **컬렉션**, **상품 속성**, **구독 상태**별로 필터를 적용할 수 있어요. 각 필터는 **포함**(선택한 상품만 기여) 또는 **제외**(선택한 상품을 제외한 모든 상품이 기여)로 설정할 수 있어요. 여러 필터를 조합해 복합적인 로직을 만들 수도 있어요.

<div id="product-filter">
  ## **상품 필터**
</div>

이 필터를 사용하면 개별 상품을 리워드 바에서 포함하거나 제외할 수 있어요.

* **포함**: 선택한 상품만 리워드에 반영돼요.
* **제외**: 제외한 상품을 뺀 모든 상품이 반영돼요.

고마진 SKU만 대상으로 하거나, 프로모션 상품을 제외하거나, 기프트 카드 같은 저가 상품을 리워드 계산에서 빼는 데 활용하세요.

<div id="collection-filter">
  ## **컬렉션 필터**
</div>

이 필터는 상품 필터와 동일한 로직을 **컬렉션 수준**에서 적용해요.

* Shopify 컬렉션 전체(예: "Holiday Collection")를 포함해 리워드에 반영할 수 있어요.
* 또는 할인 상품이 반영되지 않도록 "Sale Items" 같은 컬렉션을 제외할 수 있어요.

상품을 하나씩 선택하지 않고도 일괄 제어할 수 있어 편리해요.

<div id="item-property-filter">
  ## **상품 속성 필터**
</div>

이 필터는 **라인 아이템 속성** — 다른 앱, 사용자 지정 상품 옵션 또는 내부 태깅으로 자주 추가되는 메타데이터 — 을 기준으로 상품을 포함하거나 제외해요.

* **키-값 쌍**을 사용해 필터를 추가하세요(예: `upsell: true`, `__upcartRecommendation: [ID]`)
* 값 필드를 비워 두면 키만으로 필터링할 수 있어요(예: 값과 관계없이 `upsell` 키가 있는 모든 상품 제외)

업셀 상품, 구독 상품, 맞춤 주문 상품 등 스토어프런트나 자동화 설정을 통해 동적으로 태깅된 항목을 제외하는 데 이상적이에요.

<div id="subscription-status-filter">
  ## **구독 상태 필터**
</div>

이 필터를 사용하면 상품이 구독 상품인지 일회성 구매인지에 따라 포함하거나 제외할 수 있어요.

* **구독 상품**: 활성 구독 플랜이 있는 상품만 리워드에 반영돼요
* **일회성 상품**: 일회성(비구독)으로 구매한 상품만 리워드에 반영돼요

구독 구매 전용 리워드를 만들거나(예: "구독 상품 3개를 추가하면 무료 배송"), 특정 리워드 단계에서 구독을 제외하는 데 활용하세요.

***

<div id="advanced-settings">
  ## 고급 설정
</div>

Advanced Rewards Settings 메뉴를 열어요. 통화별 리워드, 고급 조건 같은 기능은 **[고급 설정](/ko/upcart/tiered_rewards_module_advanced_settings)** 가이드를 참고하세요.