> 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-rewards/referral-promo-codes-for-participants.md).

# 参与者推荐促销码

{% hint style="danger" %}
**重要**：一旦该功能在你的项目中开启，就无法关闭。
{% endhint %}

推荐促销代码是一种很好的方式，可将归因和奖励压缩为 1 个步骤，位于 **开始** 推荐流程的开端。优惠券由客户倡导者提供给被推荐的朋友，并提供折扣。一旦被推荐的朋友在结账时使用其促销代码，该代码就会归因到客户倡导者，后者随后获得奖励。

你可以通过在项目规则中上传促销代码，为你的倡导者创建推荐促销代码。一旦你有了你的 [计划规则](/brand/zh/what-would-you-like-to-learn-about/advocate-program/getting-started-with-advocate/configure-your-advocate-program.md) 设置好后，导航到 *促销代码* 部分以上传一批推荐促销代码。

{% hint style="success" %}
**注意**：此功能独立于 [燃油箱奖励](/brand/zh/what-would-you-like-to-learn-about/advocate-program/advocate-rewards/fuel-tank-rewards-explained.md)。燃油箱奖励也使用代码，但这些代码只用于奖励参与者——不会在倡导者和被推荐朋友之间建立归因关系。
{% endhint %}

#### 设置推荐促销代码

1. 在左侧导航菜单中，选择 ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[Engage] → 项目规则**.
2. 滚动到 *促销代码* 部分，然后选择 **设置促销代码**。对于推荐促销代码，这可以设置为以下任一项： **多次使用** 或 **一次性使用**.
   * 建议使用一次性使用代码而不是多次使用代码，因为这有助于最大限度地减少欺诈。

     <div data-with-frame="true"><figure><img src="https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FGe75pFju4pGaCP0wkeOP%2FScreenshot%202026-05-19%20at%2011.12.14.png?alt=media&amp;token=f17160ae-8f36-484e-accc-7a03b84fe2a1" alt="" width="563"><figcaption></figcaption></figure></div>
3. 选择你希望每位倡导者可用的代码数量。仅当你已选择创建 **一次性使用** 促销代码。
   * 一位倡导者可以被分配多个代码。当某个代码被使用后，会自动给该倡导者分配另一个促销代码。

     <div data-with-frame="true"><figure><img src="https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FTg8TB9rIZdUufsT56vGR%2FScreenshot%202026-05-19%20at%2011.13.16.png?alt=media&amp;token=0697bf68-55a7-4cd5-a1aa-cd0b1a8fe48d" alt="" width="375"><figcaption></figcaption></figure></div>
4. 你可以设置在促销代码即将不足时何时通知你。
   * 当代码数量达到你在通知部分设置的数量时，系统会向你发送一封电子邮件，提醒你代码即将不足。务必确保你的项目不会耗尽为零，因此一旦代码不足，请务必创建更多代码，以保持项目顺利运行。
5. 选择 **上传代码** 以上传一批推荐促销代码。
   * 系统将把你重定向到一个页面，你可以在该页面中使用任何受支持的文件格式上传你的代码批次。

     <div data-with-frame="true"><figure><img src="https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FC01ajR9Orj70bvZ0Zs0M%2FScreenshot%202026-05-19%20at%2011.14.59.png?alt=media&amp;token=44888203-2077-480d-b81a-ca37492a36dc" alt="" width="375"><figcaption></figcaption></figure></div>
6. 选择 **保存** 在你配置好促销代码后。系统会弹出一个窗口，询问你是否确定要保存。一旦启用一次性代码，此操作将无法撤销。

   <div data-with-frame="true"><figure><img src="https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FCxnU8l4xOjtmKBqip9jl%2FScreenshot%202026-05-19%20at%2012.16.57.png?alt=media&amp;token=3158ea8d-6b22-4de8-80b5-2e4cc9e4e154" alt="" width="344"><figcaption></figcaption></figure></div>
7. 选择 ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FwXho9QKP3e4iU4ZKUSJ5%2F167ebb8cc30303.svg?alt=media\&token=a046e9f0-63aa-46f6-8a35-f73973fd326c) **\[复选框]** 以自动将新的促销代码模板应用到你的小部件中。
   * 或者，如果你已有现成的小部件或微站点，你可以手动添加推荐促销代码组件。你可以通过导航到 **内容** 左侧导航栏中的，然后选择编辑你的小部件或微站点。选择 **添加** 右侧以添加一个组件到你现有的小部件或微站点。了解更多关于 [小部件和微站点组件](/brand/zh/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/widget-and-microsite-components-explained.md).

上传推荐促销代码后，这些代码将自动生成，并通过你已设置的 [小部件](/brand/zh/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/introduction-to-participant-experiences.md#widgets-0-0) 或微站点提供。

在下图中，倡导者会收到 5 个不同的代码，他们可以在这些代码之间轮换，并复制后分享给被推荐者。如果某个代码之前已被复制，你会在代码字段下方收到通知。这有助于避免你可能将同一个代码发送给多个人的情况。

<div data-with-frame="true"><figure><img src="https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-21993c32d4b6f889783325b921cbf28a6bba4c45%2Fd87e360ea05fc772c976e14f0d24ad85084e28eefdd0c1d5c9410098aa3f1a65.jpg?alt=media" alt="" width="375"><figcaption></figcaption></figure></div>

{% hint style="success" %}
**注意**：如果你的倡导者的代码用完了并向你索取更多，你可以在特殊情况下手动为他们创建一个。如果要这样做，请导航到 **参与者**。选择你想为其生成新代码的参与者，然后选择 **代码和链接** 选项卡，然后选择 **添加推荐代码** 为他们生成新代码。该代码将添加到其小部件中的现有批次。
{% endhint %}

#### 事件时间归因

推荐会通过用户 upsert 进行归因，这些操作可能通过 API 调用、用户导入，甚至小部件加载来发生。推荐促销代码也可以随购买事件一并返回。你可以在 `OrderPromoCode` 通过转化 API 传递给我们。了解更多关于如何创建 [转化事件](https://integrations.impact.com/brand-api-reference/reference/conversions/conversions).

#### 查看你的促销代码

你可以在 *查看代码* 页面上看到多个详细信息。通过检查代码类型，你可以区分一次性代码和多次使用代码。你还可以看到哪些代码已经使用，以及查看哪些倡导者被归因到哪些推荐对象。

{% hint style="success" %}
**注意**：一次性使用代码是尽量减少促销代码被欺诈性使用概率的绝佳方式。多次使用代码常常会在第三方网站上共享，而一次性使用代码只能使用一次，并可降低其被传播到不可靠来源的可能性。
{% endhint %}

1. 在左侧导航菜单中，选择 ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[Engage] →** **奖励 → 代码管理器**.
2. 选择你想查看其代码的参与者。
3. 在 *查看代码* 在该页面上，你会找到所有相关信息，包括已发放了什么类型的代码、哪些已被使用，以及更多内容。

   <div data-with-frame="true"><figure><img src="https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2F5G6QGfUR6MiONqv2ki1N%2FScreenshot%202026-05-19%20at%2012.12.21.png?alt=media&amp;token=e2c4241a-5bb5-430e-8c42-cde9a31f2938" alt=""><figcaption></figcaption></figure></div>


---

# 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://help.impact.com/brand/zh/what-would-you-like-to-learn-about/advocate-program/advocate-rewards/referral-promo-codes-for-participants.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.
