> ## 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 的一项关键功能，它会在 cart drawer 中显示一个可视化进度条，通过跟踪客户在获得免运费、折扣或赠品等奖励方面的进度，鼓励客户消费更多。

这是介绍奖励设置的三篇指南中的第一篇：

* **常规设置**（本文档）
* **[奖励设置](/zh/upcart/tiered_rewards_module_rewards_settings)**
* **[高级设置](/zh/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" />

⚠️ *此模块纯粹是可视化的，不会应用折扣或运费逻辑。要使奖励真正生效，请参阅[奖励设置](/zh/upcart/tiered_rewards_module_rewards_settings)文档。*

<div id="general-settings">
  # 常规设置
</div>

<div id="show-rewards-on-empty-cart">
  ## 在空购物车中显示奖励
</div>

启用此选项后，即使购物车为空也会显示奖励进度条。

<div id="colors">
  ## 颜色
</div>

自定义进度条的视觉外观：

* **Bar background color**（进度条背景颜色）：表示尚未获得的部分
* **Bar foreground color**（进度条前景颜色）：表示朝奖励目标推进的进度
* **Complete reward tier icon color**（已完成奖励层级图标颜色）：客户已解锁的层级图标。**仅限版本 2。**
* **Incomplete reward tier icon color**（未完成奖励层级图标颜色）：尚未解锁的层级图标。**仅限版本 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** 下方的一个独立卡片。选择进度的计算方式：

* **Cart total (\$)**\
  基于购物车总金额进行跟踪（例如，满 \$100 获得奖励）。
* **Cart quantity (#)**\
  基于商品数量进行跟踪（例如，满 5 件商品获得奖励）。

  * 所选的计算基准适用于整个奖励进度条，无法按层级区分。

<div id="use-pre-discounted-prices-for-cart-total">
  ## 使用折扣前价格计算购物车总额
</div>

位于同一个 **Rewards calculation** 卡片中，且仅在计算基准为 **Cart total (\$)** 时显示。启用后，奖励将使用应用任何折扣之前的购物车总额来计算。这可以防止客户因使用了自己的优惠券而失去奖励资格。请参阅[如何在奖励目标中排除折扣](/zh/upcart/how_to_exclude_discounts_in_reward_goal)。

***

<div id="filter-which-products-count-toward-rewards">
  ## 筛选哪些产品计入奖励
</div>

通过 **Product Filters**（产品筛选），你可以控制购物车中哪些商品有资格计入奖励进度。这可以实现更高的精确度和使用场景灵活性，例如排除礼品卡或仅针对特定产品组。

<Note>
  这些筛选功能需要**版本 2** 的奖励模块。在版本 1 中，筛选部分完全不会显示。
</Note>

你可以按**产品**、**系列**、**商品属性**或**订阅状态**应用筛选。每个筛选器都可以设置为**包含**（仅所选商品计入）或**排除**（除所选商品外全部计入）。可以组合多个筛选器以实现分层逻辑。

<div id="product-filter">
  ## **产品筛选**
</div>

此筛选器可让你在奖励进度条中包含或排除单个产品。

* **包含**：只有所选产品才会计入奖励。
* **排除**：除你排除的产品外，所有产品都计入。

使用此功能可以专注于高利润 SKU、排除促销商品，或将礼品卡等低价值产品从奖励计算中移除。

<div id="collection-filter">
  ## **系列筛选**
</div>

此筛选器的逻辑与产品筛选相同，但作用于**系列级别**。

* 你可以包含整个 Shopify 系列（例如"假日系列"）以计入奖励。
* 或者排除像"促销商品"这样的系列，如果你不希望折扣产品计入的话。

非常适合批量控制，无需逐个选择产品。

<div id="item-property-filter">
  ## **商品属性筛选**
</div>

使用此筛选器可基于 **line item properties**（行商品属性）来包含或排除商品——这些元数据通常由其他应用、自定义产品选项或内部标记添加。

* 使用**键值对**添加筛选条件（例如 `upsell: true`、`__upcartRecommendation: [ID]`）
* 你可以将值字段留空，仅按键进行筛选（例如，排除所有带有 `upsell` 键的商品，无论其值为何）

这非常适合排除 upsell 商品、订阅、个性化订单，或任何通过店面或自动化设置动态标记的商品。

<div id="subscription-status-filter">
  ## **订阅状态筛选**
</div>

此筛选器可让你根据商品是订阅商品还是一次性购买来包含或排除商品。

* **订阅商品**：只有带有有效订阅计划的商品才会计入奖励
* **一次性商品**：只有以一次性方式（非订阅）购买的商品才会计入奖励

使用此功能可以专门为订阅购买创建奖励（例如，"添加 3 件订阅商品即享免运费"），或将订阅从某些奖励层级中排除。

***

<div id="advanced-settings">
  ## 高级设置
</div>

打开高级奖励设置菜单。有关按货币设置奖励和高级条件等功能，请参阅\*\*[高级设置](/zh/upcart/tiered_rewards_module_advanced_settings)\*\*指南。