> 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/create-bulk-cash-rewards-with-advocate.md).

# 使用 Advocate 批量创建现金奖励

虽然许多奖励会根据程序规则自动触发（例如推荐转化），但有时您可能需要为参与者的手动或线下行为发放奖励，例如完成调查或赢得比赛。

“ **批量奖励** ”导入工具可让您通过上传 CSV 文件，一次性向多位推广者发放现金、积分或礼品卡。此功能包含安全预演机制，可在发放任何资金前确保数据正确无误。

### 准备导入文件

{% hint style="success" %}
**注意**：如果您使用全局导入设置，则只需提交 `userId` 列表。
{% endhint %}

首先，您需要准备一个 CSV 或 JSONL 文件，其中包含您想要奖励的用户列表。

* **必需列**：您的文件至少必须包含 `userId` 以识别用户。
* **可选列**：您可以在文件中包含奖励详情（例如金额、单位、类型）。或者，我们建议您在导入过程中将这些设为平台中的 *全局默认值* ，以简化文件内容。

#### 文件列参考

<table data-header-hidden><thead><tr><th width="297.484375">列</th><th>说明</th><th>要求</th></tr></thead><tbody><tr><td><code>userId</code></td><td>用户的唯一 ID。</td><td><mark style="color:$danger;">必填</mark></td></tr><tr><td><code>assignedCreditInCurrencyBaseUnit</code></td><td>要发放的金额（例如，50）。</td><td>有条件<br>（如果已设置全局默认值，则不需要）</td></tr><tr><td><code>rewardUnit</code></td><td>奖励的单位（例如，USD、POINTS）。</td><td>有条件<br>（如果已设置全局默认值，则不需要）</td></tr><tr><td><code>globalRewardKey</code></td><td>要发放的预配置奖励的键。</td><td><p>有条件<br>（如果已设置全局默认值，则不需要）</p><p><br></p></td></tr><tr><td><code>discountPercent</code></td><td>以折扣形式发放的奖励金额</td><td>有条件<br>（如果已设置全局默认值，则不需要）</td></tr><tr><td><code>dateScheduledFor</code></td><td>将奖励暂缓至此日期。</td><td>可选</td></tr><tr><td><code>uniqueId</code></td><td>交易的唯一标识符。</td><td><mark style="color:$success;">建议填写</mark><br>用作安全键，防止重复运行文件时发放重复奖励。</td></tr><tr><td><code>customerNote</code></td><td>添加一条客户可见的备注。</td><td>可选</td></tr><tr><td><code>internalNote</code></td><td>添加一条仅供内部使用、客户无法查看的备注。</td><td>可选</td></tr></tbody></table>

{% stepper %}
{% step %}

#### 配置导入设置

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%2FNCv4EHK61ypIahnjieFB%2FScreenshot%202026-05-19%20at%2010.12.35.png?alt=media&amp;token=1b2a3fe3-f3ba-4bff-9612-a47317c223f7" alt=""><figcaption></figcaption></figure></div>

**设置预设值（全局默认值）**

为了节省时间并减少 CSV 文件中的错误，您可以定义预设值，让它们应用于导入的每一行。

* **奖励**：选择预先配置的奖励，或指定自定义单位（例如，“Cash/USD”）。
* **计划**：将这些奖励关联到特定计划，以便用于报告。
* **奖励待处理时长**: ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FiZjM1xY8o3v1iR3Zaysd%2FToggle.svg?alt=media\&token=b1550d48-bba9-4e81-8604-bc12370c5caa) **\[切换开]** 以添加一段安全缓冲期（例如 30 天），之后奖励才对用户可用。这样可以在必要时留出撤回奖励的时间。

{% hint style="success" %}
**注意**：如果您在此处设置了值（例如，奖励单位：USD），则 **无需** 在 CSV 文件中包含该列。
{% endhint %}
{% endstep %}

{% step %}

#### 上传并试运行

由于现金奖励一经发放便无法撤销，系统要求先进行试运行（测试导入），以便您在处理奖励前放心地检查详情。

1. 在 *上传导入用户的 CSV 或 JSONL 文件* 下，选择 **选择文件**.
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%2FXzOTAlFdV9PBePeTWjd2%2FScreenshot%202026-05-19%20at%2010.15.36.png?alt=media&amp;token=859ccc75-e655-4002-b915-b8225028ddff" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

#### 检查并完成

测试运行完成后，您会在“导入与导出”列表中看到一条状态记录。检查过程中可能会发送电子邮件（礼品卡、付款配置等）。

1. **检查**：如果有错误（以 ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2F42gbg9NHA1obODpwpxh1%2Ficons8-high-importance-16.png?alt=media\&token=80a809ae-ca8e-43d4-af95-a416a44c8ec3) **\[感叹号]**&#x6807;示），请选择 **下载错误报告** 以修正文件并重试。此外，选择 **下载报告** 以获取将要创建的所有奖励的记录。无论是否有错误，都建议下载报告进行检查。
2. **确认**：如果测试成功（以 ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FvdMZSNCvTeUSIm6qrJ5o%2Ficons8-check-16.png?alt=media\&token=998fe3ad-c8a2-4dbc-bdc0-8f79e246b314) **\[对勾]**&#x6807;示），请选择 **运行导入**.
3. 系统会显示一个确认对话框，总结导入的影响（例如：“运行此导入后将创建 412 项奖励”）。请选择 **运行导入** 以确认并发放奖励。

如果您决定不继续，可以直接取消此次运行，然后选择“丢弃”以删除测试运行。

<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%2FNa7x8cn8GL73umRhPqxk%2Fimage3.jpg?alt=media&amp;token=232b052b-b167-4613-81d1-581178951f27" alt=""><figcaption></figcaption></figure></div>
{% 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 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-rewards/create-bulk-cash-rewards-with-advocate.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.
