> 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/redeem-rewards-in-bulk.md).

# 批量兑换奖励

奖励通常通过您与 Advocate 的某个集成来兑换。如果您需要在外部系统中手动发放奖励，那么可以使用此批量奖励兑换流程来更新参与者可用的奖励余额。

{% hint style="success" %}
**注意：** 此流程不会向参与者发放具体奖励——例如积分、礼品卡或优惠券代码。相反，它会更新您的记录，以便在您通过其他系统兑换奖励后，准确显示参与者的奖励余额。
{% endhint %}

{% stepper %}
{% step %}
**步骤 1：下载按用户显示的可用奖励余额报告**

此报告列出所有项目中拥有可用奖励余额的参与者。您可以使用此报告在外部系统中手动发放奖励。

1. 在左侧导航菜单中，选择 ![](https://res.cloudinary.com/product-enablement/image/upload/v1768905009/Accessibility%20Icons/engage-v2.svg) **\[Engage] → 报告 → 导入与导出**.
2. 选择 **创建报告**.
3. 在 *选择报告类型*下，选择 **按用户显示的可用奖励余额**.
4. 可选地，选择特定的奖励单位以缩小参与者列表范围。如果您想将生成的报告限制为通过外部服务发放的某一特定奖励单位，这会很有用。
5. 选择报告格式（.CSV 或 Excel）。
6. 选择 **创建报告**.

生成的报告链接将发送到与此账户关联的电子邮件地址。
{% endstep %}

{% step %}
**步骤 2：更新报告**

在外部系统中手动发放奖励后，您需要更新 *按用户显示的可用奖励余额* 报告。这样 Advocate 就能知道哪些参与者的奖励已被发放。

1. 使用电子表格应用程序打开 *按用户显示的可用奖励余额* 报告。
2. 对于每一位您已手动发放奖励的参与者，请更新 `valueToRedeem` 列。仅接受正数。
3. 将报告保存为 .CSV 格式。

**兑换说明**

* 奖励余额需要以余额显示时相同的单位（*例如*. `分` 或 `美元/USD`）进行兑换（*即* 不能将美元按分的金额进行兑换）。
* 导入时只会处理对 `valueToRedeem` 字段的更改。
* 奖励余额中的单个奖励将按其到期时间顺序兑换（`dateExpires`），然后按它们对参与者变为可用的时间顺序兑换（`dateGiven`).
* 只有状态为 `AVAILABLE` 的奖励才会被兑换。
* 兑换时，小数单位的小数部分将被截断（*例如* ，“10.556 USD”的兑换将只会兑换“10.55 USD”）。
  {% endstep %}

{% step %}
**步骤 3：上传更新后的报告**

最后，您需要将 *按用户显示的可用奖励余额* 包含当前奖励余额的报告重新上传到 Advocate。

1. 在左侧导航菜单中，选择 ![](/files/209022bdb234289211a24a980f6227a8684cc439) **\[Engage] → 报告 → 导入与导出**.
2. 选择 ![](/files/384fa5309ff1dcdcb5317f339bd76ce23aa62c8a) **导入**.
3. 在 *导入类型*下，选择 **更新用户奖励余额**.
4. 要添加您更新后的报告，请选择 **选择文件**.
5. 选择 **导入**.

导入完成后，会发送一封确认电子邮件。根据队列情况和文件大小，导入最多可能需要 30 分钟。
{% endstep %}
{% endstepper %}


---

# 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/redeem-rewards-in-bulk.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.