> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/advocate-program/advocate-program-settings/test-your-advocate-program.md).

# 测试你的 Advocate 项目

您可以通过模拟 [程序规则](https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/advocate-program/getting-started-with-advocate/advocate-program-rules-explained.md) 并使用示例数据进行验证，确认规则的行为符合预期，然后再在生产环境中依赖该规则。

{% hint style="success" %}
**注意：** 您需要至少设置 1 条程序规则，才能测试程序。
{% endhint %}

{% stepper %}
{% step %}

## 访问“测试我的程序”

1. 在左侧导航菜单中，选择 ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[Engage]** <i class="fa-arrow-right">:arrow-right:</i> **程序规则** <i class="fa-arrow-right">:arrow-right:</i> **测试我的程序**.
   1. 选择 **下一步** 以在各个步骤之间切换。
      {% endstep %}

{% step %}

## 确认程序和版本

2. 程序会根据您当前的上下文自动填充。只有在需要测试其他程序时才切换。
3. 在 *版本* ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c2cb550b55c51ea1eeff0acbd6f437a03b621a2c%2F60d033ae8a04c14498d5229c3c0160ac05feea7f605dbd770741793c900469f0.svg?alt=media) **\[下拉菜单]**&#x4E2D;，选择要模拟 **草稿** 还是 **上线** 版本。
   1. 详细了解 Advocate 程序的草稿版本和上线版本。
      {% endstep %}

{% step %}

## 选择事件并填写输入信息

4. 选择要模拟的事件，然后按照事件在程序中发生时的情况填写信息：
   * **推荐开始**
   * **好友完成购买**
   * **好友退款**
   * **好友执行操作**

<details>

<summary>字段参考</summary>

| 字段              | 功能                | 适用于                 |
| --------------- | ----------------- | ------------------- |
| **购买事件**        | 要模拟的已跟踪购买事件。      | 好友购买、好友退款           |
| **购买日期**        | 模拟购买的日期。          | 好友购买、好友退款           |
| **事件类型**        | 要模拟的已跟踪事件。        | 好友执行操作              |
| **事件日期**        | 事件发生的日期。          | 好友执行操作              |
| **货币**          | 模拟购买金额所用的货币。      | 好友购买、好友执行操作         |
| **购买金额**        | 模拟购买的金额。          | 好友购买（必填）、好友执行操作（可选） |
| **推荐开始日期**      | 推荐开始的日期。          | 所有事件                |
| **推荐转化**        | 指定推荐是否已转化，以及转化时间。 | 除“推荐开始”外的所有事件       |
| **推荐人分群** （可选）  | 将测试限定为特定的推荐人细分群体。 | 所有事件                |
| **好友细分群体** （可选） | 将测试限定为特定的好友细分群体。  | 所有事件                |

</details>
{% endstep %}

{% step %}

## 运行测试

5. 选择 **运行测试**。系统会根据所选计划、版本和你提供的输入评估规则。
   {% endstep %}

{% step %}

## 查看预览输出

6. 查看 *预览* 面板：
   1. 其中会显示已触发规则的摘要、适用日期型操作时的日期范围，以及每个结果操作对应的勾选行。请确认结果是否符合预期。
      {% endstep %}
      {% endstepper %}

## 测试用例

这些测试用例使用示例规则，你可以设置这些规则，以便在发布计划前确认程序的行为符合预期。以下每个场景都会详细介绍一种特定情况。请根据你自己的计划配置调整触发条件、金额和细分群体等具体内容。

<details>

<summary>基本触发逻辑</summary>

**目标：**

* 确认基本的购买触发规则能够匹配并返回预期结果。
* 确认不会错误地触发回退行为。

**规则设置：**

* 触发条件：好友完成购买。
* 操作：向推荐人发送奖励和电子邮件，并向推荐人发放现金奖励。
* 无需设置默认操作。

**测试输入：**

* 事件：好友完成购买。
* 购买事件、购买日期、购买金额和货币均与规则匹配。
* 推荐关系于同一天开始。
* 不限定细分群体。

**预期结果：**

* 规则匹配，且预览会准确显示匹配的规则。
* 推荐人奖励行显示你配置的奖励金额。
* 显示推荐人电子邮件行。
* 不会出现其他不正确的回退操作。

