> For the complete documentation index, see [llms.txt](https://docs.bogos.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bogos.io/cn/detailed-guide/settings.md).

# 设置

## 1. 常规设置

<figure><img src="/files/P2knv7DNVq2lS6NZQmmW" alt=""><figcaption></figcaption></figure>

* **BOGOS 状态**：启用 BOGOS 状态以使应用在您的网店上正常运行。
* **时区**：时间将根据您设备的时区显示
* **应用语言**：更改应用语言以匹配您的母语

## 2. 赠品逻辑机制

{% embed url="<https://youtu.be/gXwkfsbsWgI?si=1BbGRUUuEAqNRGNJ>" %}

<figure><img src="/files/DlRcCra1Aq2TlOwv6c8r" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
更改逻辑将影响所有优惠，并从您的店铺中移除所有现有的克隆商品。逻辑切换完成后，您可能需要重新启用优惠。

**BOGOS 建议**在更改逻辑之前**联系支持团队**，以确保平稳过渡。
{% endhint %}

BOGOS 提供两种赠品逻辑机制：

### **2.1. 赠品克隆（默认）**

{% hint style="success" %}
兼容 POS、移动应用、无头架构（Headless）、第三方结账、履约应用。
{% endhint %}

创建赠品优惠后，BOGOS 会自动在商家的 Shopify 商品目录中创建原始赠品商品的副本（“克隆”）。

这些克隆商品/赠品：

* 会从网店/店铺搜索中隐藏
* 会打上“bogos-gift”标签
* 会将该克隆副本添加到购物车中，而非原始商品。

{% hint style="info" %}
由于它是一个独立的商品条目，这使 BOGOS 拥有更大的灵活性：可从搜索中隐藏赠品（打造神秘赠品）、为这些克隆赠品设置独特的图片/标题、创建赠品优惠的数量不受限制……
{% endhint %}

{% hint style="warning" %}
如需管理克隆赠品的库存（例如与原始商品的库存同步），请阅读[5. 赠品库存管理](#id-5.-gift-inventory-management)。
{% endhint %}

### **2.2. 赠品功能**

{% hint style="warning" %}
不兼容移动应用、无头架构（Headless）或第三方结账。
{% endhint %}

赠品将以您的原始 Shopify 商品形式添加到购物车中，并通过 Shopify 的原生折扣功能进行打折。

例如：这种方式无法超过店铺范围内 100 个折扣的限制。

## 3. 赠品条件

<figure><img src="/files/A6nknbM9jffr7TKHOQsV" alt=""><figcaption></figcaption></figure>

### 3.1. 自动将赠品添加到购物车

当优惠中仅选择了一个赠品时，该赠品将自动添加到顾客的购物车中。如果您禁用此功能，赠品商品将始终显示在赠品滑块中。

### 3.2. 赠品折扣的计算依据 <a href="#gift-discount-calculated-by" id="gift-discount-calculated-by"></a>

赠品折扣百分比可以基于当前价格或原价（对比价）计算。

### 3.3. 赠品价格必须低于/等于商品价格

此功能限制顾客只能获得价格低于其购物车中商品的赠品。赠品的价格可以基于当前价格或原价（对比价）计算。

### 3.4. 每个赠品限选一次

此功能限制顾客从赠品滑块中**第二次**选择同一赠品项目。即使顾客符合具有相同赠品的其他优惠的条件，也无法再次选择该赠品项目。

### 3.5. 排除已添加的商品

此功能限制顾客在购物车中已有相同商品的情况下获得赠品。

## 4. 赠品商品

{% embed url="<https://youtu.be/2-Bg_Ep7W5s?si=iQ9xVWQ6AiVyUGFQ>" %}

设置赠品商品从原始商品继承信息

<figure><img src="/files/qMzVSoxFI4ORd9Xbg7p3" alt=""><figcaption></figcaption></figure>

### 4.1. 在关闭优惠后删除赠品商品

此功能默认始终启用，因此在停用优惠后，所有克隆商品都可以被移除。

### 4.2. 在赠品商品中包含原价（对比价）

如果启用此功能，赠品商品将显示。启用此设置后，赠品商品将在顾客的购物车中显示带删除线的原价。

### 4.3. 赠品商品的 SKU/条码格式

默认情况下，我们的应用克隆的赠品商品将与原始商品的 SKU/条码相同。

您也可以在以下选项之间自定义您的 SKU/条码格式：

* 与原始商品相同
* 与原始商品相同，并附加后缀。例如：SKU (100%OFF)
* 空白

如果您使用库存管理系统或第三方履约服务来管理店铺，这将会有所帮助。

### 4.4. 赠品商品标题格式

请选择您偏好的格式，以下 3 种可供选择。更改此设置后，请重新激活优惠。

<figure><img src="/files/jDcDcf1n2EGWmPObRtb1" alt=""><figcaption></figcaption></figure>

### 4.5. 销售渠道

默认情况下，赠品商品仅会在网店上发布。如果您还有其他销售渠道，例如 POS 或移动应用，您可以使用此功能自动发布这些商品。

{% hint style="warning" %}
如果您计划在多个不同渠道上执行优惠活动，请仔细审核您的营销活动，并联系我们的支持团队。
{% endhint %}

### 4.6. 包含其他原始商品详情

默认情况下，我们不会在赠品商品中复制原始商品的信息。但是，此设置允许您自动包含这些信息。

* 商品类型
* 标签

## 5. 赠品库存管理

{% hint style="warning" %}
仅适用于[赠品克隆机制](#id-2.-gift-logic-mechanism)。
{% endhint %}

<img src="/files/xSZTu7WhLUbnPAn2Y2JA" alt="" height="263" width="624">

### **5.1. 追踪和调整克隆赠品的库存**

默认情况下，克隆赠品的库存不会被追踪，因此只要优惠仍在进行中，赠品就可以持续添加到购物车中。

如果您想限制可赠送的赠品数量，可以**直接在克隆商品上追踪并输入库存**：

1. 进入 Shopify 后台 > 商品。
2. 打开克隆赠品的页面。
3. 启用库存追踪。
4. 输入库存数量。

{% hint style="success" %}
要快速找到由 BOGOS 创建的所有克隆赠品商品，请使用标签“**bogos-gift**”筛选您的商品列表。
{% endhint %}

<img src="/files/38SZxE9Qxw5JINqxSziF" alt="" height="264" width="624">

### 5.2 从原始商品扣减库存

<img src="/files/4FXhp0IgnjXj1Yo8bXFt" alt="" height="179" width="624">

此设置控制在克隆赠品被购买时，BOGOS 是否从原始商品扣减库存。

* **如果关闭：** BOGOS 仅从克隆商品中扣减库存。
* **如果开启：** BOGOS 会**同时从克隆商品和原始商品**中扣减库存，使原始商品的库存与赠品使用情况保持同步。此后，优惠将根据 Shopify 后台中原始商品的库存设置来停止或继续进行。

### **5.3 显示缺货赠品商品**

此设置控制缺货赠品在 BOGOS 赠品滑块中的显示方式。

请选择以下 2 个选项之一：

* **隐藏缺货商品**：缺货赠品将从赠品滑块中隐藏。
* **显示带有缺货状态的缺货商品**：缺货赠品仍会显示在赠品滑块中，并标记为缺货状态。

<img src="/files/MOMcaOL7iRkotlnYRkQD" alt="" width="563">

## 6. 高级/草稿订单 API

{% embed url="<https://youtu.be/82iWUvMSP0E?si=B5WHuTsLlhyneNj1>" %}

<figure><img src="/files/mxdRhLkST1pDTJN9N6qh" alt=""><figcaption></figcaption></figure>

草稿订单 API 用于让顾客以原价加折扣的方式结账，而不是使用赠品商品。有关草稿订单 API 的更多信息，请阅读[此处](https://help.shopify.com/en/manual/orders/create-orders)。

草稿订单 API 允许您控制折扣如何应用于草稿订单，并可选择启用或禁用折扣。

* 允许：此选项启用自动折扣或折扣码与 BOGOS 应用创建的草稿订单组合使用。
* 不允许：此选项在草稿订单中已包含赠品时阻止折扣叠加，保持之前的行为。

## 7. 欺诈防护

<figure><img src="/files/ZskBHGKUDFsA6Tdie8hV" alt=""><figcaption></figcaption></figure>

### 7.1. 通过邮件通知

您可以接收有关欺诈订单的邮件通知。该邮件将包含被判定为欺诈订单的摘要。

### 7.2. 通过订单激活欺诈防护

要激活此功能，您必须首先授予我们编辑订单的权限。点击继续后，您将被重定向到 Shopify 的授权页面。

<figure><img src="/files/BSlETi3Z34BeGe9KcU04" alt=""><figcaption></figcaption></figure>

有两个级别的防护，您可以启用适合您店铺情况的一种。

#### 基础防护

启用此级别的防护后，应用将自动取消**仅包含赠品**且**没有其他条件商品**的订单。

#### 高级防护

启用此级别的防护后，应用将根据优惠状态和优惠主要条件重新检查所有订单。

如果 BOGOS 检测到订单中包含来自\_已过期\_、\_已排期\_优惠的赠品，或者\_赠品数量\_看起来可疑，应用可以自动执行以下操作之一：

* 暂扣履约
* 取消订单

### 7.3. 通过购物车和结账激活欺诈防护

BOGOS 已将 Shopify 结账验证直接集成到应用设置中。启用此功能后，顾客的购物车必须满足以下条件才能在您的店铺中成功结账。

* 最低购物车金额：如果顾客的购物车金额低于此最低值，则无法携带赠品结账
* 最低购物车数量：如果顾客的购物车数量低于此最低值，则无法携带赠品结账
* 每笔订单的最大赠品数量：如果顾客的赠品总数超过此最大值，则无法携带赠品结账

{% hint style="warning" %}
由于此设置较为高级，我们建议您**直接与支持团队在线沟通**。我们的客服人员将为您提供合适的结账规则建议，以更好地保护您的店铺。
{% endhint %}

<figure><img src="/files/8dJ3B1jcU3kR43XZGsFX" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.bogos.io/cn/detailed-guide/settings.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