</details>

<details>

<summary>时间窗口匹配与回退</summary>

**目标：**

* 确认日期处于基于时间的窗口内时，会应用基于时间的操作。
* 确认日期超出窗口范围时，会回退到默认操作。

**规则设置：**

* 触发条件：好友完成购买。
* 根据推荐关系开始日期，在指定日期窗口内适用的基于时间的操作。
* 该窗口之外的默认操作。

**运行 A（在窗口内）：**

* 将推荐关系开始日期设为窗口内的日期。

**预期结果 A：**

* 预览会准确显示匹配的基于时间的规则。
* 系统会应用该规则的奖励和电子邮件操作。

**运行 B（在窗口外）：**

* 将推荐关系开始日期设为窗口外的日期。

**预期结果 B：**

* 基于时间的操作不匹配。
* 系统会改为应用默认奖励和电子邮件操作。

</details>

<details>

<summary>分级奖励选择</summary>

**目标：**

* 确认系统会根据购买金额选择正确的奖励等级。

**规则设置：**

* 触发条件：好友完成购买。
* 操作：分级奖励并向推荐人发送电子邮件。
* 至少设置三个按购买金额范围划分的奖励等级（例如低档、中档和高档）。

**测试输入：**

* 每个等级各运行一次。
* 输入一个落在各等级金额范围内的购买金额。
* 每次运行时，其他所有输入都保持不变。

**预期结果：**

* 每次运行都应显示金额所属等级配置的奖励，而不是其他等级的奖励。

</details>

<details>

<summary>按细分群体限制资格</summary>

**目标：**

* 确认细分群体条件会控制规则是否适用。

**规则设置：**

* 触发条件：好友完成购买。
* 设置一项条件，要求推荐人属于特定细分群体。
* 最好为其他所有人配置一个默认操作。

**运行 A（匹配）：**

* 将推荐人设置为符合条件的细分群体。

**预期结果 A：**

* 符合条件的操作会生效。
* 默认操作会被跳过。

**运行 B（不匹配）：**

* 将推荐人设置为不符合条件的细分群体。

**预期结果 B：**

* 如果已配置默认操作，则该操作会生效。
* 否则，不会触发任何符合条件的操作。

</details>

<details>

<summary>佣金计算</summary>

**目标：**

* 确认佣金奖励根据购买金额计算，并以正确的货币显示。

**规则设置：**

* 触发条件：好友完成购买。
* 操作：向推荐人发送奖励和电子邮件。
* 按佣金计算的奖励——购买金额的一定百分比，使用交易所用的货币。

**运行 A 和 B：**

* 使用同一种货币，输入两个不同的购买金额。

**预期结果 A 和 B：**

* 每次都应显示按相应金额正确计算的佣金。

**运行 C（如果你的计划支持多种货币）：**

* 金额与运行 A 相同，但使用不同的货币。

**预期结果 C：**

* 佣金计算正确，并以新的货币显示。
* 这样可以将货币处理与金额计算区分开来。

</details>

<details>

<summary>未匹配且未配置默认操作</summary>

**目标：**

* 确认当没有任何条件匹配且没有备用操作时，预览会清楚显示不会执行任何操作。

**规则设置：**

* 设置一个未配置默认操作的基于时间的操作。

**测试输入：**

* 将推荐开始日期设置在时间范围之外。

**预期结果：**

* 没有匹配的时间范围。
* 没有可用的默认备用操作。
* 预览会清楚显示不会执行任何符合条件的操作。

</details>

<details>

<summary>因规则条件未满足而未匹配</summary>

**目标：**

* 确认规则自身的条件未满足时，预览会显示不会执行任何操作，而不仅仅是时间范围不匹配时。

**规则设置：**

* 设置一条规则，其中包含两个针对触发事件的条件：特定购买事件和最低购买金额。

**测试输入：**

* 输入不匹配的购买事件、低于最低金额的金额，或两者都输入。

**预期结果：**

* 没有任何规则条件匹配。
* 预览会清楚显示不会发生任何操作。

</details>


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/advocate-program/advocate-program-settings/test-your-advocate-program.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
